Pay OutPayouts

Audit payout transactions

Learn how to use the Payabli API to track and audit payout transactions

Applies to:Developers

Payabli’s Pay Out functionality allows you to send and monetize payments to your vendors. This guide aims to help you track and audit payout transactions so you can build seamless integrations with your app.

Query the payout

First, query the payout details endpoint: /MoneyOut/details/{transId}. You need the response data from this request to audit the payout.

1  {
2      "IdOut": 3089,
3      "CreatedAt": "2024-03-07T18:15:57.34",
4      "Comments": "Test payout",
5      "Vendor": {
6          "VendorNumber": "QA-vendor-1709853355",
7          "Name1": "Lakeland",
8          "Name2": "Electric",
9          "EIN": "XXXX6789",
10          "Phone": "8636700248",
11          "Email": "philaret@philsfloors.com",
12          "Address1": "123 Krill Street",
13          "Address2": null,
14          "City": "Lakeland",
15          "State": "FL",
16          "Zip": "33809",
17          "Country": "US",
18          "Mcc": null,
19          "LocationCode": null,
20          "Contacts": null,
21          "BillingData": null,
22          "PaymentMethod": "check",
23          "VendorStatus": 1,
24          "VendorId": 3412,
25          "EnrollmentStatus": null,
26          "Summary": null,
27          "PaypointLegalname": null,
28          "PaypointDbaname": null,
29          "PaypointEntryname": null,
30          "ParentOrgName": null,
31          "CreatedDate": "2024-03-07T18:15:57.057",
32          "LastUpdated": "2024-03-07T23:15:57.057",
33          "remitAddress1": null,
34          "remitAddress2": null,
35          "remitCity": null,
36          "remitState": null,
37          "remitZip": null,
38          "remitCountry": null,
39          "payeeName1": null,
40          "payeeName2": null,
41          "customField1": null,
42          "customField2": null,
43          "customerVendorAccount": "testingAccount1",
44          "InternalReferenceId": 1222,
45          "additionalData": null,
46          "externalPaypointID": null
47      },
48      "PaypointDbaname": "Gruzya Adventure Outfitters",
49      "PaypointLegalname": "Gruzya Adventure Outfitters",
50      "Status": 2,
51      "LastUpdated": "2024-03-07T19:00:00",
52      "TotalAmount": 1000.50,
53      "NetAmount": 1000.50,
54      "FeeAmount": 0.00,
55      "Source": "api",
56      "ParentOrgName": "Pilgrim Planner",
57      "BatchNumber": "10-20240308-CUST123",
58      "PaymentStatus": "Pending",
59      "PaymentMethod": null,
60      "CardToken": null,
61      "CheckNumber": "656768",
62      "CheckData": null,
63      "PaymentId": "10-3089",
64      "PaymentData": {
65          "MaskedAccount": "",
66          "AccountType": "",
67          "AccountExp": null,
68          "AccountZip": null,
69          "HolderName": "",
70          "StoredId": null,
71          "orderDescription": null,
72          "cloudSignatureData": null,
73          "cloudSignatureFormat": null,
74          "paymentDetails": {
75              "totalAmount": 1000.0,
76              "serviceFee": 0.0,
77              "checkNumber": null,
78              "checkImage": null,
79              "currency": null,
80              "orderDescription": null,
81              "orderId": null,
82              "orderIdAlternative": null,
83              "paymentDescription": null,
84              "groupNumber": null,
85              "source": null,
86              "categories": [],
87              "splitFunding": []
88          },
89          "payorData": {
90              "customerId": 0,
91              "firstName": null,
92              "lastName": null,
93              "company": null,
94              "customerNumber": null,
95              "billingAddress1": null,
96              "billingAddress2": null,
97              "billingCity": null,
98              "billingState": null,
99              "billingZip": null,
100              "billingCountry": null,
101              "billingPhone": null,
102              "billingEmail": null,
103              "shippingAddress1": null,
104              "shippingAddress2": null,
105              "shippingCity": null,
106              "shippingState": null,
107              "shippingZip": null,
108              "shippingCountry": null,
109              "additionalData": {},
110              "identifierFields": null
111          },
112          "accountId": null,
113          "bankAccount": null,
114          "gatewayConnector": {
115              "configuration": null,
116              "Name": "repay",
117              "Mode": 2,
118              "Bank": null,
119              "Descriptor": null,
120              "gatewayID": 7,
121              "Enabled": true,
122              "EnableACHValidation": false,
123              "TestMode": true
124          },
125          "binData": null
126      },
127      "Bills": [
128          {
129              "billId": 5999,
130              "LotNumber": "1709853355",
131              "AccountingField1": null,
132              "AccountingField2": null,
133              "Terms": null,
134              "AdditionalData": null,
135              "attachments": null,
136              "invoiceNumber": "QA-1709853355",
137              "netAmount": "1000.50",
138              "invoiceDate": "2023-06-06",
139              "dueDate": "2023-06-06",
140              "comments": "Floor refinish"
141          }
142      ],
143      "Events": [
144          {
145              "TransEvent": "Authorized",
146              "EventData": null,
147              "EventTime": "2024-03-07T18:15:57.47"
148          },
149          {
150              "TransEvent": "Captured",
151              "EventData": {
152                  "id": "f4b9e2f4-957a-49c0-bb24-4a869929bfe9",
153                  "group": {
154                      "id": "e711b011-bbaf-4241-9681-6e628d00e0eb",
155                      "name": "10-20240307-CUST123-3089",
156                      "status": "Waiting Funds",
157                      "approved": false,
158                      "totalAmount": "1000.50",
159                      "custId": "CUST123",
160                      "dateCreated": "2024-03-07T23:17:48Z",
161                      "dateModified": "2024-03-07T23:17:48Z",
162                      "links": []
163                  },
164                  "custId": "CUST123",
165                  "paymentNumber": "10-3089",
166                  "vendor": {
167                      "id": "83e31970-25f2-4bb3-baaa-0e5ef63f1051",
168                      "custId": "CUST123",
169                      "vendorNumber": "QA-vendor-1709853355",
170                      "vendorTaxId": "123456787",
171                      "vendorName1": "LAKELAND",
172                      "vendorPhone": "18636700248",
173                      "status": "Pending",
174                      "paymentType": "Check",
175                      "contactEmail": "philaret@philsfloors.com",
176                      "statusReason": "Payment Waiting",
177                      "address": {
178                          "address1": "123 Krill Street",
179                          "city": "LAKELAND",
180                          "state": "FL",
181                          "zip": "33809",
182                          "countryCode": "US"
183                      },
184                      "customerVendorAccountNumber": "testingAccount1",
185                      "dateCreated": "2024-03-07T23:17:48Z",
186                      "dateModified": "2024-03-07T23:17:48Z",
187                      "links": []
188                  },
189                  "remitAddress": {
190                      "address1": "123 Krill Street",
191                      "city": "Lakeland",
192                      "state": "FL",
193                      "zip": "33809",
194                      "countryCode": "US"
195                  },
196                  "links": [],
197                  "invoices": [
198                      {
199                          "netAmount": "1000.50",
200                          "dueDate": "2023-06-06",
201                          "invoiceDate": "2023-06-06",
202                          "comments": "testingAccount1-string"
203                      }
204                  ],
205                  "paymentStatus": "Awaiting Funds",
206                  "paymentType": "Pending",
207                  "dateCreated": "2024-03-07T23:17:48Z",
208                  "dateModified": "2024-03-07T23:17:48Z"
209              },
210              "EventTime": "2024-03-07T18:17:48.503"
211          },
212          {
213              "TransEvent": "Cancelled",
214              "EventData": {
215                  "Ip": "35.145.190.199"
216              },
217              "EventTime": "2024-03-07T22:30:27.02"
218          },
219          {
220              "TransEvent": "Closed Batch",
221              "EventData": {
222                  "id": "0d7489f2-2b4b-418a-88c0-1b0587c16eb9",
223                  "name": "10-20240308-CUST123",
224                  "status": "Waiting Funds",
225                  "approved": true,
226                  "totalAmount": "1512.50",
227                  "custId": "CUST123",
228                  "dateCreated": "2024-03-08T02:11:24Z",
229                  "dateModified": "2024-03-08T23:23:55Z",
230                  "links": []
231              },
232              "EventTime": "2024-03-08T18:24:00.747"
233          }
234      ],
235      "externalPaypointID": "f743aed24a-10",
236      "EntryName": "f743aed24a"
237  }

