The identity and technical contract details declared by the specification.
NetAmountstring
string
Net amount owed in bill. Required when adding a bill.
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…
QueryPaymentData
object
14 properties
BankAccountHolderType
string
Describes whether the bank is a personal or business account.
VendorResponseStoredMethod
object
Stored payment method information
17 properties
17 required
EntityIdString
string
The entity's ID in Payabli. If the entity is a paypoint, this is the paypoint ID. If the entity is an organization, this is the organization ID.
AccountId
string
Custom identifier for payment connector.
VendorQueryRecord
object
53 properties
QueryTransactionEventsEventData
Any data associated to the event received from processor. Contents vary by event type.
Netamountnullable
number
Net amount.
Email
string
Email address.
VendorSummary
object
16 properties
PaymentCategories
object
4 properties
2 required
OrgParentId
integer
The ID of the org's parent organization.
CvvResponseText
string
Text code describing the result for CVV validation (applies only for card transactions).
LocationCode
string
A location code used to identify the vendor's location.
Accountexp
string
Expiration date of card used in transaction.
AuthorizePayoutBody
object
12 properties
5 required
Remitstate
string
Remittance address state or province. Used for mailing paper checks. Required if any remittance address field is provided. Must be a valid US state or Canadian…
ReissuePayoutBody
object
Request body for reissuing a payout transaction.
1 property
1 required
Vendorstatus
integer
Vendor's status. Allowed values: - 0 Inactive - 1 Active - -99 Deleted
RiskReason
string
Reason for risk flagging.
BillingDataResponse
object
14 properties
13 required
HasVcardTransactions
boolean
When true, indicates that the paypoint has vCard transactions.
RiskAction
string
Action taken due to risk assessment.
Subscriptionid
integer
Payabli identifier of the subscription associated with the transaction.
BillDetailsResponse
object
Response object for bill details. Contains basic information about a bill.
8 properties
2 required
Remitcountry
string
Remittance address country. Used for mailing paper checks. Must be US or CA. Defaults to US if not provided.
FileContent
object
Contains details about a file. Max upload size is 30 MB.
4 properties
PayeeName
string
Alternative name used to receive paper check.
RenewVCardResponseData
object
9 properties
9 required
RenewVCardRequest
object
1 property
1 required
ContactsField
array
List of contacts.
RiskFlagged
boolean
Indicates if the transaction was flagged for risk.
Legalname
string
Business legal name.
StateNullable
string
The state or province.
ReissuePaymentMethod
object
Payment method for reissuing a payout transaction. The reissue endpoint uses the payment method details directly. It doesn't fall back to the vendor's managed…
6 properties
1 required
CreatedAt
string
Timestamp of when record was created, in UTC.
RoutingAccount
string
Routing number of bank account.
CancelPayoutResponseData
object
Response data for canceling a single payout transaction. Mirrors the general response data, with VendorId added alongside CustomerId.
9 properties
ExternalPaypointId
string
A custom identifier for the paypoint, if applicable.
VCardGetResponse
object
27 properties
InvoiceNumber
string
Invoice number. Identifies the invoice under a paypoint.
Accountzip
string
ZIP code for card used in transaction.
Gatewayfield
string
The payment gateway used to process the transaction.
AllowedCheckPaymentStatus
string
The new status to apply to a check payment transaction. - 0: Cancelled/Voided — Cancels the check transaction. - 5: Paid — Marks the check transaction as paid.
AuthorizePaymentMethod
object
Payment method object for vendor payouts. - { method: "managed" } - Managed payment method - { method: "vcard" } - Virtual card payment method - { method: "che…
10 properties
1 required
VCardGetResponseAssociatedVendorSummary
object
Summary of vendor's billing and transaction status.
16 properties
Entrypointfield
string
The entrypoint identifier.
AccountingField
string
Optional custom field.
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…
Remitzip
string
Remittance address ZIP or postal code. Used for mailing paper checks. Required if any remittance address field is provided. For US addresses, use five digits o…
VendorPhone
string
Vendor's phone number. Phone number can't contain non-digit characters like hyphens or parentheses.
AddressNullable
string
The address.
Holdername
string
The cardholder name.
VendorCheckNumber
string
A check number between 1 and 500,000,000. This value must be passed as a string. This value can be used for fraud prevention with the positive pay service. Whe…
Attachments
array
Array of fileContent objects with attached documents. Max upload size is 30 MB.
RiskFlaggedOn
string
Timestamp when the transaction was flagged for risk.
RequestOutAuthorizePaymentDetails
object
Object containing payment details.
5 properties
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…
SettlementStatusPayout
string
The settlement status of the payout transaction. See [Payout Transaction Statuses](/guides/pay-out-status-referencepayout-transaction-statuses) for a full refe…
AvsResponseText
string
Text code describing the result for address validation (applies only for card transactions).
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](…
PaymentDetail
object
Details about the payment.
8 properties
1 required
RemitEmail
string
Remittance email address. Used for sending virtual cards and other information about payouts.
IsSameDayACH
boolean
When true, this is a same-day ACH transaction.
VCardGetResponseAssociatedVendorBillingData
object
Billing data for the vendor.
14 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…
SplitFundingContent
object
4 properties
Remitaddress1
string
Remittance street address. Used for mailing paper checks. Required if any remittance address field is provided.
BankAccountHolderName
string
The accountholder's name.
CityNullable
string
The city.
VCardGetResponseContact
object
Contact information structure.
4 properties
ReissuePayoutResponse
object
4 properties
4 required
SettlementStatusName
stringnull
Name of the settlement status.
Mcc
string
Business Merchant Category Code (MCC). [This resource](https://github.com/greggles/mcc-codes/blob/main/mcccodes.csv) lists MCC codes.
PaymentIdString
string
The unique transaction ID. This value is a string representation of a long integer.
OperationResult
object
2 properties
1 required
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…
Remitcity
string
Remittance address city. Used for mailing paper checks. Required if any remittance address field is provided.
Zip
string
ZIP code for address.
VendorPaymentMethodString
string
The vendor's preferred payment method. Can be one of: - managed — Managed payment method - vcard — Virtual card payment method - check — Check payment method -…
SplitFunding
array
Split funding instructions for the transaction. The total amount of the splits must match the total amount of the transaction.
SendVCardLinkRequest
object
1 property
1 required
Vendorid
integer
Payabli identifier for vendor record.
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](…
PayabliApiResponse0000
object
The response for canceling a single payout transaction.
5 properties
1 required
RequestOutAuthorizeVendorBillingData
object
Object containing vendor's bank information. This object is deprecated for this endpoint. Use the paymentMethod object in payout authorize requests instead.
5 properties
AuthCapturePayoutResponseData
object
9 properties
9 required
Contacts
object
5 properties
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…
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.
QueryTransactionEvents
object
3 properties
Accounttype
string
Bank account type or card brand.
Authcode
string
Authorization code for the transaction.
IsSuccess
boolean
Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.
CaptureAllOutResponseResponseDataItem
object
5 properties
Dbaname
string
The alternate or common name that this business is doing business under, usually referred to as a DBA name.
Ein
string
Business EIN or tax ID. This value is masked in API responses.
VendorPaymentMethod
object
Payment method object to use for the payout. - { method: "managed" } - Managed payment method - { method: "vcard" } - Virtual card payment method - { method: "…
2 properties
1 required
FeeAmount
number
Service fee or sub-charge applied.
Subdomain
string
Refers to the payment page identifier. If provided, then the transaction is linked to the payment page.
ResponseText
string
Response text for operation: 'Success' or 'Declined'.
LotNumber
string
Lot number associated with the bill.
Referenceidtrans
string
The transaction identifier in Payabli.
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.
VendorNumber
string
Custom number identifying the vendor. Must be unique in paypoint. Can't be blank.
Initiator
string
The transaction's initiator. Indicates who initiated the transaction.
ReissuePayoutResponseData
object
3 properties
2 required
RequestOutAuthorizeInvoiceData
object
13 properties
EnrollmentStatus
string
Enrollment status of vendor in payables program.
RequestOutAuthorizeVendorData
object
Object containing vendor data.
32 properties
VendorName2
string
Secondary name for vendor. If provided, allowed characters are the same as the name1 field.
RiskActionCode
integer
Numeric code representing the risk action.
BankName
string
Name of bank for account.
Terms
string
Payment terms for invoice. If no terms are defined, then response data for this field defaults to NET30.
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…
AuthCapturePayoutResponse
object
6 properties
6 required
Vendoridtrans
integer
Payabli-generated unique ID of the vendor on the payout. Returns the same value as the response's customerId/CustomerId field, or 0 when no vendor is associate…
Discount
number
Discount applied to the invoice.
PayabliApiResponse00Responsedatanonobject
object
6 properties
1 required
AccountNumber
string
Account number for bank account. This value is returned masked in responses.
FileContentFtype
string
The MIME type of the file (if content is provided).
Entry
string
The entity's entrypoint identifier. [Learn more](/developers/api-reference/api-overviewentrypoint-vs-entry).
Responsecode
integer
Code for the response. Learn more in [API Response Codes](/developers/api-reference/api-responses).
CaptureAllOutResponse
object
5 properties
1 required
ContactsResponse
object
4 properties
RenewVCardResponse
object
3 properties
3 required
Comments
string
Any comment or description.
InternalReferenceId
integer
An internal reference ID.
RoomIdNotInUse
integer
Field not in use on this endpoint. It always returns 0.
AddressAddtlNullable
string
Additional line for the address.
VendorName1
string
Primary name for vendor. Required for new vendor.
BillId
integer
The bill's ID in Payabli. This value is automatically generated by Payabli when the bill is created.
AchHolderType
string
The bank's accountholder type: personal or business.
BillDetailResponse
object
41 properties
AdditionalDataString
string
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: json { "additionalData"…
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…
Responsedatanonobject
The response data.
AutoCapture
boolean
When true, Payabli captures the transaction asynchronously after a successful authorization. The authorization request returns once the transaction is authoriz…
TypeAccount
string
Type of bank account: Checking or Savings.
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).
ScheduleId
integer
ID of the recurring payment schedule associated with the transaction.
LastModified
string
Timestamp of when record was last updated, in UTC.
OrderId
string
Custom identifier for the transaction.
Remitaddress2
string
Remittance address additional line, such as a suite or unit number. Used for mailing paper checks. Always optional.
VCardGetResponseAssociatedVendor
object
Information about the associated vendor.
44 properties
VendorEin
string
EIN/Tax ID for vendor. Must be nine digits formatted as XX-XXXXXXX (for example, 12-3456789).
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Payabli publishes across the network.