Dishonor a return received on an originated ACH transaction

post

https://api.sandbox.braid.zone/transaction/ach/dishonor

Transmits an outbound dishonor (R61, R62, R67, R68, R69, or R70) on the inbound return previously received against an ACH transaction we originated. For R69, returnReasonCode (01-07) must identify the specific field defect. addendaInformation max 21 chars per NACHA addenda99Dishonored.

Body Params

paymentId

string

required

The paymentId of the ORIGINATED (outbound) ACH transaction that we received a return on, not the paymentId of the return itself. Must be in RETURNED status with a matched inbound NACHA return record.

returnCode

string

enum

required

NACHA dishonor return code. Must be one of R61, R62, R67, R68, R69, or R70.

returnReasonCode

string

Required when returnCode is R69. Two-character field-defect sub-code identifying which field on the original return was in error: 01 = receiver account, 02 = trace number, 03 = amount, 04 = ID number, 05 = transaction code, 06 = company ID, 07 = effective entry date. Must be blank for all other return codes.

addendaInformation

string

Optional free-form descriptive text written to the addenda99Dishonored addendaInformation field. Maximum 21 characters per NACHA field width.

Responses

200OK

400Bad Request

401Unauthorized

403Forbidden

404Not Found

412Precondition Failed

422Unprocessable Entity

500Internal Server Error

503Service Unavailable