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
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.