Webhook
info
All webhook calls from the payment gateway system to merchants use HTTP POST.
Get Order Status
Test endpoint: https://api-onramp.stg.eopay.io/order/get-sso-order-status
Production endpoint: https://api-onramp.eopay.io/order/get-sso-order-status
note
Merchant service IPs must be allow-listed in production for this webhook.
Signature
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| merchantId | string | Merchant ID assigned during onboarding |
| ssoOrderId | string | Merchant-defined unique ID (must match the value used when the order was created) |
Order Payment Status Notification
note
Merchants must provide this webhook endpoint.
Callback Parameters
| Parameter | Type | Description |
|---|---|---|
| merchantId | string | Merchant ID assigned during onboarding |
| payId | string | Unique payment ID |
| failReasons | string | Error details |
| status | string | Payment status: APPROVED, DECLINED |
| sign | string | Signature generated from ssoOrderId + secret key |
| orderType | number | Order type: 0, 1 |
| currency | string | Fiat currency code |
| fiatAmount | string | Order amount |
| crypto | string | Crypto currency code |
| cryptoAmount | string | Crypto amount |
| responseCode | string | Acquirer response code |
3D Challenge Result Notification
note
Merchants must provide this webhook endpoint.
Callback Parameters
| Parameter | Type | Description |
|---|---|---|
| merchantId | string | Merchant ID assigned during onboarding |
| ssoOrderId | string | Merchant-defined unique ID (must match the value used when the order was created) |
| failReasons | string | 3D failure reason |
| status | string | 3D status: F failure, S success (uppercase) |
| responseCode | number | Error code |