Create Order

{
  "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"
        }
      ]
    }
  }
}

POST

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

string

required

Unique API key issued manually through Telegram.

string

required

Unique UUID v4 to prevent double-processing on network retries.

Request Body

string

required

The stablecoin amount to convert (e.g. "100.00").

string

required

The source token type. Supported: SUI, USDC, USDT.

string

required

Sui network environment: sui-testnet or sui-mainnet.

string

required

The executable corridor rate returned by /v1/rates/{token}/{amount}/{fiat} after the 0.5% provider fee.

string

Optional transaction reference code.

object

required

Target beneficiary bank account coordinates for local fiat payout.

string

required

The payout institution code returned by /v1/institutions/{currency_code}.

string

Optional local fiat code for the recipient corridor.

string

required

The payout account identifier or wallet handle.

string

required

The exact account name of record.

string

Optional bank transfer memo text.

Response

Returns the standard response envelope with payment options.

string

Response state (success).

string

Human-readable message.

object

Order details payload.

string

Unique prefix ID of the order (ord_...).

string

Lifecycle state (awaiting_deposit).

string

Rate locked for the transaction.

string

Calculated fiat payout amount.

string

Protocol fee in coin units.

object

Payment deposit details.

string

Source chain (sui).

string

Exact stablecoin amount to deposit.

string

Full Sui Move coin package identifier.

array

Deposit options.

string

ptb (Move Programmable Transaction Block) or receive_address.

string

Description instruction.

string

Sui contract package ID (only for ptb).

string

Base64-serialized transaction block for wallet signing (only for ptb).

string

Temporary deposit address (only for receive_address).

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"
        }
      ]
    }
  }
}

Create Recipient Create Order — EVM & Starknet

Introduction

Implementation

Products on Rails

Reference

API Reference

Create Order

Header Parameters

Request Body

Response

Example Payloads

​Header Parameters

​Request Body

​Response

​Example Payloads

Header Parameters

Request Body

Response

Example Payloads