Initiate a transfer

Initiates a transfer using the specified method. P2P and ACH transfers require a cryptographic signature from the source wallet before funds are released. Use the Approve transfer endpoint to complete the flow, or Cancel transfer to abort it.

POST

Headers

string

The Bearer token for authentication.

string

The user agent of the request. Must contain at least two identifiers separated by a space.

string

The content type of the request.

Request Body

application/json
string

The payment rail that will be used for the transfer.

P2PA2AACH
string

Source balance ID.

string

Depending on the method, this can be a contact ID or cashtag for P2P, a balance ID for A2A, or an account ID for ACH.

float

Amount to transfer. Must be at least 0.10 for P2P, 0.01 for A2A, or 25.00 for ACH.

string

Summary about the transfer. This value is required when the method is set to P2P or ACH and omitted when set to A2A.

Response Body

application/json
boolean

Indicates that the request was successful.

object

The transfer data.

string

The ID of the newly created transfer.

string

The status of the newly created transfer.