Collect Order Updated

COLLECT_ORDER_UPDATED — a stablecoin collection / payment-link order changed state. Deduplicate on
eventId.

Deposit whitelist

data.whiteListStatus is the deposit-whitelist gate state of the crypto payment behind the order —
init / pending / approved / rejected, lowercase. It is null for orders that are not gated.

There is no separate whitelist webhook. Read the gate off this event:

Situation	How it looks
Payer details needed, first submission	`orderStatus = PROCESSING` and `whiteListStatus = init`
Review rejected, resubmit	`orderStatus = PROCESSING` and `whiteListStatus = rejected`
Order finished	`orderStatus = SUCCESS`

Answer a gate with POST /v1/wallet/deposit-whitelist/transactions/{transactionId}/submit.

Until whiteListStatus is approved the funds sit in the unavailable balance of the receiving wallet
and cannot be withdrawn or converted, however far orderStatus has moved. Whitelist approval is not
announced on its own — this event reaching orderStatus = SUCCESS is the completion signal.

Refunds

data.refundBy and data.refundReason carry the refund attribution.
refundBy is MERCHANT for a refund you triggered through POST /v2/stable/collect/order/reject, and
BPN for one the platform triggered on its own, so branch on it rather than assuming every refund is yours.

Guide: Wallet · Deposit whitelist

Request

Header Params

Body Params application/json

Example

{
  "data": {
    "orderId": "726300170547609600",
    "orderStatus": "PROCESSING",
    "acceptStatus": "ACCEPTING",
    "accountName": "TestSubWallet1772688467",
    "walletId": "3095",
    "currency": "USDC",
    "amount": "190.99",
    "completeTime": 1720606148703,
    "walletAddress": "1544594690749788162",
    "transactionId": "mock2s0260000004",
    "payer": {
      "walletAddress": "1544594690749788161",
      "walletNetwork": "ETH",
      "isCexAddress": true
    },
    "quote": {
      "quoteId": "37947e9f5ada4fa0b38955d3949bd9fc",
      "price": "1",
      "fee": "0",
      "expireTime": "2026-03-06T06:21:43.829Z"
    },
    "aml": {
      "amlStatus": "PASSED",
      "riskLevel": "LOW"
    },
    "whiteListStatus": "approved"
  },
  "eventId": "d4798719-1c9e-4ab9-b9f4-97dcfc25488b",
  "eventType": "COLLECT_ORDER_UPDATED",
  "referenceId": "726300170547609600",
  "status": "PROCESSING",
  "timestamp": 1772777203843
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Collect Order Updated