FitnessForce - UFP
Home
Home
  1. Payments
  • Introduction
  • Quickstart
  • Webhooks
  • Campaign
    • Get campaign
      GET
    • List campaign
      GET
    • Get campaign by GUID
      GET
    • Get automation by franchise
      GET
    • Get automation by tenant
      GET
    • Get automation by company
      GET
    • Update automation active
      POST
    • Update automation inactive
      POST
    • Update campaign active
      POST
    • Update campaign inactive
      POST
  • Class
    • Get class by id
      GET
    • Delete class
      DELETE
    • Update class
      PUT
    • List classes
      GET
    • Create class
      POST
    • Substitute coach in class
      POST
    • Reschedule class
      POST
    • Cancel class
      POST
    • Mark class as completed
      POST
    • List class bookings by client id
      GET
  • Client
    • Retrieves all client for a Tenant
    • Creates a new client
    • Gets client by ID
    • Gets clients birthday list
    • Gets clients at risk
    • Gets client mandatory fields
    • Adds client to blacklist
    • Removes client from blacklist
    • Updates client details
    • Used for partial updates of client details
    • Changes client representative
    • Lists prospects
    • Lists ex-clients
    • Resets client password
    • Changes client representative for multiple clients
    • Lists prospect effective date history
    • Transfers prospect
  • Company
    • Get company details
  • Invoice
    • Get invoice PDF
  • Organisation
    • List organisations
    • Get organisation
  • Search
    • Perform Client Search
    • Search clients by tenant
    • Search clients by provider
    • Search clients by company
  • Tax
    • Get Tax Groups
    • Get Tax Group by ID
    • Get Tax Groups by Tenant IDs
    • Get Tax Line Items
    • Get Tax Line Item by ID
    • List Tax Line Items
    • List Tax Line Types
  • Tenant
    • Get tenant details
    • List tenants
    • Gets list of tenants
    • Updates tenant details
    • Gets tenant details
    • Updates tenant invoice template type
    • Updates tenant payment template type
  • Appointments
    • Create new appointment
    • List appointments
    • Change client membership in appointment
    • Get appointment
    • Update appointment
    • Mark client as checked in
    • Mark client as no-show
    • Substitute coach for appointment
    • Reschedule appointment
    • Cancel appointment
    • List appointments by client ID
    • Create appointment complimentory session
    • Create appointment
    • Reschedule appointment
    • Get appointment
  • Appointment Types
    • Get appointment types list
    • Get appointment type details
  • Authentication
    • Refresh Token exchange
    • Generate authentication token
  • Automation
    • Get automation master
    • List automation types
  • Call Transactions
    • Get call transaction details
    • Log new call transaction
    • Update call transaction
    • Delete call transaction
  • Charge Categories
    • List charge categories
    • Get charge category
  • Charge Master
    • List charge masters
    • Get charge master
    • Calculate charge breakup
  • Recurring Class
    • Create recurring class
    • List recurring class template
    • Update recurring class
    • Get recurring class template
    • Cancel recurring class
    • Reschedule recurring class
    • Substitute coach in recurring class
    • List classes by recurring class template ID
  • Class Booking
    • Books client to class
    • Changes client membership
    • Removes client from class
    • Marks client as no-show
    • Marks client as checked in
    • Adds a trial client to class
  • Class Complimentory
    • Creates complimentary class
  • Class Types
    • List class types
    • Get class type details
  • Company level class types
    • List class types
  • Client Communication
    • Gets email log
    • Gets client interactions
    • Lists unified communication messages
  • Client Tasks
    • Gets client tasks
  • Client Sales
    • Gets client sales returns
    • Gets client payments
    • Lists client refunds
  • Client Waivers
    • Gets client waivers
  • Client Sessions
    • Gets client session inventory
  • Client Referrals
    • Lists client referrals
  • Client Offers
    • Lists eligible client coupons
  • Client Export
    • Exports prospects list
    • Exports ex-clients list
    • Exports active clients list
    • Exports clients at risk list
  • Client Billing
    • Creates charges for a client
    • Creates balance payment for invoice
  • Client Check-in
    • Creates client check-in
    • Lists client check-ins
    • Lists client check-ins by tenant
    • Lists clients who are currently in the club
    • Deletes a client check-in
  • Client Credit Balance
    • Creates a new credit balance order for a client
    • Retrieves the credit balance for a client
    • Retrieves the credit balance for a client
    • Lists client credit balance centerwise
  • Client Documents
    • Uploads client document
    • Gets client document
    • Lists client documents
    • Deletes client document
  • Client Invoices
    • Get invoice by UUID
    • Generate balance UUID for invoice
  • Client Membership
    • Change client membership start date
    • Patch client membership
    • Change client membership end date
    • Get client membership details
  • Client Open API
    • Create prospect
    • Book tour
  • Client Payments
    • Get payment timeline
    • List client payment methods
  • Client Subscriptions
    • List client subscription invoices
    • Get client subscription
    • List client subscriptions
    • Get clients by plan ID
    • Change subscription start date
    • Change subscription end date
    • Void client subscription
    • Send manage subscription link
    • Get client subscription by UUID
    • Get client subscription invoices by UUID
  • Client Memberships
    • Change session owner
    • Get session owners
    • List active client memberships
  • Client Subscription Cancellation
    • Cancel client subscription
    • Reactivate client subscription
  • Client Subscription Freeze
    • Create subscription freeze
    • List subscription freezes
    • Stop subscription freeze
    • Cancel subscription freeze
    • List client freezes
    • Get subscriptions available for freeze
    • Update subscription freeze
    • Get subscription freeze timeline
  • Client Trials
    • List client trials
    • Create client trial
    • Get client trial
    • Update trial
    • Delete client trial
    • Activate client trial
    • Mark trial as inactive
    • Mark trial as active
    • List client trials by tenant
    • Export client trials by tenant
  • Client Upgrade
    • Calculates subscription upgrade
    • Voids subscription upgrade
  • Balance Write Off
    • Creates a write off
    • Gets the list of write offs
    • Voids a write off
  • Email Template
    • Create email template
    • List email templates
    • Update email template
    • Get email template
    • Delete email template
    • Mark email template as inactive
    • Mark email template as active
  • Email Template - Franchise
    • Create email template at franchise level
    • Get list of email templates at franchise level
    • Update email template at franchise level
    • Get email template at franchise level
    • Delete email template at franchise level
    • Mark email template as inactive at franchise level
    • Mark email template as active at franchise level
  • Email Template - Tenant
    • Create email template at tenant level
    • List email templates at tenant level
    • Update email template at tenant level
    • Get email template at tenant level
    • Delete email template at tenant level
    • Mark email template as inactive at tenant level
    • Mark email template as active at tenant level
  • Franchise Groups
    • Get franchise group details
    • List all franchise groups
  • Payment Methods
    • Initiate payment method update by UUID
    • Initiate payment method update by ID
  • Invoices
    • Get invoice
    • List client invoices
    • Void invoice
    • Get invoice PDF
    • Send invoice PDF
    • List invoice details
    • Change invoice sales rep
    • Send invoice clear balance link
  • Offer Master
    • List offer master
    • Get offer master
    • List eligible coupon master
    • List offer master coupon code link
    • List offer master service plan product link
    • List offer master organisation link
  • Online Signup
    • Get subscription plans
    • Get mandatory client fields
    • Get subscription plan details
    • Create client and invoice
  • Subscription
    • Get eligible add-ons
  • Sales
    • Get sales return PDF
  • Staff Availability
    • List staff availability
    • List staff availability by appointment category
    • List next available slots by appointment category
    • Check staff availability
    • Check staff availability for appointment category
    • Check staff availability for recurring schedule
    • Check staff availability for recurring schedule
    • Get staff scheduled unavailability
    • List staff availability for tours
  • Opportunities
    • List opportunities
    • Create opportunity
    • Get opportunity
    • Update opportunity
    • Delete opportunity
    • Change opportunity stage
    • Mark opportunity as won
    • Mark opportunity as lost
    • Mark opportunity as nurture
    • Update opportunity sort order
  • Opportunity Stage Master
    • List opportunity stage masters
    • Get opportunity stage master
  • Payments
    • Get payment details
      GET
    • Mark payment as void
      POST
    • Get payment PDF
      GET
    • Send payment PDF
      POST
  • Refunds
    • List refunds
    • Send refund PDF
    • Get refund PDF
  • Reports
    • Reporting Quickstart
    • GET Report Data
  • Report Filter Schedules
    • Create report filter schedule
    • Delete report filter schedule
  • Access Requests
    • Request access via email
  • Rooms
    • List rooms
    • Get room details
  • Sales Returns
    • Get sales return PDF
  • Email Communication
    • Send free form email
  • SMS
    • Send free form SMS
  • Service Categories
    • List service categories
    • Get service category
    • Get service category collections
  • Staff Management
    • Get staff by ID
    • List all staff
    • List staff schedules
    • List staff appointment types
  • Staff Appointment Type Link
    • Gets staff appointment type links
  • Staff Notifications
    • Mark staff notifications as read
    • Mark staff notification as deleted
    • List staff notifications
  • Staff Schedule
    • Lists staff schedules
    • Gets staff schedule
  • Subscription Plans
    • List subscription plans
    • Get subscription plan by ID
    • Get eligible addons
  • Subscription Signup
    • Get Order Summary
    • Validate Referral
    • Get Order Summary Billing Occurrence
    • Get Order Status
    • Get Waivers
    • Get Payment Methods
    • List Empty Client Mandatory Fields
    • Sign Guest Waiver
    • Send Payment Link
    • Send Signup Completion Link
  • Tasks
    • Create task for client
    • Create task for opportunity
    • List tasks
    • Get task details
    • Complete SMS task
    • Bulk reassign tasks
  • Task Categories
    • List task categories
    • Get task category
  • Task Open API
    • Reschedule tour
    • Get tour details
  • Trial Master
    • List trials
    • Get trial
  1. Payments

