> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/remittance-api/business/withdrawal/withdrawal-result-notification.md). # Withdrawal Result Notification Notifies the partner when a withdrawal order changes status and provides the settlement, fee, refund, and error details required for reconciliation. #### Notification delivery Pagsmile sends an HTTP `POST` request to the webhook URL configured for your integration. **Content-Type:** `application/json; charset=UTF-8` The notification uses the [Webhook Common envelope](https://docs.pagsmile.com/remittance-api/business/webhook/webhook-common). The fields below describe the decrypted `biz_data` object. {% hint style="info" %} **Requirement:** `M` = Mandatory, `O` = Optional, and `C` = Conditional. A conditional field is mandatory only when the condition stated in its description applies. {% endhint %} #### Notification body **Decrypted `biz_data` fields** | Field | Type | Requirement | Description | | ----------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `order_id` | long | M | Pagsmile-assigned unique identifier of the order. | | `merchant_id` | long | M | Pagsmile-assigned unique identifier of the merchant on whose behalf the request is submitted. | | `transaction_id` | long | O | Pagsmile-assigned unique identifier of the transaction. | | `order_no` | string | M | Merchant-defined order number used to submit, query, and reconcile the withdrawal order. | | `order_status` | integer | M |

Current processing status of the withdrawal order.
See Order Status for supported values.

| | `audit_status` | integer | O | Current compliance or material review status of the withdrawal order. | | `bank_country` | string | O | Two-letter ISO 3166-1 alpha-2 code of the country where the bank account is held. | | `pay_currency` | string | O | Three-letter ISO 4217 code of the currency debited for the transaction. | | `pay_amount` | string | O | Amount debited in the payment currency. | | `fee` | string | O | Service fee charged for the transaction, expressed in the corresponding currency. | | `payed_at` | string | O | Date and time when the order was paid. Format: `yyyy-MM-dd HH:mm:ss`. | | `refund_transaction_id` | long | O | Unique identifier of the refund transaction. | | `refund_fee` | string | O | Fee charged or returned as part of the refund. | | `refunded_at` | string | O | Date and time when the refund was completed. Format: `yyyy-MM-dd HH:mm:ss`. | | `receive_currency` | string | M | Three-letter ISO 4217 code of the currency credited to the recipient. | | `receive_amount` | string | M | Amount credited in the receiving currency. | | `account_num` | string | O | Registered bank account number to which the withdrawal is sent. | | `payee_name` | string | O | Name of the payee or withdrawal beneficiary. | | `payee_id` | long | O | Unique identifier of the payee or withdrawal beneficiary. | | `reference` | string | O | Merchant-provided reference used to reconcile the withdrawal order with the merchant's internal records. | | `error_message` | string | O | Human-readable explanation provided when processing fails. | | `created_at` | string | O | Date and time when the withdrawal order was created. Format: `yyyy-MM-dd HH:mm:ss`. | **Plaintext `biz_data` example** {% hint style="info" %} This example includes mandatory fields and representative optional or conditional fields. Submit fields marked `C` only when the condition in the field description applies. {% endhint %} ```json { "order_id": 100001, "merchant_id": 100398, "transaction_id": 100001, "order_no": "ORDER_202607200001", "order_status": 1, "audit_status": 1, "bank_country": "BR", "pay_currency": "USD", "pay_amount": "100.00", "fee": "100.00", "payed_at": "2026-07-20 10:30:00", "refund_transaction_id": 100001, "refund_fee": "100.00", "refunded_at": "2026-07-20 10:30:00", "receive_currency": "USD", "receive_amount": "100.00", "account_num": "1234567890", "payee_name": "Example Name", "payee_id": 100001, "reference": "Example reference", "error_message": "Beneficiary account is invalid", "created_at": "2026-07-20 10:30:00" } ``` #### Acknowledgment Return any HTTP `2xx` status to acknowledge successful receipt. Any other status is treated as a delivery failure. {% hint style="warning" %} Failed deliveries are retried up to 7 times after approximately 10 seconds, 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours, and 24 hours. Process notifications idempotently because the same event may be delivered more than once. {% endhint %} #### Related APIs * [Add Withdrawal Account](https://docs.pagsmile.com/remittance-api/business/withdrawal/add-withdrawal-account) * [Create Withdrawal Order](https://docs.pagsmile.com/remittance-api/business/withdrawal/create-withdrawal-order) * [Delete Withdrawal Account](https://docs.pagsmile.com/remittance-api/business/withdrawal/delete-withdrawal-account) * [Query Withdrawal Account Detail](https://docs.pagsmile.com/remittance-api/business/withdrawal/query-withdrawal-account-detail) * [Query Withdrawal Orders](https://docs.pagsmile.com/remittance-api/business/withdrawal/query-withdrawal-orders) * [Update Withdrawal Account](https://docs.pagsmile.com/remittance-api/business/withdrawal/update-withdrawal-account)