Using the values
SendPOST /platform/v2/transfers with a funded source account, then replace the target field for the case you want to test. Start from this request body and swap in the target fragment shown for your case:
- Synchronous: the request is rejected with HTTP
400or422anderrorType: "invalid_request". These are API errors, not transfer failures. Correct the input rather than retrying it unchanged. - Asynchronous: the transfer is accepted with HTTP
200and statusprocessing, then reaches terminal statusfailedafter approximately 500 ms. Poll Get Transfer or handle thepayments.transfers.failedwebhook.
Onchain addresses
Settarget.address to one of these values, with the matching network and asset.
Synchronous outcomes
Successful transfer
Successful transfer
Target request:Response (HTTP
200):Invalid target
Invalid target
Target request:Response (HTTP
400):Invalid address
Invalid address
Target request:Response (HTTP
400):Unsupported network
Unsupported network
Target request:Response (HTTP
400):Asynchronous failures
Asynchronous processing failure
Asynchronous processing failure
Target request:Response (HTTP
200):200 with status failed. Webhooks fire in this order: payments.transfers.quoted and payments.transfers.processing (both best-effort), then payments.transfers.failed.
Off-chain targets
Settarget.email to one of these values.
Email addresses
Synchronous outcomes
Successful transfer to user 1
Successful transfer to user 1
Target request:Response (HTTP
200):Successful transfer to user 2
Successful transfer to user 2
Target request:Response (HTTP
200):Invalid email target
Invalid email target
Target request:Response (HTTP
400 for both execution and validation-only requests):Synchronous execution failure
Synchronous execution failure
Target request:Response with To test validation instead, set
execute: true (HTTP 422):validateOnly: true and execute: false. HTTP 200 returns validated details without a transfer status.Asynchronous failures
Asynchronous processing failure
Asynchronous processing failure
Target request:Response (HTTP
200):200 with status failed. Webhooks fire in this order: payments.transfers.quoted and payments.transfers.processing (both best-effort), then payments.transfers.failed.
Related references
- Transfers Quickstart for runnable success requests.
- Transfer validation for validation-only behavior.
- Failure reference for failure-code definitions and retry guidance.
- Customer verification Sandbox values for KYC and capability simulations, which are separate from transfer test values.