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.
curl --request GET \
--url https://api-sandbox.payabli.com/api/MoneyOut/details/{transId} \
--header 'requestToken: <api-key>'
{
"IdOut": 350,
"CreatedAt": "2023-04-24T09:17:49.063",
"Comments": "testing",
"Vendor": {
"VendorNumber": "54321",
"Name1": "Paul's",
"Name2": "Supplies",
"EIN": "XXXX6789",
"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).
"45-as456777hhhhhhhhhh77777777-324"
Response
Identifier of payout transaction.
236
Vendor related to the payout transaction.
Custom number identifying the vendor. Must be unique in paypoint.
"1234"
Primary name for vendor.
"Herman's Coatings"
Secondary name for vendor.
"Herman's Coating Supply Company, LLC"
Business EIN or tax ID. This value is masked in API responses, for example XXXX6789
.
"123456789"
Vendor's phone number.
"212-555-1234"
Vendor's email address.
320
"example@email.com"
Vendor's address.
"123 Ocean Drive"
Additional line for vendor's address.
"Suite 400"
Vendor's city.
"Bristol"
Vendor's state.
"GA"
Vendor's zip code.
"31113"
Vendor's country.
"US"
Business Merchant Category Code (MCC). This resource lists MCC codes.
"7777"
Additional location code used to identify the vendor.
"LOC123"
List of contacts.
Contact name.
"Herman Martinez"
Contact email address.
320
"example@email.com"
Contact title.
"Owner"
Contact phone number.
"3055550000"
The bank's ID in Payabli.
Name of bank for account.
"Country Bank"
Routing number of bank account.
"123123123"
Masked account number for bank account.
"1XXXXXX3123"
Type of bank account: Checking or Savings.
Checking
, Savings
"Checking"
The accountholder's name.
"Gruzya Adventure Outfitters LLC"
Describes whether the bank is a personal or business account.
Personal
, Business
"Business"
Describes whether the bank account is used for deposits or withdrawals in Payabli:
0
: Deposit1
: Withdrawal2
: Deposit and withdrawal
0
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
Vendor's status. Allowed status:
-
0 Inactive
-
1 Active
1
Payabli identifier for vendor record.
"1340"
Enrollment status of vendor in payables program.
null
Business legal name.
"Sunshine Services, LLC"
The alternate or common name that this business is doing business under usually referred to as a DBA name.
"Sunshine Gutters"
The entrypoint identifier.
50
"d193cf9a46"
The name of the parent organization.
"PropertyManager Pro"
Timestamp of when record was created, in UTC.
"2022-07-01 15:00:01"
Timestamp of when record was last updated, in UTC.
"2022-07-01 15:00:01"
Remittance address. Used for mailing paper checks.
"123 Walnut Street"
Remittance address additional line. Used for mailing paper checks.
"Suite 900"
Remittance address city. Used for mailing paper checks.
"Miami"
Remittance address state. Used for mailing paper checks.
"FL"
Remittance address ZIP code. Used for mailing paper checks.
"31113"
Remittance address country. Used for mailing paper checks.
"US"
Alternative name used to receive paper check.
Alternative name used to receive paper check.
Account number of paypoint in the vendor system.
"123-456"
Internal identifier for global vendor account.
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"
}
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"
Any comment or description for payout transaction.
250
"Deposit for materials"
The name of the parent organization.
"PropertyManager Pro"
The alternate or common name that this business is doing business under usually referred to as a DBA name.
"Sunshine Gutters"
Paypoint legal name.
"Sunshine Services, LLC"
Transaction total amount (including service fee or sub-charge).
110.25
Net amount.
100
Service fee or sub-charge applied.
10.25
Custom identifier to indicate the transaction or request source.
100
"api"
Unique transaction ID.
"2345667-ddd-fff"
Unique identifier for group or batch containing the transaction.
"2345667-ddd-fff"
Internal status of transaction.
1
Gateway used to process the transaction.
"TSYS"
Status of payout transaction.
"Captured"
Status of payout transaction.
"Processed"
Paper check number related to payout transaction.
"12345"
Object referencing to paper check image.
The MIME type of the file (if content is provided)
pdf
, doc
, docx
, jpg
, jpeg
, png
, gif
, txt
"pdf"
The name of the attached file.
"my-doc.pdf"
Optional url provided to show or download the file remotely
"https://mysite.com/my-doc.pdf"
Content of file, Base64-encoded Ignored if furl is specified. Max upload size is 30 MB.
"TXkgdGVzdCBmaWxlHJ==..."
Method of payment applied to the transaction.
"ach"
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
Events associated to this transaction.
Custom number identifying the bill. Must be unique in paypoint. Required for new bill and when billId
is not provided.
250
"INV-2345"
Net Amount owed in bill. Required when adding a bill.
3762.87
Bill date in format YYYY-MM-DD or MM/DD/YYYY.
"2024-07-01"
Bill due date in format YYYY-MM-DD or MM/DD/YYYY.
"2024-07-01"
Any comments about bill. For managed payouts, this field has a limit of 100 characters.
250
"Deposit for materials"
Optional custom field.
"MyInternalId"
Optional custom field.
"MyInternalId"
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"
}
Description of payment terms.
"NET30"
Bill ID in Payabli.
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.
Contains details about a file. See See fileObject Object Model for a complete reference. Max upload size is 30 MB.
The MIME type of the file (if content is provided)
pdf
, doc
, docx
, jpg
, jpeg
, png
, gif
, txt
"pdf"
The name of the attached file.
"my-doc.pdf"
Optional url provided to show or download the file remotely
"https://mysite.com/my-doc.pdf"
Content of file, Base64-encoded Ignored if furl is specified. Max upload size is 30 MB.
"TXkgdGVzdCBmaWxlHJ==..."
Events associated to this transaction.
Event descriptor. See TransEvent Reference for more details.
"Approved"
Any data associated to the event received from processor. Contents vary by event type.
Date and time of event.
Timestamp when the payment was created, in UTC.
"2022-07-01 15:00:01"
Timestamp when payment record was updated, in UTC.
"2022-07-01 15:00:01"
Was this page helpful?
curl --request GET \
--url https://api-sandbox.payabli.com/api/MoneyOut/details/{transId} \
--header 'requestToken: <api-key>'
{
"IdOut": 350,
"CreatedAt": "2023-04-24T09:17:49.063",
"Comments": "testing",
"Vendor": {
"VendorNumber": "54321",
"Name1": "Paul's",
"Name2": "Supplies",
"EIN": "XXXX6789",
"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": ""
}