---
title: "OTC Order Status Update Notification"
method: POST
path: "otcCallbackWebhook"
---

# OTC Order Status Update Notification

`POST otcCallbackWebhook` (webhook)

OTC order result callback sent to the merchant callback URL for both on-ramp and off-ramp flows.

## Payload

- OtcCallbackPayload
  - `bizType` string, required — Fixed OTC business type.
  - `bizId` string, required — OTC order ID.
  - `bizStatus` 'RECHARGE_SUCCESS' | 'RECHARGE_FAIL' | 'WITHDRAW_SUCCESS' | 'WITHDRAW_FAIL' | 'WITHDRAW_DISPATCHED', required — OTC callback business status.
  - `clientId` string — Merchant client ID.
  - `client_id` string — Alternate merchant client ID field used by some integrations.
  - `data` string, required — JSON string containing the order snapshot.

## Acknowledgement `200`

Returns HTTP 200 to indicate the notification has been received successfully.

- OtcCallbackResponse — Response body returned by the merchant after receiving the notification.
  - `returnCode` string, required — Return status code; `SUCCESS` indicates successful processing.
  - `returnMessage` string, nullable — Return message; may be empty on success.

---

[API](https://skmtc.net/gate/apis/gatepay-otc-fiat-api.md) · [All operations](https://skmtc.net/gate/apis/gatepay-otc-fiat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gate/gatepay-otc-fiat-api/revisions/07cd4870de6a/schema)