Create conversion order 🔒 (deprecated)

post

https://api.centiiv.io/public/order

Create a new conversion order that will be processed by the liquidity network.

Order Flow:

Offramp (USDC → NGN):

Order created with PENDING status
User sends USDC to the temporary wallet address returned
System detects deposit and triggers fulfillment
LP sends NGN to beneficiary bank account
Order marked as FULFILLED

Onramp (NGN → USDC):

Order created with PENDING status
User deposits NGN to the virtual bank account returned
System detects deposit and triggers fulfillment
LP sends USDC to destination wallet address
Order marked as FULFILLED

Timeouts:

Orders expire after 30 minutes if no deposit is received
Expired orders are automatically cancelled

Refunds:

If fulfillment fails, funds are refunded to the refundAddress (offramp) or source account (onramp)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
**NOTE: ** This endpoint is deprecated. Please switch to the Create a new request endpoint instead.

Body Params

fromAsset

string

enum

required

Source asset to convert from

toAsset

string

enum

required

Destination asset to convert to

amount

number

required

≥ 0.01

Amount to convert in source asset units. Must be positive and within allowed limits.

network

string

enum

Defaults to STELLAR

Blockchain network this order runs on. Must match an existing rail for the (fromAsset, toAsset, network) triple. Defaults to STELLAR when omitted.

description

string

length ≤ 500

Human-readable description for this order. Useful for your records and customer support.

beneficiary

object

Beneficiary information for OFFRAMP orders (Crypto → Fiat). Required when converting crypto to fiat.

destinationAddress

string

Wallet address for ONRAMP orders (Fiat → Crypto). Required when converting fiat to crypto. Must be a valid blockchain address.

refundAddress

string

Wallet address for refunds if OFFRAMP fails. Recommended for all offramp orders.

sender

object

Sender information for ONRAMP orders. Helps with compliance and customer identification.

webhookUrl

string

Webhook URL to receive real-time order status updates. Must be a publicly accessible HTTPS endpoint.

targetNodeId

string

Target a specific LP node for this order. Only use if you have a preferred LP arrangement.

metadata

object

Custom metadata to attach to this order. Stored and returned in webhooks and order queries.

Headers

X-Environment

string

enum

Environment to use for the request. When using API keys, the environment is determined from the key prefix.

Allowed:

X-Platform

string

Optional platform/application identifier for tracking and analytics

Responses

401

Unauthorized - Invalid or missing credentials

201Order created successfully

400Invalid request data