Guaranteed ACH
API reference for Guaranteed ACH endpoints
For how-to guidance, see the Transfer documentation.
| Guaranteed ACH | |
|---|---|
/transfer/return/recover | Report recovery of a loss on a returned guaranteed transfer |
/transfer/return/recover
Report a return recovery
Use the /transfer/return/recover endpoint to notify Plaid that you have recovered some or all of the loss on a returned guaranteed transfer.
Recovery can be reported in full or in parts; the sum of recovered amounts across calls cannot exceed the original transfer's amount.
Request fields
Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.
Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.
The ID of the returned transfer that was recovered.
The amount being recovered (decimal string with two digits of precision e.g. "10.00"). The sum of recovered amounts across calls cannot exceed the original transfer's amount.
A random key provided by the client, per unique recovery. Maximum of 50 characters.
The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to report a recovery fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single recovery is recorded.
50 const request: TransferReturnRecoverRequest = {
transfer_id: '460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9',
amount: '12.34',
idempotency_key: 'VEK2ea3X6LKywsc8J6pg',
};
try {
const response = await client.transferReturnRecover(request);
} catch (error) {
// handle error
}
Response fields
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
{
"request_id": "saKrIBuEB9qJZno"
}