post
https://api.1money.com/v1/customers//auto-conversion-rules
Create an Auto-Conversion Rule for fiat->crypto, crypto->fiat, or crypto->crypto conversions.
Supported Assets:
USD,USDC,USDT,PYUSD,RLUSD,USDG,USDP,EURC,MXNB
Supported Networks:- Fiat deposit networks:
US_FEDWIRE,SWIFT - Crypto networks:
ETHEREUM,POLYGON,BASE,ARBITRUM,AVALANCHE,BNBCHAIN,SOLANA,TRON
Validation Rules:
- Supported pairs: fiat->crypto, crypto->fiat, and crypto->crypto; fiat->fiat is NOT supported
Idempotency-Keyheader is required and must be a valid UUID v4- Source network must match asset type (fiat asset requires fiat network, crypto asset requires crypto network)
- For crypto withdrawal destination:
networkis required whenwallet_addressis provided - For fiat destination:
networkwill be omitted
Withdrawal Configuration:
- Fiat-to-Crypto or Crypto->Crypto with withdrawal: provide
wallet_address(external crypto wallet address) - Crypto-to-Fiat with withdrawal: provide
external_account_id(bank account ID from external-accounts API) - Conversion-only (no withdrawal): omit both fields, converted funds remain in customer's account
Idempotency & Webhook Behavior:
- This endpoint creates resources asynchronously. The webhook notification may arrive before the HTTP response returns.
- Use the
Idempotency-Keyto query the resource status via webhook response, enabling proper idempotency control. - Recommended flow: Instead of waiting for the HTTP response and then the webhook, clients can use the webhook arrival as the completion signal and query by
Idempotency-Keyto verify the result. - This approach prevents "dangling wait" scenarios where clients unnecessarily wait for the HTTP response when the webhook has already confirmed the outcome.
Response & Status:
- The response will have
status=PENDINGandsource_deposit_info=nullbecause deposit info is being prepared asynchronously. - Once deposit info is ready, the status will transition to
ACTIVEandsource_deposit_infowill contain bank deposit details or crypto wallet address. - Use the retrieve endpoint or webhook to get the full details when the rule becomes
ACTIVE.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
