API Basics
Pay In Endpoints
- MoneyIn
- Subscription
- TokenStorage
- Invoice
- LineItem
- PaymentLink
- PaymentMethodDomain
- HostedPaymentPages
- Cloud
- Wallet: Apple Pay
Pay Out Endpoints
- MoneyOut
- Bill
Pay Ops Endpoints
- Templates
- Boarding
- Chargebacks and ACH Returns
- Entities
- Notification
- Query
- Statistic
- Export
- Import
Object Models
- Object Model References
Get Subscription, Scheduled Payment, or Autopay
Retrieves a single subscription’s details.
curl --request GET \
--url https://api-sandbox.payabli.com/api/Subscription/{subId} \
--header 'requestToken: <api-key>'
{
"IdSub": 396,
"Method": "card",
"PaypointId": 255,
"TotalAmount": 103,
"NetAmount": 3762.87,
"FeeAmount": 3,
"PaymentData": {
"MaskedAccount": "4XXXXXXXX1111",
"AccountType": "visa",
"AccountExp": "11/29",
"AccountZip": "90210",
"HolderName": "Chad Mercia",
"orderDescription": "Depost for materials for 123 Walnut St",
"StoredId": "1ec55af9-7b5a-4ff0-81ed-c12d2f95e135-4440",
"Initiator": "payor",
"StoredMethodUsageType": "subscription",
"Sequence": "subsequent",
"accountId": "<string>",
"SignatureData": null,
"binData": {
"binMatchedLength": 6,
"binCardBrand": "Visa",
"binCardType": "Credit",
"binCardCategory": "PLATINUM",
"binCardIssuer": "Bank of Example",
"binCardIssuerCountry": "United States",
"binCardIssuerCountryCodeA2": "US",
"binCardIssuerCountryNumber": 840
},
"paymentDetails": {
"totalAmount": 100,
"serviceFee": 0,
"currency": "USD",
"checkNumber": "107",
"checkImage": {},
"categories": [
{
"label": "Deposit",
"description": "Deposit for materials",
"amount": 1000,
"qty": 1
}
],
"splitFunding": [
{
"recipientEntryPoint": "41035afaa7",
"accountId": "187-782",
"description": "Split for annual dues",
"amount": 456.23
}
]
}
},
"StartDate": "2025-10-19T00:00:00",
"EndDate": "2025-10-19T00:00:00",
"NextDate": "2025-10-19T00:00:00",
"Frequency": "monthly",
"TotalCycles": 24,
"LeftCycles": 15,
"LastRun": "2025-10-19T00:00:00",
"SubStatus": 1,
"EntrypageId": 0,
"PlanId": 0,
"UntilCancelled": true,
"SubEvents": [
{
"description": "TransferCreated",
"eventTime": "2023-07-05T22:31:06.8317486+00:00",
"refData": "<string>",
"extraData": {},
"source": "api"
}
],
"LastUpdated": "2022-07-01 15:00:01",
"Customer": {
"CustomerId": 4440,
"FirstName": "John",
"LastName": "Doe",
"CompanyName": "Sunshine LLC",
"CustomerNumber": "3456-7645A",
"BillingAddress1": "1111 West 1st Street",
"BillingAddress2": "Suite 200",
"BillingCity": "Miami",
"BillingState": "FL",
"BillingZip": "45567",
"BillingCountry": "US",
"BillingPhone": "5555555555",
"BillingEmail": "example@email.com",
"ShippingAddress1": "123 Walnut St",
"ShippingAddress2": "STE 900",
"ShippingCity": "Johnson City",
"ShippingState": "TN",
"ShippingZip": "37619",
"ShippingCountry": "US",
"AdditionalData": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"CreatedAt": "2022-07-01 15:00:01",
"customerId": 4440,
"customerStatus": 1,
"Identifiers": [
"\\\"firstname\\\"",
"\\\"lastname\\\"",
"\\\"email\\\"",
"\\\"customId\\\""
]
},
"InvoiceData": {
"invoiceNumber": "INV-2345",
"invoiceDate": "2024-07-01",
"invoiceDueDate": "2024-07-01",
"invoiceType": 0,
"invoiceEndDate": "2024-07-01",
"invoiceStatus": 1,
"frequency": "monthly",
"paymentTerms": "PIA",
"termsConditions": "Must be paid before work scheduled.",
"notes": "Example notes.",
"tax": 2.05,
"discount": 10,
"invoiceAmount": 105,
"freightAmount": 10,
"dutyAmount": 0,
"purchaseOrder": "PO-345",
"firstName": "Chad",
"lastName": "Mercia",
"company": "ACME, INC",
"shippingAddress1": "123 Walnut St",
"shippingAddress2": "STE 900",
"shippingCity": "Johnson City",
"shippingState": "TN",
"shippingZip": "37619",
"shippingCountry": "US",
"shippingEmail": "example@email.com",
"shippingPhone": "5555555555",
"shippingFromZip": "30040",
"summaryCommodityCode": "501718",
"items": [
{
"itemProductCode": "M-DEPOSIT",
"itemProductName": "Materials deposit",
"itemDescription": "Deposit for materials.",
"itemCommodityCode": "010",
"itemUnitOfMeasure": "SqFt",
"itemCost": 5,
"itemQty": 1,
"itemMode": 0,
"itemCategories": [
"<string>"
],
"itemTotalAmount": 123,
"itemTaxAmount": 7,
"itemTaxRate": 0.075
}
],
"attachments": {},
"AdditionalData": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
}
},
"PaypointLegalname": "Sunshine Services, LLC",
"PaypointDbaname": "Sunshine Gutters",
"PaypointEntryname": "d193cf9a46",
"ParentOrgName": "PropertyManager Pro",
"CreatedAt": "2022-07-01 15:00:01",
"ExternalPaypointID": "Paypoint-100",
"Source": "api"
}
Authorizations
Most endpoints require an organization
token. Some endpoints require an application
token, and those endpoints are noted.
Path Parameters
The subscription ID.
231
Response
The subscription's ID.
396
The subscription's payment method.
"card"
The paypoint's ID. Note that this is different than the entryname.
255
The subscription amount, including any fees.
103
The subscription amount, minus any fees.
3762.87
Fee applied to the subscription.
3
Masked card or bank account used in transaction. In the case of Apple Pay, this is a masked DPAN (device primary account number).
"4XXXXXXXX1111"
Bank account type or card brand.
"visa"
Expiration date of card used in transaction.
"11/29"
ZIP code for card used in transaction.
"90210"
Account holder name for the method.
"Chad Mercia"
Text description of the transaction.
250
"Depost for materials for 123 Walnut St"
Identifier of stored payment method used in transaction.
"1ec55af9-7b5a-4ff0-81ed-c12d2f95e135-4440"
Strongly recommended The cardholder-initiated transaction (CIT) or merchant-initiated transaction (MIT) indicator for the transaction. If you don't specify a value, Payabli defaults to merchant
.
Available values:
payor
: For cardholder-initiated transactionsmerchant
: For merchant-initiated transactions
See Understanding CIT and MIT Indicators for more information.
"payor"
Strongly recommended The usage type for the stored method, used for merchant-initiated transactions (MIT). If you don't specify a value, Payabli defaults to unscheduled
.
Available values:
unscheduled
: This type is used for transactions that are one-time or otherwise not pre-scheduled.subscription
: This type is used for subscription payments. For example, monthly rental fees or ongoing service subscriptions.recurring
: This type is used for recurring payments that occur per a set plan. For example, splitting an HOA special assessment over 6 monthly payments.
See Understanding CIT and MIT Indicators for more information.
"subscription"
The order of the transaction for cardholder-initiated transaction (CIT) and merchant-initiated transaction (MIT) purposes. This field is automatically detected and populated by Payabli.
Available values:
first
: The first use of the payment method. This is almost always a cardholder-initiated transaction.subsequent
: For merchant-initiated transactions after the first use of the payment method.
See Understanding CIT and MIT Indicators for more information.
"subsequent"
Custom identifier for payment connector.
250
null
Object containing information related to the card. This object is null
unless the payment method is card. If the payment method is Apple Pay, the binData will be related to the DPAN (device primary account number), not the card connected to Apple Pay.
The number of characters from the beginning of the card number that were matched against a Bank Identification Number (BIN) or the Card Range table.
6
The card brand. For example, Visa, Mastercard, American Express, Discover.
"Visa"
The type of card: Credit or Debit.
"Credit"
The category of the card, which indicates the card product. For example: Standard, Gold, Platinum, etc. The binCardCategory for prepaid cards is marked PREPAID
.
"PLATINUM"
The name of the financial institution that issued the card.
"Bank of Example"
The issuing financial institution's country name.
"United States"
The issuing financial institution's two-character ISO country code. See this resource for a list of codes.
"US"
The issuing financial institution's ISO standard numeric country code. See this resource for a list of codes.
840
Details about the payment.
Total amount to be charged. If a service fee is sent, then this amount should include the service fee."
100
Service fee to be deducted from the total amount. This amount must be a number, percentages aren't accepted. If you are using a percentage-based fee schedule, you must calculate the value manually.
0
Currency code ISO-4217. If not code is provided the currency in the paypoint setting is taken. Default is USD.
"USD"
A check number to be used in the ach transaction. Required for payment method = 'check'.
"107"
Object containing image of paper check.
Array of payment categories/line items describing the amount to be paid Note: These categories are for information only and are not validated against the total amount provided.
Name of item or category.
"Deposit"
Price/cost per unit of item or category.
1000
Description of item or category
"Deposit for materials"
Quatity of item or category
Split funding instructions for the transaction. See Split a Transaction for more.
The entrypoint the split should be sent to.
"41035afaa7"
The accountId for the account the split should be sent to.
"187-782"
A description for the split.
"Split for annual dues"
Amount from the transaction to sent to this recipient.
456.23
The subscription start date.
"2025-10-19T00:00:00"
The subscription's end date.
"2025-10-19T00:00:00"
The next date the subscription will be processed.
"2025-10-19T00:00:00"
The subscription's frequency.
"monthly"
The total number of cycles the subscription is set to run.
24
The number of cycles the subscription has left.
15
The last time the subscription was processed.
"2025-10-19T00:00:00"
The subscription's status.
- 0: Paused
- 1: Active
1
If applicable, the internal reference ID to the payment page capturing the payment.
0
Payment plan ID.
0
When true
, the subscription has no explicit end date and will run until canceled.
true
Events associated with the subscription.
Event description.
"TransferCreated"
Event timestamp, in UTC.
"2023-07-05T22:31:06.8317486+00:00"
Reference data.
Extra data.
The event source.
100
"api"
The last date and time the subscription was updated.
"2022-07-01 15:00:01"
The Payabli-generated unique ID for the customer.
4440
Customer/Payor first name.
"John"
Customer/Payor last name.
"Doe"
Customer's company name.
"Sunshine LLC"
User-provided unique identifier for the customer. This is typically the customer ID from your own system.
250
"3456-7645A"
Customer's billing address.
"1111 West 1st Street"
Additional line for Customer's billing address.
"Suite 200"
Customer's billing city.
"Miami"
Customer's billing state. Must be 2-letter state code for address in US.
"FL"
Customer's billing ZIP code.
"45567"
Customer's billing country.
"US"
Customer's phone number.
"5555555555"
Customer's email address.
320
"example@email.com"
The shipping address.
250
"123 Walnut St"
Additional line for shipping address.
100
"STE 900"
Shipping city.
250
"Johnson City"
Shipping state or province.
"TN"
Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".
50
"37619"
Shipping address country.
"US"
Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. Example usage:
{
"additionalData": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
}
}
{
"key1": "value1",
"key2": "value2",
"key3": "value3"
}
Timestamp of when record was created, in UTC.
"2022-07-01 15:00:01"
The Payabli-generated unique ID for the customer.
4440
Customer Status. Possible values:
-99
Deleted0
Inactive1
Active85
Locked (typically due to multiple failed login attempts)
1
Array of field names to be used as identifiers.
[
"\\\"firstname\\\"",
"\\\"lastname\\\"",
"\\\"email\\\"",
"\\\"customId\\\""
]
Invoice number. Identifies the invoice under a paypoint.
250
"INV-2345"
Invoice date in any of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.
"2024-07-01"
Invoice due date in one of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.
"2024-07-01"
Type of invoice. Only 0
for one-time invoices is currently supported.
0
Indicate the date to finish a scheduled invoice cycle (`invoiceType`` = 1) in any of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.
"2024-07-01"
Status for invoice.
The accepted status values are:
- 0 draft
- 1 active
- 2 partially paid
- 4 paid/complete
- 99 cancelled
0
, 1
, 2
, 4
, 99
1
Frequency of scheduled invoice.
one-time
, weekly
, every2weeks
, every6months
, monthly
, every3months
, annually
"monthly"
Payment terms for invoice. If no terms are defined, then reponse data for this field defaults to N30
.
PIA
, CIA
, UR
, NET10
, NET20
, NET30
, NET45
, NET60
, NET90
, EOM
, MFI
, 5MFI
, 10MFI
, 15MFI
, 20MFI
, 2/10NET30
, UF
, 10UF
, 20UF
, 25UF
, 50UF
"PIA"
Custom terms and conditions included in the invoice.
"Must be paid before work scheduled."
Notes included in the invoice.
"Example notes."
Tax rate in percent applied to the invoice.
2.05
Discount applied to the invoice.
10
Invoice total amount.
105
Freight/shipping amount.
10
Duty amount.
0
Purchase order number.
"PO-345"
First name of the recipient of the invoice.
"Chad"
Last name of the recipient of the invoice.
"Mercia"
Company name of the recipient of the invoice.
"ACME, INC"
The shipping address.
250
"123 Walnut St"
Additional line for shipping address.
100
"STE 900"
Shipping city.
250
"Johnson City"
Shipping state or province.
"TN"
Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".
50
"37619"
Shipping address country.
"US"
Shipping recipient's contact email address.
320
"example@email.com"
Recipient phone number.
"5555555555"
Sender shipping ZIP code.
"30040"
Commodity code.
"501718"
Array of line items included in the invoice.
Item or product name. Max length of 250 characters.
250
"Materials deposit"
Item or product price per unit.
5
Quantity of item or product.
1
Item or product code. Max length of 250 characters.
250
"M-DEPOSIT"
Item or product description. Max length of 250 characters.
250
"Deposit for materials."
Item or product commodity code. Max length of 250 characters.
250
"010"
Unit of measurement. Max length of 100 characters.
100
"SqFt"
Internal class of item or product: value '0' is only for invoices , '1' for bills and, '2' common for both.
0
, 1
, 2
0
Array of tags classifying item or product.
Total amount in item or product.
Tax amount applied to item or product.
7
Tax rate applied to item or product.
0.075
Array of fileContent
objects with attached documents. Max upload size is 30 MB.
Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. Example usage:
{
"additionalData": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
}
}
{
"key1": "value1",
"key2": "value2",
"key3": "value3"
}
The paypoint's legal name.
"Sunshine Services, LLC"
The paypoint's DBA name.
"Sunshine Gutters"
The paypoint's entryname.
50
"d193cf9a46"
The name of the parent organization.
"PropertyManager Pro"
Timestamp of when the subscription ws created, in UTC.
"2022-07-01 15:00:01"
A custom identifier for the paypoint, if applicable. Like entrypoint
is the Payabli identifier for the merchant, externalPaypointId
is a custom field you can use to include the merchant's ID from your own systems.
"Paypoint-100"
Custom identifier to indicate the transaction or request source.
100
"api"
curl --request GET \
--url https://api-sandbox.payabli.com/api/Subscription/{subId} \
--header 'requestToken: <api-key>'
{
"IdSub": 396,
"Method": "card",
"PaypointId": 255,
"TotalAmount": 103,
"NetAmount": 3762.87,
"FeeAmount": 3,
"PaymentData": {
"MaskedAccount": "4XXXXXXXX1111",
"AccountType": "visa",
"AccountExp": "11/29",
"AccountZip": "90210",
"HolderName": "Chad Mercia",
"orderDescription": "Depost for materials for 123 Walnut St",
"StoredId": "1ec55af9-7b5a-4ff0-81ed-c12d2f95e135-4440",
"Initiator": "payor",
"StoredMethodUsageType": "subscription",
"Sequence": "subsequent",
"accountId": "<string>",
"SignatureData": null,
"binData": {
"binMatchedLength": 6,
"binCardBrand": "Visa",
"binCardType": "Credit",
"binCardCategory": "PLATINUM",
"binCardIssuer": "Bank of Example",
"binCardIssuerCountry": "United States",
"binCardIssuerCountryCodeA2": "US",
"binCardIssuerCountryNumber": 840
},
"paymentDetails": {
"totalAmount": 100,
"serviceFee": 0,
"currency": "USD",
"checkNumber": "107",
"checkImage": {},
"categories": [
{
"label": "Deposit",
"description": "Deposit for materials",
"amount": 1000,
"qty": 1
}
],
"splitFunding": [
{
"recipientEntryPoint": "41035afaa7",
"accountId": "187-782",
"description": "Split for annual dues",
"amount": 456.23
}
]
}
},
"StartDate": "2025-10-19T00:00:00",
"EndDate": "2025-10-19T00:00:00",
"NextDate": "2025-10-19T00:00:00",
"Frequency": "monthly",
"TotalCycles": 24,
"LeftCycles": 15,
"LastRun": "2025-10-19T00:00:00",
"SubStatus": 1,
"EntrypageId": 0,
"PlanId": 0,
"UntilCancelled": true,
"SubEvents": [
{
"description": "TransferCreated",
"eventTime": "2023-07-05T22:31:06.8317486+00:00",
"refData": "<string>",
"extraData": {},
"source": "api"
}
],
"LastUpdated": "2022-07-01 15:00:01",
"Customer": {
"CustomerId": 4440,
"FirstName": "John",
"LastName": "Doe",
"CompanyName": "Sunshine LLC",
"CustomerNumber": "3456-7645A",
"BillingAddress1": "1111 West 1st Street",
"BillingAddress2": "Suite 200",
"BillingCity": "Miami",
"BillingState": "FL",
"BillingZip": "45567",
"BillingCountry": "US",
"BillingPhone": "5555555555",
"BillingEmail": "example@email.com",
"ShippingAddress1": "123 Walnut St",
"ShippingAddress2": "STE 900",
"ShippingCity": "Johnson City",
"ShippingState": "TN",
"ShippingZip": "37619",
"ShippingCountry": "US",
"AdditionalData": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"CreatedAt": "2022-07-01 15:00:01",
"customerId": 4440,
"customerStatus": 1,
"Identifiers": [
"\\\"firstname\\\"",
"\\\"lastname\\\"",
"\\\"email\\\"",
"\\\"customId\\\""
]
},
"InvoiceData": {
"invoiceNumber": "INV-2345",
"invoiceDate": "2024-07-01",
"invoiceDueDate": "2024-07-01",
"invoiceType": 0,
"invoiceEndDate": "2024-07-01",
"invoiceStatus": 1,
"frequency": "monthly",
"paymentTerms": "PIA",
"termsConditions": "Must be paid before work scheduled.",
"notes": "Example notes.",
"tax": 2.05,
"discount": 10,
"invoiceAmount": 105,
"freightAmount": 10,
"dutyAmount": 0,
"purchaseOrder": "PO-345",
"firstName": "Chad",
"lastName": "Mercia",
"company": "ACME, INC",
"shippingAddress1": "123 Walnut St",
"shippingAddress2": "STE 900",
"shippingCity": "Johnson City",
"shippingState": "TN",
"shippingZip": "37619",
"shippingCountry": "US",
"shippingEmail": "example@email.com",
"shippingPhone": "5555555555",
"shippingFromZip": "30040",
"summaryCommodityCode": "501718",
"items": [
{
"itemProductCode": "M-DEPOSIT",
"itemProductName": "Materials deposit",
"itemDescription": "Deposit for materials.",
"itemCommodityCode": "010",
"itemUnitOfMeasure": "SqFt",
"itemCost": 5,
"itemQty": 1,
"itemMode": 0,
"itemCategories": [
"<string>"
],
"itemTotalAmount": 123,
"itemTaxAmount": 7,
"itemTaxRate": 0.075
}
],
"attachments": {},
"AdditionalData": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
}
},
"PaypointLegalname": "Sunshine Services, LLC",
"PaypointDbaname": "Sunshine Gutters",
"PaypointEntryname": "d193cf9a46",
"ParentOrgName": "PropertyManager Pro",
"CreatedAt": "2022-07-01 15:00:01",
"ExternalPaypointID": "Paypoint-100",
"Source": "api"
}