For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inBook a demo
HomeGuidesAPI ReferenceGlossary
HomeGuidesAPI ReferenceGlossary
  • API Reference
      • POSTCounterparty Added
      • POSTCounterparty Hidden
      • POSTCounterparty Onboarding Completed
      • POSTEntity Created
      • POSTEntity Updated
      • POSTEntity Status Changed
      • POSTEntity Metadata Updated
      • POSTPayment Method Created
      • POSTPayment Method Updated
      • POSTPayment Method Deleted
      • POSTInvoice Created
      • POSTInvoice Updated
      • POSTInvoice Deleted
      • POSTInvoice Status Changed
      • POSTIncoming Invoice Email
      • POSTInvoice Status Draft
      • POSTInvoice Status New
      • POSTInvoice Status Approved
      • POSTInvoice Status Refused
      • POSTInvoice Status Scheduled
      • POSTInvoice Status Pending
      • POSTInvoice Status Canceled
      • POSTInvoice Status Paid
      • POSTInvoice Status Failed
      • POSTInvoice Status Archived
      • POSTTransaction Created
      • POSTTransaction Pending
      • POSTTransaction Completed
      • POSTTransaction Failed
      • POSTTransaction Returned
      • POSTBulk Invoices Created
      • POSTBulk Invoices Updated
      • POSTBulk Invoices Approved
      • POSTBulk Entities Created
      • POSTInvoice Collection Event - Overdue Invoice
      • POSTInvoice Collection Event - Email Sent
      • POSTInvoice Collection Event - Email Received
      • POSTOCR Job Completed
      • POSTPayment Gateway Validation Job Completed
      • POSTPayment Gateway Process Job Completed
Logo
Sign inBook a demo
API ReferenceWebhooks

Transaction Failed

