IPNs (Instant Payment Notifications) are sent to the notify_url provided by merchants when apply the withdrawal, when withdrawal status is changed.
1.Notification sent by gateway is in POST Method.
2.Body is a JSON-formatted string (content-Type: application/json)
Withdrawal Status
| Index | Event | Status | Description |
|---|---|---|---|
| 1 | withdrawal_apply | Apply | Initial withdrawal request made by the user |
| 2 | withdrawal_cancel | Cancel | User canceled the request |
| 3 | withdrawal_confirm | Confirm | User confirmed; awaiting system/admin review |
| 4 | withdrawal_reject | Reject | Request declined post-review |
| 5 | withdrawal_approve | Approve | Request approved and processing |
| 6 | withdrawal_success | Success | Funds transferred successfully |
| 7 | withdrawal_fail | Failed | Transfer failed due to errors |
Example
{
"ipn_type": "withdrawal",
"event": "withdraw_confirm",
"withdrawal_id": "03b6fd73-e5a8-4f98-a7e5-69556dc9cb00",
"network": "NETWORK_BSC",
"asset_type": "UTT",
"address": "0x347061544a8B0e17D62a14F4700166BB78f9bBEd",
"amount": 15,
"fee": 5,
"txn_hash": null,
"status": "Apply",
"create_time": "2023-09-05T09:42:42",
"update_time": "2023-09-05T09:43:16.9218807Z",
"notify_id": "4033d2c2-f8c6-47fa-aea0-d3b0d49f476b",
"notify_time": "2023-09-05T09:43:18.5578888Z"
}
Description
| invoice_id | string | UniPayment Invoice ID. |
|---|---|---|
| ipn_type | string | IPN type, withdrawal is for invoice notification |
| event | string | Event type for invoice |
| withdrawal_id | string | This is the amount buyer will send the crypto payment. |
| network | string | BlockChain from which gateway will send the fund |
| asset_type | string | BlockChain from which buyer will send the payment |
| address | address | The address |
| amount | float | Amount of withdrawal |
| fee | float | Fee of withdrawal |
| status | string | The status of withdrawal |
| create_time | datetime | Create time of withdrawal |
| update_time | datetime | Update time of withdrawal |
| notify_id | string | Unique notify Id |
| notify_time | datetime | Notify time |