Create internal transfer

POST 
/payment/v3/transfers

Creates an internal transfer between wallets with optional currency conversion.

Supports two conversion types:

• QUOTE: Returns a firm rate that requires client acceptance before settlement. The transfer is held in PENDING_QUOTE_ACCEPTANCE state until the client accepts the quote via the actions endpoint.

• AUTO_CONVERSION: Automatically converts funds at the market rate without requiring quote acceptance. Only fixed debit is supported.

For same-asset transfers (originator and beneficiary currencies match), omit the conversion object.

To preview a conversion transfer without creating it, use the POST /payment/v3/transfers/dry-run endpoint instead. It returns the rate, spread, fees, and converted amounts without persisting a transfer or moving any funds.

Request

Responses

• 201
• 400
• 403

Transfer created successfully