Payload
1{
2  "eventType": "transaction.failed",
3  "transaction": {
4    "type": "bankAccountToBankAccount",
5    "amount": 10000,
6    "createdAt": "2024-01-01T00:00:00Z",
7    "currency": "USD",
8    "id": "trx_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4",
9    "invoices": [
10      {
11        "approvalPolicy": [],
12        "approvers": [],
13        "createdAt": "2021-01-01T00:00:00Z",
14        "hasDocuments": true,
15        "hasSourceEmail": true,
16        "id": "in_26e7b5d3-a739-4b23-9ad9-6aaa085f47a9",
17        "metadata": {},
18        "paymentDestinationConfirmed": true,
19        "status": "FAILED",
20        "updatedAt": "2021-01-01T00:00:00Z",
21        "amount": 100,
22        "currency": "USD",
23        "deductionDate": "2021-01-29T00:00:00Z",
24        "dueDate": "2021-01-31T00:00:00Z",
25        "invoiceDate": "2021-01-01T00:00:00Z",
26        "invoiceNumber": "INV-123",
27        "payer": {
28          "acceptedTos": true,
29          "accountType": "business",
30          "createdAt": "2024-01-01T00:00:00Z",
31          "email": "customer@acme.com",
32          "id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
33          "isCustomer": true,
34          "isNetworkPayee": false,
35          "isNetworkPayor": false,
36          "isPayee": false,
37          "isPayor": true,
38          "name": "Acme Inc.",
39          "profile": {
40            "business": {
41              "legalBusinessName": "Acme Inc.",
42              "taxIDProvided": true,
43              "email": "customer@acme.com",
44              "businessType": "llc",
45              "phone": {
46                "countryCode": "1",
47                "number": "4155551234"
48              },
49              "address": {
50                "addressLine1": "123 Main St",
51                "city": "San Francisco",
52                "stateOrProvince": "CA",
53                "postalCode": "94105",
54                "addressLine2": "Unit 1",
55                "country": "US"
56              },
57              "ownersProvided": true,
58              "taxId": {
59                "ein": {
60                  "number": "12-3456789"
61                }
62              }
63            }
64          },
65          "status": "verified",
66          "updatedAt": "2024-01-02T00:00:00Z",
67          "accounts": [
68            {
69              "accountId": "85866843",
70              "postalCode": "94105",
71              "nameOnAccount": "John Doe"
72            }
73          ],
74          "counterpartyType": [
75            "ENTITY"
76          ],
77          "foreignId": "MY-DB-ID-12345",
78          "paymentMethods": [
79            {
80              "type": "bankAccount",
81              "accountName": "My Checking Account",
82              "accountNumber": "99988767623",
83              "accountType": "CHECKING",
84              "bankName": "Chase",
85              "createdAt": "2021-01-01T00:00:00Z",
86              "frozen": false,
87              "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
88              "isDefaultDestination": true,
89              "isDefaultSource": true,
90              "metadata": {},
91              "routingNumber": "12345678",
92              "status": "VERIFIED",
93              "supportedCurrencies": [
94                "USD"
95              ],
96              "updatedAt": "2021-01-01T00:00:00Z",
97              "confirmedByEntity": true
98            }
99          ]
100        },
101        "payerId": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
102        "paymentDestination": {
103          "type": "check",
104          "addressLine1": "123 Main St",
105          "city": "New York",
106          "country": "US",
107          "createdAt": "2021-01-01T00:00:00Z",
108          "frozen": false,
109          "id": "pm_5fde2f4a-facc-48ef-8f0d-6b7d087c7b18",
110          "isDefaultDestination": true,
111          "isDefaultSource": false,
112          "metadata": {},
113          "payToTheOrderOf": "John Doe",
114          "postalCode": "10001",
115          "stateOrProvince": "NY",
116          "supportedCurrencies": [
117            "USD"
118          ],
119          "updatedAt": "2021-01-01T00:00:00Z",
120          "addressLine2": "Apt 1",
121          "confirmedByEntity": true
122        },
123        "paymentDestinationId": "pm_5fde2f4a-facc-48ef-8f0d-6b7d087c7b18",
124        "paymentSource": {
125          "type": "bankAccount",
126          "accountName": "My Checking Account",
127          "accountNumber": "99988767623",
128          "accountType": "CHECKING",
129          "bankName": "Chase",
130          "createdAt": "2021-01-01T00:00:00Z",
131          "frozen": false,
132          "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
133          "isDefaultDestination": true,
134          "isDefaultSource": true,
135          "metadata": {},
136          "routingNumber": "12345678",
137          "status": "VERIFIED",
138          "supportedCurrencies": [
139            "USD"
140          ],
141          "updatedAt": "2021-01-01T00:00:00Z",
142          "confirmedByEntity": true
143        },
144        "paymentSourceId": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
145        "transactions": [
146          {
147            "type": "bankAccountToBankAccount",
148            "amount": 10000,
149            "createdAt": "2024-01-01T00:00:00Z",
150            "currency": "USD",
151            "id": "trx_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4",
152            "payer": {
153              "acceptedTos": true,
154              "accountType": "business",
155              "createdAt": "2024-01-01T00:00:00Z",
156              "email": "customer@acme.com",
157              "id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
158              "isCustomer": true,
159              "isNetworkPayee": false,
160              "isNetworkPayor": false,
161              "isPayee": false,
162              "isPayor": true,
163              "name": "Acme Inc.",
164              "profile": {
165                "business": {
166                  "legalBusinessName": "Acme Inc.",
167                  "taxIDProvided": true,
168                  "email": "customer@acme.com",
169                  "businessType": "llc",
170                  "phone": {
171                    "countryCode": "1",
172                    "number": "4155551234"
173                  },
174                  "address": {
175                    "addressLine1": "123 Main St",
176                    "city": "San Francisco",
177                    "stateOrProvince": "CA",
178                    "postalCode": "94105",
179                    "addressLine2": "Unit 1",
180                    "country": "US"
181                  },
182                  "ownersProvided": true,
183                  "taxId": {
184                    "ein": {
185                      "number": "12-3456789"
186                    }
187                  }
188                }
189              },
190              "status": "verified",
191              "updatedAt": "2024-01-02T00:00:00Z",
192              "accounts": [
193                {
194                  "accountId": "85866843",
195                  "postalCode": "94105",
196                  "nameOnAccount": "John Doe"
197                }
198              ],
199              "counterpartyType": [
200                "ENTITY"
201              ],
202              "foreignId": "MY-DB-ID-12345",
203              "paymentMethods": [
204                {
205                  "type": "bankAccount",
206                  "accountName": "My Checking Account",
207                  "accountNumber": "99988767623",
208                  "accountType": "CHECKING",
209                  "bankName": "Chase",
210                  "createdAt": "2021-01-01T00:00:00Z",
211                  "frozen": false,
212                  "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
213                  "isDefaultDestination": true,
214                  "isDefaultSource": true,
215                  "metadata": {},
216                  "routingNumber": "12345678",
217                  "status": "VERIFIED",
218                  "supportedCurrencies": [
219                    "USD"
220                  ],
221                  "updatedAt": "2021-01-01T00:00:00Z",
222                  "confirmedByEntity": true
223                }
224              ]
225            },
226            "payerId": "ent_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4",
227            "paymentDestination": {
228              "type": "bankAccount",
229              "accountName": "My Checking Account",
230              "accountNumber": "99988767623",
231              "accountType": "CHECKING",
232              "bankName": "Chase",
233              "createdAt": "2021-01-01T00:00:00Z",
234              "frozen": false,
235              "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
236              "isDefaultDestination": true,
237              "isDefaultSource": true,
238              "metadata": {},
239              "routingNumber": "12345678",
240              "status": "VERIFIED",
241              "supportedCurrencies": [
242                "USD"
243              ],
244              "updatedAt": "2021-01-01T00:00:00Z",
245              "confirmedByEntity": true
246            },
247            "paymentDestinationId": "pm_65523ab0-043d-4706-b2b2-0b73fed92269",
248            "paymentSource": {
249              "type": "bankAccount",
250              "accountName": "My Checking Account",
251              "accountNumber": "99988767623",
252              "accountType": "CHECKING",
253              "bankName": "Chase",
254              "createdAt": "2021-01-01T00:00:00Z",
255              "frozen": false,
256              "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
257              "isDefaultDestination": true,
258              "isDefaultSource": true,
259              "metadata": {},
260              "routingNumber": "12345678",
261              "status": "VERIFIED",
262              "supportedCurrencies": [
263                "USD"
264              ],
265              "updatedAt": "2021-01-01T00:00:00Z",
266              "confirmedByEntity": true
267            },
268            "paymentSourceId": "pm_65523ab0-043d-4706-b2b2-0b73fed92269",
269            "status": "FAILED",
270            "updatedAt": "2024-01-01T00:00:00Z",
271            "vendor": {
272              "acceptedTos": false,
273              "accountType": "business",
274              "createdAt": "2024-01-01T00:00:00Z",
275              "email": "vendor@bigboxstore.com",
276              "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
277              "isCustomer": false,
278              "isNetworkPayee": false,
279              "isNetworkPayor": false,
280              "isPayee": true,
281              "isPayor": false,
282              "name": "Big Box Store",
283              "profile": {
284                "business": {
285                  "legalBusinessName": "Big Box Store",
286                  "taxIDProvided": false,
287                  "email": "vendor@bigboxstore.com",
288                  "businessType": "publicCorporation",
289                  "ownersProvided": false
290                }
291              },
292              "status": "unverified",
293              "updatedAt": "2024-01-02T00:00:00Z",
294              "counterpartyType": [
295                "ENTITY"
296              ],
297              "foreignId": "MY-DB-ID-90909",
298              "paymentMethods": [
299                {
300                  "type": "bankAccount",
301                  "accountName": "Vendor Checking Account",
302                  "accountNumber": "55934059697648",
303                  "accountType": "CHECKING",
304                  "bankName": "Chase",
305                  "createdAt": "2021-01-01T00:00:00Z",
306                  "frozen": false,
307                  "id": "pm_7610541f-4619-4033-8620-cfccfb811293",
308                  "isDefaultDestination": true,
309                  "isDefaultSource": true,
310                  "metadata": {},
311                  "routingNumber": "66554433",
312                  "status": "NEW",
313                  "supportedCurrencies": [
314                    "USD"
315                  ],
316                  "updatedAt": "2021-01-01T00:00:00Z",
317                  "confirmedByEntity": false
318                }
319              ]
320            },
321            "vendorId": "ent_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4"
322          }
323        ],
324        "vendor": {
325          "acceptedTos": false,
326          "accountType": "business",
327          "createdAt": "2024-01-01T00:00:00Z",
328          "email": "vendor@bigboxstore.com",
329          "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
330          "isCustomer": false,
331          "isNetworkPayee": false,
332          "isNetworkPayor": false,
333          "isPayee": true,
334          "isPayor": false,
335          "name": "Big Box Store",
336          "profile": {
337            "business": {
338              "legalBusinessName": "Big Box Store",
339              "taxIDProvided": false,
340              "email": "vendor@bigboxstore.com",
341              "businessType": "publicCorporation",
342              "ownersProvided": false
343            }
344          },
345          "status": "unverified",
346          "updatedAt": "2024-01-02T00:00:00Z",
347          "counterpartyType": [
348            "ENTITY"
349          ],
350          "foreignId": "MY-DB-ID-90909",
351          "paymentMethods": [
352            {
353              "type": "bankAccount",
354              "accountName": "Vendor Checking Account",
355              "accountNumber": "55934059697648",
356              "accountType": "CHECKING",
357              "bankName": "Chase",
358              "createdAt": "2021-01-01T00:00:00Z",
359              "frozen": false,
360              "id": "pm_7610541f-4619-4033-8620-cfccfb811293",
361              "isDefaultDestination": true,
362              "isDefaultSource": true,
363              "metadata": {},
364              "routingNumber": "66554433",
365              "status": "NEW",
366              "supportedCurrencies": [
367                "USD"
368              ],
369              "updatedAt": "2021-01-01T00:00:00Z",
370              "confirmedByEntity": false
371            }
372          ]
373        },
374        "vendorId": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d"
375      }
376    ],
377    "payer": {
378      "acceptedTos": true,
379      "accountType": "business",
380      "createdAt": "2024-01-01T00:00:00Z",
381      "email": "customer@acme.com",
382      "id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
383      "isCustomer": true,
384      "isNetworkPayee": false,
385      "isNetworkPayor": false,
386      "isPayee": false,
387      "isPayor": true,
388      "name": "Acme Inc.",
389      "profile": {
390        "business": {
391          "legalBusinessName": "Acme Inc.",
392          "taxIDProvided": true,
393          "email": "customer@acme.com",
394          "businessType": "llc",
395          "phone": {
396            "countryCode": "1",
397            "number": "4155551234"
398          },
399          "address": {
400            "addressLine1": "123 Main St",
401            "city": "San Francisco",
402            "stateOrProvince": "CA",
403            "postalCode": "94105",
404            "addressLine2": "Unit 1",
405            "country": "US"
406          },
407          "ownersProvided": true,
408          "taxId": {
409            "ein": {
410              "number": "12-3456789"
411            }
412          }
413        }
414      },
415      "status": "verified",
416      "updatedAt": "2024-01-02T00:00:00Z",
417      "accounts": [
418        {
419          "accountId": "85866843",
420          "postalCode": "94105",
421          "nameOnAccount": "John Doe"
422        }
423      ],
424      "counterpartyType": [
425        "ENTITY"
426      ],
427      "foreignId": "MY-DB-ID-12345",
428      "paymentMethods": [
429        {
430          "type": "bankAccount",
431          "accountName": "My Checking Account",
432          "accountNumber": "99988767623",
433          "accountType": "CHECKING",
434          "bankName": "Chase",
435          "createdAt": "2021-01-01T00:00:00Z",
436          "frozen": false,
437          "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
438          "isDefaultDestination": true,
439          "isDefaultSource": true,
440          "metadata": {},
441          "routingNumber": "12345678",
442          "status": "VERIFIED",
443          "supportedCurrencies": [
444            "USD"
445          ],
446          "updatedAt": "2021-01-01T00:00:00Z",
447          "confirmedByEntity": true
448        }
449      ]
450    },
451    "payerId": "ent_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4",
452    "paymentDestination": {
453      "type": "bankAccount",
454      "accountName": "My Checking Account",
455      "accountNumber": "99988767623",
456      "accountType": "CHECKING",
457      "bankName": "Chase",
458      "createdAt": "2021-01-01T00:00:00Z",
459      "frozen": false,
460      "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
461      "isDefaultDestination": true,
462      "isDefaultSource": true,
463      "metadata": {},
464      "routingNumber": "12345678",
465      "status": "VERIFIED",
466      "supportedCurrencies": [
467        "USD"
468      ],
469      "updatedAt": "2021-01-01T00:00:00Z",
470      "confirmedByEntity": true
471    },
472    "paymentDestinationId": "pm_65523ab0-043d-4706-b2b2-0b73fed92269",
473    "paymentSource": {
474      "type": "bankAccount",
475      "accountName": "My Checking Account",
476      "accountNumber": "99988767623",
477      "accountType": "CHECKING",
478      "bankName": "Chase",
479      "createdAt": "2021-01-01T00:00:00Z",
480      "frozen": false,
481      "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
482      "isDefaultDestination": true,
483      "isDefaultSource": true,
484      "metadata": {},
485      "routingNumber": "12345678",
486      "status": "VERIFIED",
487      "supportedCurrencies": [
488        "USD"
489      ],
490      "updatedAt": "2021-01-01T00:00:00Z",
491      "confirmedByEntity": true
492    },
493    "paymentSourceId": "pm_65523ab0-043d-4706-b2b2-0b73fed92269",
494    "status": "FAILED",
495    "updatedAt": "2024-01-01T00:00:00Z",
496    "vendor": {
497      "acceptedTos": false,
498      "accountType": "business",
499      "createdAt": "2024-01-01T00:00:00Z",
500      "email": "vendor@bigboxstore.com",
501      "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
502      "isCustomer": false,
503      "isNetworkPayee": false,
504      "isNetworkPayor": false,
505      "isPayee": true,
506      "isPayor": false,
507      "name": "Big Box Store",
508      "profile": {
509        "business": {
510          "legalBusinessName": "Big Box Store",
511          "taxIDProvided": false,
512          "email": "vendor@bigboxstore.com",
513          "businessType": "publicCorporation",
514          "ownersProvided": false
515        }
516      },
517      "status": "unverified",
518      "updatedAt": "2024-01-02T00:00:00Z",
519      "counterpartyType": [
520        "ENTITY"
521      ],
522      "foreignId": "MY-DB-ID-90909",
523      "paymentMethods": [
524        {
525          "type": "bankAccount",
526          "accountName": "Vendor Checking Account",
527          "accountNumber": "55934059697648",
528          "accountType": "CHECKING",
529          "bankName": "Chase",
530          "createdAt": "2021-01-01T00:00:00Z",
531          "frozen": false,
532          "id": "pm_7610541f-4619-4033-8620-cfccfb811293",
533          "isDefaultDestination": true,
534          "isDefaultSource": true,
535          "metadata": {},
536          "routingNumber": "66554433",
537          "status": "NEW",
538          "supportedCurrencies": [
539            "USD"
540          ],
541          "updatedAt": "2021-01-01T00:00:00Z",
542          "confirmedByEntity": false
543        }
544      ]
545    },
546    "vendorId": "ent_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4"
547  }
548}
A transaction was failed
Was this page helpful?
Previous

Transaction Returned

Next
Built with

Payload

The payload of this webhook request is an object.
eventTypestringRequired
The type of the event.
transactionobjectRequired
The transaction details.

Response

200
any
Return a 200 status to indicate that the data was received successfully.