Simulate a ledger deposit event in Sandbox

POST /sandbox/transfer/ledger/deposit/simulate

Use the /sandbox/transfer/ledger/deposit/simulate endpoint to simulate a ledger deposit event in the Sandbox environment.

Request Body

Required

Defines the request schema for /sandbox/transfer/ledger/deposit/simulate

Parameters

client_id
string
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.
secret
string
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.
sweep_id
required, string
Plaid’s unique identifier for a sweep.
event_type
required, string
The asynchronous event to be simulated. May be: posted, settled, failed, or returned. An error will be returned if the event type is incompatible with the current ledger sweep status. Compatible status --> event type transitions include: sweep.pending --> sweep.posted sweep.pending --> sweep.failed sweep.posted --> sweep.settled sweep.posted --> sweep.returned sweep.settled --> sweep.returned
failure_reason
object
The failure reason if the event type for a transfer is "failed" or "returned". Null value otherwise.
failure_code
string
The failure code, e.g. R01. A failure code will be provided if and only if the transfer status is returned. See ACH return codes for a full listing of ACH return codes and RTP/RfP error codes for RTP error codes.
ach_return_code
string
The ACH return code, e.g. R01. A return code will be provided if and only if the transfer status is returned. For a full listing of ACH return codes, see Transfer errors.
description
string
A human-readable description of the reason for the failure or reversal.

Response

Defines the response schema for /sandbox/transfer/ledger/deposit/simulate

Response Properties

request_id
required, string
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.