Get payment details

GET
/clients/{client_id}/payments/{pymt_id}
Payments
Retrieves details of a specific payment

Request

Path Params
client_id
integer <int64>
required
The ID of the client
pymt_id
integer <int64>
required
The ID of the payment

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/clients//payments/'

Responses

🟢200OK
text/plain
Payment details retrieved successfully
Body
id
integer <int64>
optional
log_id
integer <int64>
optional
company_id
integer <int32>
optional
collected_for_tenant_id
integer <int32>
optional
collected_at_tenant_id
integer <int32>
optional
paid_by_client_id
integer <int64>
optional
paid_for_client_id
integer <int64>
optional
amount_in_minor_currency
integer <int64>
optional
is_online
boolean 
optional
paymode_level1
enum<string> 
optional
Available values:
Cash -
Card -
NetBanking -
UPI -
Wallet -
ACH -
Cheque -
Other -
Emandate -
Adjustment -
PayTo -
Allowed values:
CashCardNetBankingUPIWalletACHChequeOtherEmandateAdjustmentPayTo
payment_mode_level2_id
enum<string> 
optional
Available values:
Cash -
Debit -
Credit -
Emandate -
UPI -
Paytm -
AmazonPay -
Venmo -
ACH -
Cheque -
Sodexo -
NetBanking -
ApplePay -
CareemPay -
Knet -
OmanPay -
Fawry -
Benefit -
Mada -
Tabby -
Transfer -
PayTo -
Card -
GCash -
GooglePay -
Link -
Allowed values:
CashDebitCreditEmandateUPIPaytmAmazonPayVenmoACHChequeSodexoNetBankingApplePayCareemPayKnetOmanPayFawryBenefitMadaTabbyTransferPayToCardGCashGooglePayLink
payment_mode_master_id
integer <int32>
optional
payment_mode_master_name_primary_language
string  | null 
optional
payment_mode_master_name_secondary_language
string  | null 
optional
number
integer <int32>
optional
number_prefix
string  | null 
optional
status
enum<string> 
optional
Available values:
Open -
PartiallyOpen -
Closed -
Void -
Refunded -
Allowed values:
OpenPartiallyOpenClosedVoidRefunded
void_reason
string  | null 
optional
bulk_uuid
string  | null 
optional
is_number_generated
boolean 
optional
created_by
integer <int32>
optional
created_date
string <date-time>
optional
updated_by
integer <int32>
optional
updated_date
string <date-time>
optional
payment_date
string <date-time>
optional
sales_representative
integer <int32>
optional
is_ewallet_deposit
boolean 
optional
invoices
array[object (InvoiceResponse) {31}]  | null 
optional
id
integer <int64>
optional
company_id
integer <int32> | null 
optional
tenant_id
integer <int32> | null 
optional
company_uuid
string  | null 
optional
tenant_uuid
string  | null 
optional
client_id
integer <int64>
optional
is_recurring
boolean 
optional
client_subscription_id
integer <int32>
optional
number
integer <int64>
optional
number_prefix
string  | null 
optional
billing_name
string  | null 
optional
sales_representative
integer <int32>
optional
total_base_amount_in_minor_currency
integer <int64>
optional
total_tax_amount_in_minor_currency
integer <int64>
optional
total_amount_in_minor_currency
integer <int64>
optional
total_payment_in_minor_currency
integer <int64>
optional
total_balance_due_in_minor_currency
integer <int64>
optional
total_sales_return_in_minor_currency
integer <int64>
optional
total_write_off_amount_in_minor_currency
integer <int64>
optional
issue_date
string <date-time>
optional
track_mode
enum<string> 
optional
Available values:
StaffWebApp -
StaffMobileApp -
ClientMobileApp -
ClientPurchasePortal -
ClientWebsiteWidget -
FFMavrick -
ClientWebSignup -
FFHangfireJob -
Widget -
Allowed values:
StaffWebAppStaffMobileAppClientMobileAppClientPurchasePortalClientWebsiteWidgetFFMavrickClientWebSignupFFHangfireJobWidget
migration_id
string  | null 
optional
due_date
string <date-time>
optional
created_by
integer <int32>
optional
created_date
string <date-time>
optional
updated_by
integer <int32>
optional
updated_date
string <date-time>
optional
status
enum<string> 
optional
Available values:
Void -
Open -
PartialOpen -
Closed -
NotPaid -
Allowed values:
VoidOpenPartialOpenClosedNotPaid
invoice_line_item
array[object (InvoiceLineItemResponse) {19}]  | null 
optional
invoice_uuid
string  | null 
optional
invoice_presale
string  | null 
optional
payment_gateway_used
enum<string> 
optional
Available values:
Offline -
RazorpayIndia -
PayenginUSA -
TwoC2pVietnam -
TwoC2pSingapore -
TwoC2pMalaysia -
EzypayAustralia -
EzypaySingapore -
EzypayMalaysia -
EzypayPhilippines -
PayenginePhilippines -
PayenginCanada -
StripeCanada -
StripeUSA -
TapSaudi -
TapUAE -
TapKuwait -
TapOman -
TapBahrain -
TapEgypt -
EzypayNewZeland -
EzypaySouthKoria -
StripeUAE -
Allowed values:
OfflineRazorpayIndiaPayenginUSATwoC2pVietnamTwoC2pSingaporeTwoC2pMalaysiaEzypayAustraliaEzypaySingaporeEzypayMalaysiaEzypayPhilippinesPayenginePhilippinesPayenginCanadaStripeCanadaStripeUSATapSaudiTapUAETapKuwaitTapOmanTapBahrainTapEgyptEzypayNewZelandEzypaySouthKoriaStripeUAE
settlement_id
string  | null 
optional
dispute_status
enum<string> 
optional
Available values:
None -
Open -
Lost -
Won -
Allowed values:
NoneOpenLostWon
payment_method
object (GetClientPaymentTokenResponse) 
optional
id
integer <int64>
optional
level1
enum<string> 
optional
Available values:
Cash -
Card -
NetBanking -
UPI -
Wallet -
ACH -
Cheque -
Other -
Emandate -
Adjustment -
PayTo -
Allowed values:
CashCardNetBankingUPIWalletACHChequeOtherEmandateAdjustmentPayTo
level2
enum<string> 
optional
Available values:
Cash -
Debit -
Credit -
Emandate -
UPI -
Paytm -
AmazonPay -
Venmo -
ACH -
Cheque -
Sodexo -
NetBanking -
ApplePay -
CareemPay -
Knet -
OmanPay -
Fawry -
Benefit -
Mada -
Tabby -
Transfer -
PayTo -
Card -
GCash -
GooglePay -
Link -
Allowed values:
CashDebitCreditEmandateUPIPaytmAmazonPayVenmoACHChequeSodexoNetBankingApplePayCareemPayKnetOmanPayFawryBenefitMadaTabbyTransferPayToCardGCashGooglePayLink
network_type
string  | null 
optional
masked_card_number
string  | null 
optional
masked_account_number
string  | null 
optional
upi_provider
string  | null 
optional
vpa_id
string  | null 
optional
expiry_date
string <date-time> | null 
optional
token_status
enum<string> 
optional
Available values:
iniitiated -
confirmed -
rejected -
cancelled -
paused -
Allowed values:
iniitiatedconfirmedrejectedcancelledpaused
bank_name
string  | null 
optional
pay_to_details
string  | null 
optional
token_account_holder_name
string  | null 
optional
token_alias_type
string  | null 
optional
token_alias_type_id
string  | null 
optional
token_account_type
string  | null 
optional
is_apple_pay_or_google_pay
boolean 
optional
Example
{
    "id": 0,
    "log_id": 0,
    "company_id": 0,
    "collected_for_tenant_id": 0,
    "collected_at_tenant_id": 0,
    "paid_by_client_id": 0,
    "paid_for_client_id": 0,
    "amount_in_minor_currency": 0,
    "is_online": true,
    "paymode_level1": "Cash",
    "payment_mode_level2_id": "Cash",
    "payment_mode_master_id": 0,
    "payment_mode_master_name_primary_language": "string",
    "payment_mode_master_name_secondary_language": "string",
    "number": 0,
    "number_prefix": "string",
    "status": "Open",
    "void_reason": "string",
    "bulk_uuid": "string",
    "is_number_generated": true,
    "created_by": 0,
    "created_date": "2019-08-24T14:15:22Z",
    "updated_by": 0,
    "updated_date": "2019-08-24T14:15:22Z",
    "payment_date": "2019-08-24T14:15:22Z",
    "sales_representative": 0,
    "is_ewallet_deposit": true,
    "invoices": [
        {
            "id": 0,
            "company_id": 0,
            "tenant_id": 0,
            "company_uuid": "string",
            "tenant_uuid": "string",
            "client_id": 0,
            "is_recurring": true,
            "client_subscription_id": 0,
            "number": 0,
            "number_prefix": "string",
            "billing_name": "string",
            "sales_representative": 0,
            "total_base_amount_in_minor_currency": 0,
            "total_tax_amount_in_minor_currency": 0,
            "total_amount_in_minor_currency": 0,
            "total_payment_in_minor_currency": 0,
            "total_balance_due_in_minor_currency": 0,
            "total_sales_return_in_minor_currency": 0,
            "total_write_off_amount_in_minor_currency": 0,
            "issue_date": "2019-08-24T14:15:22Z",
            "track_mode": "StaffWebApp",
            "migration_id": "string",
            "due_date": "2019-08-24T14:15:22Z",
            "created_by": 0,
            "created_date": "2019-08-24T14:15:22Z",
            "updated_by": 0,
            "updated_date": "2019-08-24T14:15:22Z",
            "status": "Void",
            "invoice_line_item": [
                {
                    "id": 0,
                    "invoice_id": 0,
                    "description": "string",
                    "type": "Service",
                    "base_unit_cost_in_minor_currency": 0,
                    "net_unit_cost_in_minor_currency": 0,
                    "quantity": 0,
                    "total_base_cost_in_minor_currency": 0,
                    "net_cost_in_minor_currency": 0,
                    "discount_staff_in_minor_currency": 0,
                    "discount_coupon_in_minor_currency": 0,
                    "total_tax_in_minor_currency": 0,
                    "total_amount_in_minor_currency": 0,
                    "service_id": 0,
                    "service_category_id": 0,
                    "charge_category_id": 0,
                    "total_sales_return_amount": 0,
                    "total_sales_return_quantity": 0,
                    "invoice_tax_line_item": [
                        {
                            "id": 0,
                            "invoice_id": 0,
                            "invoice_line_id": 0,
                            "tax_regime_name": "GSTIndia",
                            "tax_line_id": 0,
                            "tax_name_primary_language": "string",
                            "tax_name_secondary_language": "string",
                            "rate": 0,
                            "total_tax_amount_in_minor_currency": 0
                        }
                    ]
                }
            ],
            "invoice_uuid": "string",
            "invoice_presale": "string"
        }
    ],
    "payment_gateway_used": "Offline",
    "settlement_id": "string",
    "dispute_status": "None",
    "payment_method": {
        "id": 0,
        "level1": "Cash",
        "level2": "Cash",
        "network_type": "string",
        "masked_card_number": "string",
        "masked_account_number": "string",
        "upi_provider": "string",
        "vpa_id": "string",
        "expiry_date": "2019-08-24T14:15:22Z",
        "token_status": "iniitiated",
        "bank_name": "string",
        "pay_to_details": "string",
        "token_account_holder_name": "string",
        "token_alias_type": "string",
        "token_alias_type_id": "string",
        "token_account_type": "string",
        "is_apple_pay_or_google_pay": true
    }
}
🟠400Bad Request
🟠404Record Not Found
Modified at 2025-03-21 07:23:14
Previous
Get opportunity stage master
Next
Mark payment as void
Built with