Skip to main content
POST
Submit Conversion

Authorizations

Authorization
string
header
required

Bearer authentication with an API token

Body

application/json
request_id
string<uuid>
required

Request identifier in UUID format. Serves as an idempotency key.

Pattern: [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
string
required

Amount to be converted in source currency. Maximum 2 decimal places.

account_id
string
required

Account ID to debit for the conversion.

payment_purpose
enum<string>
required

Purpose of the payment

Available options:
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
Example:

"SALARY_PAYMENT"

source
source · object
required

Source of the conversion

destination
destination · object
required

Destination of the conversion

quote_id
string

(OPTIONAL) Quote ID from a prior GET /v2/conversions/quotes response. Required for off-ramp conversions.

device_signals
DeviceSignals · object | null

DeviceSignals carries client device/network identifiers captured at request time for value-moving, user-initiated endpoints.

Response

Success

request_id
string<uuid>
required

Client-provided request_id (UUID). Idempotency key for internal reconciliation only; do not surface on end-user receipts — use id.

Pattern: [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
string
required

Amount in source currency.

account_id
string
required

Account ID debited for the conversion

payment_purpose
enum<string>
required

Purpose of the payment

Available options:
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
Example:

"SALARY_PAYMENT"

source
source · object
required

Source configuration

destination
destination · object
required

Destination configuration

id
string
read-only

Server-generated unique conversion ID (KSUID). This is the canonical transaction identifier; use it on end-user receipts and references.

type
enum<string>
read-only

Inferred conversion type

Available options:
CONVERSION_TYPE_UNSPECIFIED,
ON_RAMP,
OFF_RAMP
Example:

"ON_RAMP"

status
enum<string>
read-only

Current external status of the conversion

Available options:
CONVERSION_STATUS_UNSPECIFIED,
INITIATED,
PROCESSING,
IN_REVIEW,
PAYOUT_INITIATED,
PAYOUT_COMPLETED,
COMPLETED,
FAILED,
CANCELLED,
RETURNED
Example:

"INITIATED"

source_deposit_instructions
source_deposit_instructions · object

(OPTIONAL) Deposit instructions for MemoID On-Ramp.

created_at
string
read-only

Timestamps

updated_at
string
read-only
completed_at
string
read-only

Timestamp for when conversion reached terminal COMPLETED status.

exchange_rate
string
read-only

The exchange rate applied to the conversion.

fees_total
string
read-only

Rolled-up total of all fees visible to the end user.

destination_currency
string
read-only

Destination currency symbol (e.g., "USD", "MXN", "KRW").

fees
Fee · object[]
read-only

Itemized fee breakdown.

fee_model
enum<string>
read-only

Fee model applied to this conversion. INCLUSIVE means fees are deducted from the source amount so the user sends exactly the quoted amount.

Available options:
FEE_MODEL_UNSPECIFIED,
INCLUSIVE,
DEDUCTED,
ON_TOP
Example:

"INCLUSIVE"

fees_total_currency
enum<string>
read-only

Currency that fees_total is expressed in.

Available options:
CONVERSION_CURRENCY_UNSPECIFIED,
USDC,
USD,
MXN,
INR,
KRW,
USDT,
GHS,
EUR
Example:

"USDC"

quote_id
string
read-only

Quote referenced on submit.

failure_reason
string | null
read-only

Human-readable reason when the conversion failed, was canceled, or was returned. Omitted when unset.

refund_details
RefundDetails · object | null

Present only when status is RETURNED.