Simulate a transfer event in Sandbox

POST /sandbox/transfer/simulate

Use the /sandbox/transfer/simulate endpoint to simulate a transfer event in the Sandbox environment. Note that while an event will be simulated and will appear when using endpoints such as /transfer/event/sync or /transfer/event/list, no transactions will actually take place and funds will not move between accounts, even within the Sandbox.

Request Body

Required

Defines the request schema for /sandbox/transfer/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.
transfer_id
required, string
Plaid’s unique identifier for a transfer.
test_clock_id
string
Plaid’s unique identifier for a test clock. If provided, the event to be simulated is created at the virtual_time on the provided test_clock.
event_type
required, string
The asynchronous event to be simulated. May be: posted, settled, failed, funds_available, or returned. An error will be returned if the event type is incompatible with the current transfer status. Compatible status --> event type transitions include: pending --> failed pending --> posted posted --> returned posted --> settled settled --> funds_available (only applicable to ACH debits.)
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.
webhook
string
The webhook URL to which a TRANSFER_EVENTS_UPDATE webhook should be sent.

Response

Defines the response schema for /sandbox/transfer/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.