The identity and technical contract details declared by the specification.
ResultCode
integer
Result code for the operation. Value 1 indicates a successful operation, values 2 and 3 indicate errors. A value of 10 indicates that an operation has been ini…
TransactionDetailPaymentDetails
object
Detailed breakdown of payment amounts and identifiers
14 properties
14 required
QueryPaymentData
object
14 properties
V2TransactionResponseWrapper
object
Standard response wrapper for v2 Money In transaction endpoints. All v2 transaction endpoints return responses in this format with consistent code, reason, exp…
6 properties
6 required
AccountId
string
Custom identifier for payment connector.
ReturnedId
integer
Identifier of return/chargeback transaction linked to this payment.
Netamountnullable
number
Net amount.
QueryTransactionEventsEventData
Any data associated to the event received from processor. Contents vary by event type.
Email
string
Email address.
CustomerStatus
integer
Customer Status. Possible values: - -99 Deleted - 0 Inactive - 1 Active - 85 Locked (typically due to multiple failed login attempts)
TransactionDetailEvent
object
Event associated with transaction processing
3 properties
3 required
PaymentCategories
object
4 properties
2 required
Cardholder
string
Cardholder name.
SplitCount
integer
Number of split funding instructions associated with the transaction. Returns 0 when the transaction has no splits.
CvvResponseText
string
Text code describing the result for CVV validation (applies only for card transactions).
CaptureResponse
object
Response for MoneyIn/capture endpoint
6 properties
6 required
Cardzip
string
ZIP or postal code for the billing address of cardholder. We strongly recommend that you include this field when using card as a method.
AchValidation
boolean
When true, enables real-time validation of ACH account and routing numbers. This is an add-on feature, contact Payabli for more information.
PayabliApiResponse0
object
General response for certain moneyIn and moneyOut endpoints.
4 properties
1 required
RetrievalId
integer
Identifier of retrieval request.
ValidateResponseData
object
Response data for card validation
8 properties
7 required
Accountexp
string
Expiration date of card used in transaction.
V2TransactionDetailResponseData
object
Response data from payment processor
16 properties
16 required
RiskReason
string
Reason for risk flagging.
BillingCityNullable
string
Billing city.
V2ResponseExplanation
string
Detailed description of the response code.
RiskAction
string
Action taken due to risk assessment.
Subscriptionid
integer
Payabli identifier of the subscription associated with the transaction.
V2BadRequestErrorDetail
object
Individual field error detail for bad request responses.
2 properties
2 required
BillItem
object
12 properties
FileContent
object
Contains details about a file. Max upload size is 30 MB.
4 properties
EntrypageId
integer
If applicable, the internal reference ID to the payment page associated with the transaction.
TransactionDetailRecord
object
Complete transaction details including payment information, customer data, and processing metadata. This is returned when includeDetails=true.
51 properties
47 required
RiskFlagged
boolean
Indicates if the transaction was flagged for risk.
AuthResponse
object
Response for MoneyIn/authorize.
4 properties
3 required
RequestPaymentValidatePaymentMethod
object
Object describing payment method to use for validation.
5 properties
5 required
Legalname
string
Business legal name.
Cash
object
1 property
1 required
ResultCodeText
string
Description of the result code. See [Pay In unified response codes](/guides/pay-in-unified-response-codes-reference) for more information.
PayabliApiResponse
object
3 properties
1 required
ItemCommodityCode
string
Item or product commodity code. Max length of 250 characters.
Cardexp
string
Card expiration date in format MMYY or MM/YY. Required for card transactions.
CvvResponse
string
Text code describing the result for CVV validation (applies only for card transactions).
Shippingstate
string
Shipping state or province.
PurchaseOrder
string
Purchase order number.
ExternalPaypointId
string
A custom identifier for the paypoint, if applicable.
IpAddress
string
The IP address associated with the transaction.
Orgid
integer
Organization ID. Unique identifier assigned to an org by Payabli.
InvoiceNumber
string
Invoice number. Identifies the invoice under a paypoint.
Accountzip
string
ZIP code for card used in transaction.
V2ResponseReason
string
Human-readable reason corresponding to the response code.
ExpectedProcessingDateTime
string
The expected time that the refund will be processed.
PayMethodStoredMethod
object
The required and recommended fields for a payment made with a stored payment method.
4 properties
1 required
TransactionQueryRecordsCustomer
object
40 properties
2 required
PayorId
integer
Unique ID for the customer linked to the transaction. This is the same value as the customerId used when creating or referencing a customer.
ItemProductName
string
Item or product name. Max length of 250 characters.
ReverseResponse
object
6 properties
5 required
Operation
string
The transaction's operation.
Device
string
Identifier of registered cloud device used in the transaction.
Entrypointfield
string
The entrypoint identifier.
BatchNumber
string
A unique identifier for the batch. This is generated by Payabli when the batch is created, and follows this format: paypointId + "" + serviceName + "" + batchD…
PayabliErrorBodyResponseData
object
Object with detailed error context.
2 properties
StoredMethodUsageType
string
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 u…
Frequency
string
Frequency for operation. The firstofmonth, fifteenthofmonth, and endofmonth values are only valid on subscriptions — they aren't accepted by other endpoints (s…
Holdername
string
The cardholder name.
PayorDataRequest
object
Customer information. May be required, depending on the paypoint's settings. Required for subscriptions.
21 properties
SettlementStatus
integer
Settlement status for transaction. See [the docs](/developers/references/money-in-statusespayment-funding-status) for a full reference.
V2ResponseAction
string
Recommended resolution approach or next steps based on the response.
RiskFlaggedOn
string
Timestamp when the transaction was flagged for risk.
Attachments
array
Array of fileContent objects with attached documents. Max upload size is 30 MB.
PhoneNumber
string
Phone number.
Customeridtrans
integer
Payabli-generated unique ID of customer owner of transaction. Returns 0 if the transaction wasn't assigned to an existing customer or no customer was created.
PaymentDetailCredit
object
The PaymentDetail object for microdeposit (MakeCredit) transactions.
3 properties
1 required
TransactionDetailResponseData
object
Response data from payment processor
16 properties
14 required
V2TransactionDetails
object
Complete transaction details returned by v2 Money In endpoints. This matches the structure of the transaction details previously returned by the v1 details end…
51 properties
47 required
GetPaidResponseData
object
Response data for GetPaid transactions
9 properties
7 required
IdempotencyKey
string
Optional but recommended. A unique ID that you can include to prevent duplicating objects or transactions in the case that a request is sent more than once. Th…
AdditionalDataMap
object
Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. If you are using [custom identifiers](…
AvsResponseText
string
Text code describing the result for address validation (applies only for card transactions).
PaymentDetail
object
Details about the payment.
8 properties
1 required
SplitFundingContent
object
4 properties
Storedmethodid
string
Payabli identifier of a tokenized payment method. If this field is used in a request, the method field is overridden and the payment is made using the payment…
BillData
object
32 properties
Shippingcity
string
Shipping city.
RefundResponse
object
4 properties
3 required
BillDataPaymentTerms
string
Payment terms for invoice. If no terms are defined, then response data for this field defaults to NET30. Mirrors the values in [Terms](schema-terms).
ExternalProcessorInformation
string
Information from the external processor about the transaction.
AchSecCode
string
Standard Entry Class (SEC) code is a three letter code that describes how an ACH payment was authorized. Supported values are: - PPD (Prearranged Payment and D…
TransactionDetailCustomer
object
Customer information associated with the transaction
22 properties
22 required
SplitFunding
array
Split funding instructions for the transaction. The total amount of the splits must match the total amount of the transaction.
Tax
number
Tax rate in percent applied to the invoice.
RequestRefund
object
6 properties
Methodall
string
Method to use for the transaction.
BillingStateNullable
string
Billing state. Must be a 2-letter state code for addresses in the US.
AdditionalData
object
Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. If you are using [custom identifiers](…
CapturePaymentDetails
object
2 properties
1 required
ItemProductCode
string
Item or product code. Max length of 250 characters.
ItemUnitofMeasure
string
Unit of measurement. Max length of 100 characters.
ShippingFromZip
string
Sender shipping ZIP code.
Resulttext
string
Text describing the result. If ResultCode = 1, will return Approved or a general success message. If ResultCode = 2 or 3, will contain the cause of the error o…
BillingAddressNullable
string
Billing address.
RefundWithInstructionsResponse
object
4 properties
3 required
RiskStatus
string
Current risk status of the transaction.
BinData
object
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…
11 properties
Orderdescription
string
Text description of the transaction.
Accounttype
string
Bank account type or card brand.
PayMethodCredit
object
8 properties
3 required
QueryTransactionEvents
object
3 properties
Shippingzip
string
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 3…
Authcode
string
Authorization code for the transaction.
DutyAmount
number
Duty amount.
ReceiptResponse
object
Response for SendReceipt endpoint.
3 properties
1 required
PayabliApiResponse0ResponseData
object
8 properties
IsSuccess
boolean
Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.
Shippingaddress
string
The shipping address.
AuthResponseResponseData
object
8 properties
7 required
TransactionDetailInvoiceData
object
Invoice information if transaction is associated with an invoice
32 properties
32 required
VoidResponseData
object
Response data for void transactions
8 properties
4 required
Dbaname
string
The alternate or common name that this business is doing business under, usually referred to as a DBA name.
Achrouting
string
ABA/routing number of Bank account.
Achaccount
string
Bank account number.
FreightAmount
number
Freight/shipping amount.
RequestPaymentValidatePaymentMethodMethod
string
The card validation method.
PayMethodACH
object
8 properties
4 required
PaypointId
integer
The paypoint's ID. Note that this is different than the entryname.
FeeAmount
number
Service fee or sub-charge applied.
CaptureResponseData
object
Response data for capture transactions
8 properties
8 required
Subdomain
string
Refers to the payment page identifier. If provided, then the transaction is linked to the payment page.
Cardnumber
string
The card number. Required when method is card and a storedMethodId isn't included.
QueryTransactionPayorDataCustomer
object
22 properties
AchHolder
string
Bank account holder. This field is required when method is ach or check.
Shippingcountry
string
Shipping address country.
ResponseText
string
Response text for operation: 'Success' or 'Declined'.
TermsConditions
string
Custom terms and conditions included in the invoice.
EmvAuthResponseData
string
EMV authorization response data, applicable for card transactions.
InvoiceAmount
number
The invoice amount.
Referenceidtrans
string
The transaction identifier in Payabli.
ResponseDataRefunds
object
9 properties
8 required
PayabliErrorBody
object
Shape returned by every Payabli API error response. The responseData object carries human-readable error context.
4 properties
2 required
OrgParentName
string
The name of the parent organization.
Source
string
Custom identifier to indicate the transaction or request source.
TransactionDetailRecordMethod
string
Payment method used for the transaction
BillingAddressAddtlNullable
string
Additional line for the billing address.
BillingCountryNullable
string
Billing address country.
TransactionTime
string
Timestamp when transaction was submitted, in UTC.
Initiator
string
The transaction's initiator. Indicates who initiated the transaction.
QueryResponseData
object
The transaction's response data.
15 properties
RefundId
integer
Identifier of refund transaction linked to this payment.
RiskActionCode
integer
Numeric code representing the risk action.
Check
object
2 properties
2 required
Identifierfields
array
List of fields acting as customer identifiers, to be used instead of CustomerNumber.
PendingFeeAmount
number
The difference between the configured pass-through fee and the fee amount sent in the request. When transferring funds, Payabli uses this field to deduct the f…
InvoiceType
integer
Invoice type. Value 0 is for single/one-time invoices, 1 for scheduled invoices.
AvsResponse
string
Text code describing the result for address validation (applies only for card transactions).
Invoicestatus
integer
Invoice status code.
PageIdentifier
string
Auxiliary validation used internally by payment pages and components.
Sequence
string
The order of the transaction for cardholder-initiated transaction (CIT) and merchant-initiated transaction (MIT) purposes. This field is automatically detected…
Discount
number
Discount applied to the invoice.
SummaryCommodityCode
string
Commodity code.
VoidResponse
object
Response for MoneyIn/void endpoint
6 properties
5 required
PayMethodCloud
object
3 properties
1 required
V2BadRequestError
object
Bad request error response (HTTP 400) returned when request validation fails. Follows RFC 7807 Problem Details format with additional Payabli-specific fields.
8 properties
8 required
CustomerId
integer
The Payabli-generated unique ID for the customer.
TransStatus
integer
Status of transaction. See [the docs](/developers/references/money-in-statusesmoney-in-transaction-status) for a full reference.
FileContentFtype
string
The MIME type of the file (if content is provided).
PayMethodStoredMethodMethod
string
Method to use for the transaction. Use card, ach, or wallet depending on what kind of method was tokenized to use a saved payment method for this transaction.
Responsecode
integer
Code for the response. Learn more in [API Response Codes](/developers/api-reference/api-responses).
PaymentMethod
Information about the payment method for the transaction.
V2DeclinedTransactionResponseWrapper
object
Response wrapper for declined v2 Money In transaction endpoints (HTTP 402). Returned when a transaction is declined by the card network or issuer. All decline…
6 properties
6 required
RefundV2Request
object
Optional request body for the v2 refund endpoints. Provide split instructions to refund a split-funded transaction. Omit the body for a standard refund. Fields…
6 properties
ForceCustomerCreation
boolean
When true, the request creates a new customer record, regardless of whether customer identifiers match an existing customer. Defaults to false.
TransRequestBody
object
12 properties
2 required
CaptureRequest
object
1 property
1 required
RoomIdNotInUse
integer
Field not in use on this endpoint. It always returns 0.
Shippingaddressadditional
string
Additional line for shipping address.
V2InternalServerError
object
Internal server error response (HTTP 500) returned when an unexpected error occurs. Follows RFC 7807 Problem Details format.
4 properties
4 required
CustomerNumberNullable
string
User-provided unique identifier for the customer. This is typically the customer ID from your own system.
AchHolderType
string
The bank's accountholder type: personal or business.
RequestPaymentValidate
object
5 properties
2 required
MethodReferenceId
string
The stored method's identifier (sometimes referred to as 'token') in Payabli. When null, the method wasn't created, or doesn't exist, depending on the operatio…
BillingZip
string
Billing address ZIP code.
V2ResponseCode
string
Payabli's unified response code. Starts with A (Approved) or D (Declined) followed by a four-digit code that provides specific details about the transaction re…
Responsedata
object
The object containing the response data.
RequestCreditPaymentMethod
object
Object describing the ACH payment method to use for transaction.
6 properties
1 required
SaveIfSuccess
boolean
When true, Payabli saves the payment method if the transaction is successful. The payment method ID is returned in the response as methodReferenceId. Defaults…
Achaccounttype
string
Bank account type: Checking or Savings.
PayMethodBodyAllFields
object
Model for the PaymentMethod object, includes all method types.
16 properties
3 required
Maskedaccount
string
Masked card or bank account used in transaction. In the case of Apple Pay, this is a masked DPAN (device primary account number).
ItemDescription
string
Item or product description. Max length of 250 characters.
SplitFundingRefundContent
object
4 properties
ValidateResponse
object
Response for card validation endpoint
3 properties
3 required
ResultCodev2
string
Unified result code for the transaction. See [Pay In unified response codes](/guides/pay-in-unified-response-codes-reference) for more information.
RequestCredit
object
9 properties
3 required
OrderId
string
Custom identifier for the transaction.
Cardcvv
string
Card Verification Value (CVV) associated with the card number. We strongly recommend that you include this field when using card as a method.
TransactionDetailPaymentData
object
Payment method and transaction details
13 properties
13 required
QueryCFeeTransaction
object
8 properties
ChargebackId
integer
Identifier of chargeback transaction.
RefundDetail
object
Object containing details about the refund, including line items and optional split instructions.
2 properties
PayabliAPIResponseGetPaid
object
General response for GetPaid endpoint supporting multiple payment methods
4 properties
3 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Payabli publishes across the network.