Submit Conversion
Submit a conversion on behalf of an account
Authorizations
Bearer authentication with an API token
Body
Request identifier in UUID format. Serves as an idempotency key.
[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}Amount to be converted in source currency. Maximum 2 decimal places.
Account ID to debit for the conversion.
Purpose of the payment
PAYMENT_PURPOSE_UNSPECIFIED, SALARY_PAYMENT, PERSONAL_REMITTANCE, RENT_PAYMENT, PROPERTY_PURCHASE, OWNED_ACCOUNT_ABROAD, ADVERTISING_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, CONSTRUCTION, DELIVERY_FEES, EDUCATION, EXPORTS, DONATION, HOTEL, LOAN_PAYMENT, MAINTENANCE_EXPENSES, MEDICAL_EXPENSE, OFFICE_EXPENSES, ROYALTY_FEES, SERVICE_CHARGE, SHARES_INVESTMENT, TAX_PAYMENT, TRANSPORTATION_FEES, TRAVEL, UTILITY_BILLS, INTERNAL_BUSINESS_MOVEMENT "SALARY_PAYMENT"
Source of the conversion
Destination of the conversion
(OPTIONAL) Quote ID from a prior GET /v2/conversions/quotes response. Required for off-ramp conversions.
DeviceSignals carries client device/network identifiers captured at request time for value-moving, user-initiated endpoints.
Response
Success
Client-provided request_id (UUID). Idempotency key for internal
reconciliation only; do not surface on end-user receipts — use id.
[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}Amount in source currency.
Account ID debited for the conversion
Purpose of the payment
PAYMENT_PURPOSE_UNSPECIFIED, SALARY_PAYMENT, PERSONAL_REMITTANCE, RENT_PAYMENT, PROPERTY_PURCHASE, OWNED_ACCOUNT_ABROAD, ADVERTISING_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, CONSTRUCTION, DELIVERY_FEES, EDUCATION, EXPORTS, DONATION, HOTEL, LOAN_PAYMENT, MAINTENANCE_EXPENSES, MEDICAL_EXPENSE, OFFICE_EXPENSES, ROYALTY_FEES, SERVICE_CHARGE, SHARES_INVESTMENT, TAX_PAYMENT, TRANSPORTATION_FEES, TRAVEL, UTILITY_BILLS, INTERNAL_BUSINESS_MOVEMENT "SALARY_PAYMENT"
Source configuration
Destination configuration
Server-generated unique conversion ID (KSUID). This is the canonical transaction identifier; use it on end-user receipts and references.
Inferred conversion type
CONVERSION_TYPE_UNSPECIFIED, ON_RAMP, OFF_RAMP "ON_RAMP"
Current external status of the conversion
CONVERSION_STATUS_UNSPECIFIED, INITIATED, PROCESSING, IN_REVIEW, PAYOUT_INITIATED, PAYOUT_COMPLETED, COMPLETED, FAILED, CANCELLED, RETURNED "INITIATED"
(OPTIONAL) Deposit instructions for MemoID On-Ramp.
Timestamps
Timestamp for when conversion reached terminal COMPLETED status.
The exchange rate applied to the conversion.
Rolled-up total of all fees visible to the end user.
Destination currency symbol (e.g., "USD", "MXN", "KRW").
Itemized fee breakdown.
Fee model applied to this conversion. INCLUSIVE means fees are deducted from the source amount so the user sends exactly the quoted amount.
FEE_MODEL_UNSPECIFIED, INCLUSIVE, DEDUCTED, ON_TOP "INCLUSIVE"
Currency that fees_total is expressed in.
CONVERSION_CURRENCY_UNSPECIFIED, USDC, USD, MXN, INR, KRW, USDT, GHS, EUR "USDC"
Quote referenced on submit.
Human-readable reason when the conversion failed, was canceled, or was returned. Omitted when unset.
Present only when status is RETURNED.
Related topics
Sandbox vs. production environmentsOff-ramp: Withdraw stablecoin to a bank accountOff-ramp: Withdraw stablecoin internationallyOff-ramp: Withdraw stablecoin to a US bank accountConversion notifications