API Basics
Pay In Endpoints
- MoneyIn
- Subscription
- TokenStorage
- Invoice
- LineItem
- PaymentLink
- PaymentMethodDomain
- HostedPaymentPages
- Cloud
- Wallet: Apple Pay
Pay Out Endpoints
Pay Ops Endpoints
- Templates
- Boarding
- Chargebacks and ACH Returns
- Entities
- Notification
- Query
- Statistic
- Export
- Import
Object Models
- Object Model References
Get Details for Payout Transaction
Returns details for a processed money out transaction.
{
"IdOut": 350,
"CreatedAt": "2023-04-24T09:17:49.063",
"Comments": "testing",
"Vendor": {
"VendorNumber": "54321",
"Name1": "Paul's",
"Name2": "Supplies",
"EIN": "123456789",
"Phone": 9706188888,
"Email": "paul@payabli.com",
"Address1": "5724 Walnut Street",
"Address2": "",
"City": "Lakeland",
"State": "FL",
"Zip": "33809",
"Country": "US",
"Mcc": "",
"LocationCode": null,
"Contacts": null,
"BillingData": {
"id": null,
"bankName": "Chase",
"routingAccount": "02100XXX",
"accountNumber": "3XXXXXX8888",
"typeAccount": "Checking",
"bankAccountHolderName": null,
"bankAccountHolderType": null,
"bankAccountFunction": 0
},
"PaymentMethod": "",
"VendorStatus": 1,
"VendorId": 89,
"EnrollmentStatus": null,
"Summary": null,
"PaypointLegalname": null,
"PaypointDbaname": null,
"PaypointEntryname": null,
"ParentOrgName": null,
"CreatedDate": "2023-03-13T16:36:20",
"LastUpdated": "2023-03-29T21:51:49",
"remitAddress1": "",
"remitAddress2": "",
"remitCity": "",
"remitState": "",
"remitZip": "",
"remitCountry": "",
"payeeName1": null,
"payeeName2": null,
"customField1": "",
"customField2": "",
"customerVendorAccount": "",
"InternalReferenceId": 3,
"additionalData": null,
"externalPaypointID": null
},
"PaypointDbaname": "The Board Haus",
"PaypointLegalname": "Board Haus LLC.",
"Status": 11,
"Gateway": "TSYS",
"StatusText": "Captured",
"LastUpdated": "2023-04-23T17:00:00",
"TotalAmount": 8800,
"NetAmount": 8800,
"FeeAmount": 0,
"Source": "api",
"ParentOrgName": "PayabliDemoAccount(PB)",
"BatchNumber": null,
"PaymentStatus": "Authorized",
"PaymentMethod": "managed",
"CardToken": null,
"CheckNumber": null,
"CheckData": null,
"PaymentId": "187-350",
"PaymentData": {
"MaskedAccount": "",
"AccountType": "",
"AccountExp": null,
"AccountZip": null,
"HolderName": "",
"StoredId": null,
"orderDescription": null,
"cloudSignatureData": null,
"cloudSignatureFormat": null,
"paymentDetails": null,
"payorData": null,
"accountId": null,
"bankAccount": null,
"gatewayConnector": {
"configuration": null,
"Name": "repay",
"Descriptor": null,
"Mode": 2,
"gatewayID": 391,
"Enabled": true
}
},
"Bills": [
{
"billId": null,
"LotNumber": null,
"AccountingField1": null,
"AccountingField2": null,
"Terms": null,
"AdditionalData": null,
"invoiceNumber": null,
"netAmount": "8800.00",
"invoiceDate": null,
"dueDate": null,
"comments": null
}
],
"Events": [
{
"TransEvent": "Authorized",
"EventData": null,
"EventTime": "2023-04-24T09:17:49.073"
}
],
"externalPaypointID": ""
}
Authorizations
Most endpoints require an organization
token. Some endpoints require an application
token, and those endpoints are noted.
Path Parameters
ReferenceId for the transaction (PaymentId).
Response
Events associated to this transaction.
Optional custom field.
Optional custom field.
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"
}
}
Bill image attachment. Send the bill image as Base64-encoded string, or as a publicly-accessible link. For full details on using this field with a payout authorization, see the documentation.
Content of file, Base64-encoded Ignored if furl is specified. Max upload size is 30 MB.
The name of the attached file.
The MIME type of the file (if content is provided)
pdf
, doc
, docx
, jpg
, jpeg
, png
, gif
, txt
Optional url provided to show or download the file remotely
Bill ID in Payabli.
Any comments about bill. For managed payouts, this field has a limit of 100 characters.
250
Bill due date in format YYYY-MM-DD or MM/DD/YYYY.
Bill date in format YYYY-MM-DD or MM/DD/YYYY.
Custom number identifying the bill. Must be unique in paypoint. Required for new bill and when billId
is not provided.
250
Net Amount owed in bill. Required when adding a bill.
Description of payment terms.
Object referencing to paper check image.
Content of file, Base64-encoded Ignored if furl is specified. Max upload size is 30 MB.
The name of the attached file.
The MIME type of the file (if content is provided)
pdf
, doc
, docx
, jpg
, jpeg
, png
, gif
, txt
Optional url provided to show or download the file remotely
Paper check number related to payout transaction.
Any comment or description for payout transaction.
250
Timestamp when the payment was created, in UTC.
Events associated to this transaction.
Any data associated to the event received from processor. Contents vary by event type.
Date and time of event.
Event descriptor. See TransEvent Reference for more details.
Service fee or sub-charge applied.
Gateway used to process the transaction.
Identifier of payout transaction.
Timestamp when payment record was updated, in UTC.
Net amount.
The name of the parent organization.
Expiration date of card used in transaction.
Custom identifier for payment connector.
250
Bank account type or card brand.
ZIP code for card used in transaction.
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 card brand. For example, Visa, MasterCard, American Express, Discover.
The category of the card, which indicates the card product. For example: Standard, Gold, Platinum, etc. The binCardCategory for prepaid cards is marked PREPAID
.
The name of the financial institution that issued the card.
The issuing financial institution's country name.
The issuing financial institution's two-character ISO country code. See this resource for a list of codes.
The issuing financial institution's ISO standard numeric country code. See this resource for a list of codes.
The type of card: Credit or Debit.
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.
Account holder name for the method.
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.
Masked card or bank account used in transaction. In the case of Apple Pay, this is a masked DPAN (device primary account number).
Text description of the transaction.
250
Details about the payment.
Total amount to be charged. If a service fee is sent, then this amount should include the service fee."
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.
Price/cost per unit of item or category.
Name of item or category.
Description of item or category
Quatity of item or category
Object containing image of paper check.
A check number to be used in the ach transaction. Required for payment method = 'check'.
Currency code ISO-4217. If not code is provided the currency in the paypoint setting is taken. Default is USD.
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.
Split funding instructions for the transaction. See Split a Transaction for more.
The accountId for the account the split should be sent to.
Amount from the transaction to sent to this recipient.
A description for the split.
The entrypoint the split should be sent to.
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.
Identifier of stored payment method used in transaction.
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.
Unique identifier for group or batch containing the transaction.
Unique transaction ID.
Method of payment applied to the transaction.
Status of payout transaction.
The alternate or common name that this business is doing business under usually referred to as a DBA name.
Paypoint legal name.
Custom identifier to indicate the transaction or request source.
100
Internal status of transaction.
Status of payout transaction.
Transaction total amount (including service fee or sub-charge).
Vendor related to the payout transaction.
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"
}
}
Vendor's address.
Additional line for vendor's address.
Masked account number for bank account.
Describes whether the bank account is used for deposits or withdrawals in Payabli:
0
: Deposit1
: Withdrawal2
: Deposit and withdrawal
The accountholder's name.
Describes whether the bank is a personal or business account.
Personal
, Business
Name of bank for account.
The bank's ID in Payabli.
Routing number of bank account.
Type of bank account: Checking or Savings.
Checking
, Savings
Vendor's city.
Vendor's country.
Timestamp of when record was created, in UTC.
Account number of paypoint in the vendor system.
Business EIN or tax ID.
Vendor's email address.
Enrollment status of vendor in payables program.
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.
Internal identifier for global vendor account.
Timestamp of when record was last updated, in UTC.
Additional location code used to identify the vendor.
Business Merchant Category Code (MCC). This resource lists MCC codes.
Primary name for vendor.
Secondary name for vendor.
The name of the parent organization.
Alternative name used to receive paper check.
Alternative name used to receive paper check.
Object containing details about the payment method to use for the payout.
Payment method to use for payout. Leave empty for managed payables.
managed
, vcard
, ach
, check
The alternate or common name that this business is doing business under usually referred to as a DBA name.
The entrypoint identifier.
50
Business legal name.
Vendor's phone number.
Remittance address. Used for mailing paper checks.
Remittance address additional line. Used for mailing paper checks.
Remittance address city. Used for mailing paper checks.
Remittance address country. Used for mailing paper checks.
Remittance address state. Used for mailing paper checks.
Remittance address ZIP code. Used for mailing paper checks.
Vendor's state.
Payabli identifier for vendor record.
Custom number identifying the vendor. Must be unique in paypoint.
Vendor's status. Allowed status:
-
0 Inactive
-
1 Active
Vendor's zip code.
Was this page helpful?
{
"IdOut": 350,
"CreatedAt": "2023-04-24T09:17:49.063",
"Comments": "testing",
"Vendor": {
"VendorNumber": "54321",
"Name1": "Paul's",
"Name2": "Supplies",
"EIN": "123456789",
"Phone": 9706188888,
"Email": "paul@payabli.com",
"Address1": "5724 Walnut Street",
"Address2": "",
"City": "Lakeland",
"State": "FL",
"Zip": "33809",
"Country": "US",
"Mcc": "",
"LocationCode": null,
"Contacts": null,
"BillingData": {
"id": null,
"bankName": "Chase",
"routingAccount": "02100XXX",
"accountNumber": "3XXXXXX8888",
"typeAccount": "Checking",
"bankAccountHolderName": null,
"bankAccountHolderType": null,
"bankAccountFunction": 0
},
"PaymentMethod": "",
"VendorStatus": 1,
"VendorId": 89,
"EnrollmentStatus": null,
"Summary": null,
"PaypointLegalname": null,
"PaypointDbaname": null,
"PaypointEntryname": null,
"ParentOrgName": null,
"CreatedDate": "2023-03-13T16:36:20",
"LastUpdated": "2023-03-29T21:51:49",
"remitAddress1": "",
"remitAddress2": "",
"remitCity": "",
"remitState": "",
"remitZip": "",
"remitCountry": "",
"payeeName1": null,
"payeeName2": null,
"customField1": "",
"customField2": "",
"customerVendorAccount": "",
"InternalReferenceId": 3,
"additionalData": null,
"externalPaypointID": null
},
"PaypointDbaname": "The Board Haus",
"PaypointLegalname": "Board Haus LLC.",
"Status": 11,
"Gateway": "TSYS",
"StatusText": "Captured",
"LastUpdated": "2023-04-23T17:00:00",
"TotalAmount": 8800,
"NetAmount": 8800,
"FeeAmount": 0,
"Source": "api",
"ParentOrgName": "PayabliDemoAccount(PB)",
"BatchNumber": null,
"PaymentStatus": "Authorized",
"PaymentMethod": "managed",
"CardToken": null,
"CheckNumber": null,
"CheckData": null,
"PaymentId": "187-350",
"PaymentData": {
"MaskedAccount": "",
"AccountType": "",
"AccountExp": null,
"AccountZip": null,
"HolderName": "",
"StoredId": null,
"orderDescription": null,
"cloudSignatureData": null,
"cloudSignatureFormat": null,
"paymentDetails": null,
"payorData": null,
"accountId": null,
"bankAccount": null,
"gatewayConnector": {
"configuration": null,
"Name": "repay",
"Descriptor": null,
"Mode": 2,
"gatewayID": 391,
"Enabled": true
}
},
"Bills": [
{
"billId": null,
"LotNumber": null,
"AccountingField1": null,
"AccountingField2": null,
"Terms": null,
"AdditionalData": null,
"invoiceNumber": null,
"netAmount": "8800.00",
"invoiceDate": null,
"dueDate": null,
"comments": null
}
],
"Events": [
{
"TransEvent": "Authorized",
"EventData": null,
"EventTime": "2023-04-24T09:17:49.073"
}
],
"externalPaypointID": ""
}