post
https://sandbox-api.transfi.com/v3/orders
Creates a payment. One endpoint handles every flow — collect, pay out, on-ramp, off-ramp, pre-fund and swap — and orderType selects which. Register the user first, put the amount in source or destination (never both), and send a unique partnerId so a retry can never create a duplicate.
Error cases
A 400 carries the specific reason in error.context.details[].code.
STANDARD_KYC_REQUIRED/ENHANCED_KYC_REQUIRED: The user has reached a limit. Start that verification level, then create the order again once it succeeds.PARTNER_ID_ALREADY_USED: ThispartnerIdalready belongs to an order. Do not create it again; find the existing order with List Orders.SUCCESS_REDIRECT_URL_REQUIRED: SendsuccessRedirectUrl, or set a default redirect URL in the dashboard.SOURCE_CURRENCY_NOT_SUPPORTED: Use a currency returned by List Supported Currencies or List Tokens.PAYMENT_METHOD_NOT_FOUND: Fetch the methods for this country and direction with List Payment Methods, and use the codes returned.INSUFFICIENT_BALANCE: Pre-fund your balance, then create a new order.QUOTES_EXPIRED: Request a fresh rate and create the order again.DEVICE_DETAILS_REQUIRED: Headless and card flows needdeviceDetails.IP_VALIDATION_FAILED: The payer's IP address failed validation for this flow. Check the device details you send; contact support if it continues.DECLINED_BY_BANK_SUSPECTED_FRAUD: The bank declined the transaction. Show the message to the user and do not retry the same payment.BANK_REVIEW: The transaction is under review by the bank. Try again after 24 hours.TRANSACTION_REVIEW: The account is under review because of crypto-monitoring alerts. Try again after 24 hours.- Compliance check failed: Show the message to the user. Do not retry; contact support if you believe it is wrong.
Used in: Collections · Payouts · On-Ramp & Off-Ramp · Pre-funding · MCA
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
401Unauthorized. Add the MID header, and check the Base64 credentials and that they belong to this environment.
429Too many requests. Wait, then retry: 1 second, then 2, then 4.