Skip to main content
POST
/
v1
/
sender
/
orders
{
  "amount": "100.00",
  "token": "USDC",
  "network": "sui-testnet",
  "rate": "1530.50",
  "recipient": {
    "institution": "KCBKES01",
    "currency": "KES",
    "account_identifier": "0123456789",
    "account_name": "Jane Doe",
    "memo": "Invoice payment"
  }
}

{
  "status": "success",
  "message": "Order initiated successfully",
  "data": {
    "order_id": "ord_8f7b2c91",
    "status": "awaiting_deposit",
    "rate_quoted": "1530.50",
    "fiat_amount": "153050.00",
    "fee": "0.50",
    "pay_to": {
      "chain": "sui",
      "amount": "100.000000",
      "coin_type": "0x5d7...::usdc::USDC",
      "options": [
        {
          "method": "ptb",
          "label": "Pay with connected Sui wallet",
          "gateway_package_id": "0xabc...",
          "ptb_base64": "gAIBACAB..."
        },
        {
          "method": "receive_address",
          "label": "Send from any exchange",
          "address": "0xdeadbeef...",
          "qr_payload": "sui:0xdeadbeef...?amount=100"
        }
      ]
    }
  }
}
Initialize an offramp order to move stablecoins into Sui settlement and complete local fiat payout through Route A. The rate field should be the locked corridor quote returned by GET /v1/rates/{token}/{amount}/{fiat}.

​
Header Parameters

​
API-Key
string
required
Unique API key issued manually through Telegram.
​
Idempotency-Key
string
required
Unique UUID v4 to prevent double-processing on network retries.

​
Request Body

​
amount
string
required
The stablecoin amount to convert (e.g. "100.00").
​
token
string
required
The source token type. Supported: SUI, USDC, USDT.
​
network
string
required
Sui network environment: sui-testnet or sui-mainnet.
​
rate
string
required
The executable corridor rate returned by /v1/rates/{token}/{amount}/{fiat} after the 0.5% provider fee.
​
reference
string
Optional transaction reference code.
​
recipient
object
required
Target beneficiary bank account coordinates for local fiat payout.
​
institution
string
required
The payout institution code returned by /v1/institutions/{currency_code}.
​
currency
string
Optional local fiat code for the recipient corridor.
​
account_identifier
string
required
The payout account identifier or wallet handle.
​
account_name
string
required
The exact account name of record.
​
memo
string
Optional bank transfer memo text.

​
Response

Returns the standard response envelope with payment options.
​
status
string
Response state (success).
​
message
string
Human-readable message.
​
data
object
Order details payload.
​
order_id
string
Unique prefix ID of the order (ord_...).
​
status
string
Lifecycle state (awaiting_deposit).
​
rate_quoted
string
Rate locked for the transaction.
​
fiat_amount
string
Calculated fiat payout amount.
​
fee
string
Protocol fee in coin units.
​
pay_to
object
Payment deposit details.
​
chain
string
Source chain (sui).
​
amount
string
Exact stablecoin amount to deposit.
​
coin_type
string
Full Sui Move coin package identifier.
​
options
array
Deposit options.
​
method
string
ptb (Move Programmable Transaction Block) or receive_address.
​
label
string
Description instruction.
​
gateway_package_id
string
Sui contract package ID (only for ptb).
​
ptb_base64
string
Base64-serialized transaction block for wallet signing (only for ptb).
​
address
string
Temporary deposit address (only for receive_address).
​
qr_payload
string
Sui schema QR string (only for receive_address).

​
Example Payloads

{
  "amount": "100.00",
  "token": "USDC",
  "network": "sui-testnet",
  "rate": "1530.50",
  "recipient": {
    "institution": "KCBKES01",
    "currency": "KES",
    "account_identifier": "0123456789",
    "account_name": "Jane Doe",
    "memo": "Invoice payment"
  }
}

{
  "status": "success",
  "message": "Order initiated successfully",
  "data": {
    "order_id": "ord_8f7b2c91",
    "status": "awaiting_deposit",
    "rate_quoted": "1530.50",
    "fiat_amount": "153050.00",
    "fee": "0.50",
    "pay_to": {
      "chain": "sui",
      "amount": "100.000000",
      "coin_type": "0x5d7...::usdc::USDC",
      "options": [
        {
          "method": "ptb",
          "label": "Pay with connected Sui wallet",
          "gateway_package_id": "0xabc...",
          "ptb_base64": "gAIBACAB..."
        },
        {
          "method": "receive_address",
          "label": "Send from any exchange",
          "address": "0xdeadbeef...",
          "qr_payload": "sui:0xdeadbeef...?amount=100"
        }
      ]
    }
  }
}