Understand the response

There are a few main areas of the response that are useful for understanding a payout transaction:

1

TransEvent and status

Events related to the transaction are described in the Events array, as TransEvent objects. There, you can find information about the payout’s current and historical statuses.

2

Payment method

You can use the PaymentMethod field in the vendor object to understand which method the vendor selected to be paid with.

3

Other information

You can get more information about the specific check or vCard issued in a payout. These details appear in a field associated with the method: CardToken,CheckNumber or CheckData.

The next few sections go over these topics in depth.

TransEvents and payout status

The response includes various TransEvent values within the Events array in the response. These TransEvents represent the stages and status of the payout transaction.

Here are some examples of events objects that you will see in the Events array.

1  {
2      "TransEvent": "Authorized",
3      "EventData": null,
4      "EventTime": "2024-03-07T18:15:57.47"
5  },

The TransEvents for payouts are listed in the following table.

TransEventDescriptionMaps To
AuthorizedA payout is authorized. These are queued payouts, and nothing happens with them until they’re captured.11 (Authorized)
CapturedA payout is captured and is now part of the batch for payout.1 (Captured)
Capture DeclinedAuthorized transaction capture failed.N/A
CancelledAn authorized payout has been cancelled. A captured payout can be cancelled before batch close at 5 PM ET.0 (Cancelled)
Cancel DeclinedTransaction cancellation failed.N/A
Closed BatchBatch closed.1 (Closed)
CreatedThe first event for a transaction, created automatically when a transaction is started.N/A
Waiting fundsA payout is being processed.2 (Processing)
FundedA payout is being processed.2 (Processing)
Pending (payment type is pending)A payout is being processed.2 (Processing)
Generating checkA payout is being processed.2 (Processing)
OpenACH sent, vCard issued, check generated but not yet cashed. A payment method is defined for the vendor, and the payout has been sent to the recipient, but hasn’t been redeemed.3 (Processed)
ProcessedPayment Type is no longer pending.3 (Processed)
ReissuedA payment method has been reissued.3 (Processed)
ReturnedPayment has been returned.3 (Processed)
ErroredThere was an error in processing the payment.3 (Processed)
PaidA payout has been paid and the recipient has redeemed the funds. The vCard has been used, the check has been cashed, or the ACH has settled.5 (Paid)

