Get an order

Shows where one of your orders is right now. Check it after creating an order, or wait for webhooks and use this when you want to double-check.

Endpoint

GET https://merchant.minisend.xyz/api/onramp/orders/{order_id}

Authorization: Bearer ms_live_your_key_here

Requires the onramp scope. Orders you don’t own return 404.

Example

curl https://merchant.minisend.xyz/api/onramp/orders/7c1e4f9a-... \
  -H "Authorization: Bearer ms_live_your_key_here"

Response (200), KES

{
  "order_id": "7c1e4f9a-...",
  "status": "completed",
  "currency": "KES",
  "payment_method": "mpesa",
  "amount_usdc": 7.62,
  "amount_local": 1000,
  "fee": 10,
  "rate": 129.92,
  "customer_phone": "0712345678",
  "mobile_network": "Safaricom",
  "release_address": "0xyourwalletaddress0000000000000000000000",
  "release_chain": "base",
  "release_asset": "USDC",
  "receipt_number": "SHQ1234ABC",
  "release_tx_hash": "0x55a572efe1720250e442f38741477a4fc3f7f152e5cd208cc52f8222a1c2a13b",
  "external_reference": "collect-2201",
  "expires_at": "2026-07-23T12:30:00.000Z",
  "completed_at": "2026-07-23T12:04:41.000Z",
  "created_at": "2026-07-23T12:00:03.000Z"
}

Response (200), NGN pending

{
  "order_id": "...",
  "status": "pending",
  "currency": "NGN",
  "payment_method": "bank_transfer",
  "amount_usdc": 7.14,
  "amount_local": 10120,
  "fee": 120,
  "rate": 1400,
  "customer_phone": null,
  "mobile_network": null,
  "refund_account": {
    "institution": "GTBINGLA",
    "account_number": "0123456789",
    "account_name": "JOHN DOE"
  },
  "payment_instructions": {
    "method": "bank_transfer",
    "bank_name": "Guaranty Trust Bank",
    "account_number": "9876543210",
    "account_name": "Provider A / John Doe",
    "amount": "10120",
    "currency": "NGN",
    "expires_at": "2026-09-26T10:30:00Z",
    "note": "Transfer exactly this amount, kobo included, before expires_at. A different amount or a late transfer will not be credited."
  },
  "release_address": "0x...",
  "release_chain": "base",
  "release_asset": "USDC",
  "external_reference": "order-8841",
  "expires_at": "2026-09-26T10:30:00Z",
  "created_at": "..."
}

string

required

pending, deposit_received, completed, failed, cancelled, or expired. See order statuses. deposit_received only happens on NGN orders. cancelled only happens on KES orders, when your customer dismissed the M-Pesa prompt. A KES order still pending after expires_at shows as expired when you fetch it. An NGN order becomes expired shortly after its bank account deadline passes with nothing sent.

string

required

mpesa or bank_transfer.

object

NGN only. The payer’s own bank account, as we checked it when the order was created.

object

NGN only. Only here while the order is pending and the account still works. It’s removed once the order becomes deposit_received, completed, failed, or expired. Don’t keep showing it after expires_at.

string

KES only. The M-Pesa confirmation code, once the order is completed.

string

The ID of the Base transaction that sent you the USDC. It appears when the order completes, or shortly after.

string

Set on failed and cancelled orders. For KES, it’s the reason in words after a stk_failed: label, for example stk_failed: The payer cancelled the M-Pesa prompt. For NGN, it’s one of refunded_to_payer, deposit_not_settled, cancelled, provision_failed, persist_failed, or price_moved. See webhooks for what each one means.

string

Date and time the order completed, ISO 8601.

Errors

Status	Meaning
`403`	The onramp isn’t switched on for your account yet
`404`	We can’t find this order, or it belongs to another account

Overview

Endpoints

Off-ramp endpoints

Onramp endpoints

Wallet API endpoints

Get an order

Endpoint

Example

Response (200), KES

Response (200), NGN pending

Errors

​Endpoint

​Example

​Response (200), KES

​Response (200), NGN pending

​Errors

Endpoint

Example

Response (200), KES

Response (200), NGN pending

Errors