The TransEvent value provides insight into the current and historical stages of the payout process, helping you understand the transaction status.

Determining payment method

The PaymentMethod field in the Vendor object in the response shows the payment method selected by the vendor for the payout. Initially, this field may show “managed/pending,” and it changes as the payout is processed. The possible values for PaymentMethod are:

  • vCard
  • ach
  • check
1  // This example has been truncated to show the most relevant parts
2  {
3      "IdOut": 3089,
4      "CreatedAt": "2024-03-07T18:15:57.34",
5      "Comments": "Test payout",
6      "Vendor": {
7          "VendorNumber": "QA-vendor-1709853355",
8          "Name1": "Lakeland",
9          "Name2": "Electric",
10          "EIN": "XXXX6789",
11          ...
12          "BillingData": null,
13          "PaymentMethod": "ach",
14          ...
15      }
16          ...
17  }

Get more payout details

In certain cases, you may need to retrieve more details about the payout, such as the check information or vCard details. You can find details in the parameters associated with the payment method:

  • CardToken: The token for the vCard issued for the payout
  • CheckNumber: The check number for the paper check issued for the payout
  • CheckData: The check image Base64-encoded as fContent. Use a Base64 decoder to view the image
1  // Example truncated to show most relevant part
2
3{
4    "IdOut": 3089,
5    "CreatedAt": "2024-03-07T18:15:57.34",
6    "Comments": "Test payout",
7    "Vendor": {...},
8    ...
9    "CardToken": null,
10    "CheckNumber": "656768",
11    "CheckData": null,
12    "PaymentId": "10-3089",
13        ...
14}