---
title: Notification - API Payout (Disbursement) SNAP
slug: en/nicepay-api-snap-payout-notification-disbursement
description: Information about Notification - API Disbursement SNAP available on the NICEPAY system
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FNFGB8JRtShuBmR80NmnY_microsoftteams-image.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2023-05-04T03:21:47.000Z
---

# About Notification - API Payout (Disbursement) SNAP

***

This API with SNAP standards uses to send the notification from Payout or Disbursement proses result.



# X-SIGNATURE Guidance Validation

***

The following is guidance to proceed X-SIGNATURE validation on Request Header Notify:

`SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP`

:::hint{type="warning"}
Information specific to the SNAP Notification API regarding the `Public_Key` will be provided by the NICEPAY team to the Merchant via email, because the `Public_Key` credential used in the SNAP Notification API is different from the SNAP Transaction API (Registration, Inquiry & Payment).

Please contact the Integration team through email ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) for further information or assistance.
:::

The following is the example of X-SIGNATURE result from the above guidance validation"

`mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq
NKMlZDpS+`



# Merchant Notification - API Payout (Disbursement) SNAP

***

| **API Endpoint** | `[merchant-domain]/api/v1.0/transfer/notify`                                                                                                                                                                                                                                                                                  |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **HTTP Method**  | `POST`                                                                                                                                                                                                                                                                                                                        |
| **Content-type** | `application/json`                                                                                                                                                                                                                                                                                                            |
| **Description**  | Transaction Result Notification (when success)<br /><br />If your system use firewall, add allow policy for NICEPAY IP =<br />IP Public environtment Production:<br />`103.20.51.34`<br />`103.20.51.33`<br />`18.98.96.50`<br /><br />IP Public environtment Dev:<br />`103.20.51.39`<br />`103.20.51.40`<br />`18.98.96.54` |



## Request Notification Header Parameter

| **Parameter**  | **Type** | **Required** | **Description**                                                                                                                                                                   |
| -------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Type` | String   | Mandatory    | `Application / JSON`                                                                                                                                                              |
| `X-TIMESTAMP`  | String   | Mandatory    | Using ISO 8601 as timestamp format.<br />Transaction date time, in format `YYYYMMDDTHH:mm:ss+07:00`.<br />Time must be in GMT+7 (Jakarta time).<br />`2022-03-21T10:11:40+07:00`. |
| `X-CLIENT-KEY` | String   | Mandatory    | Unique Partner ID, Partner ID = Client ID                                                                                                                                         |
| `X-SIGNATURE`  | String   | Mandatory    | Signature will be generated by Merchant.<br />[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp)                                                                     |



## Request Notification Body Parameter

| **Parameter**                 | **Type** | **Length** | **Required** | **Description**                                                                                                                                                                         |
| ----------------------------- | -------- | ---------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `originalPartnerReferenc
eNo` | String   | 40         | Mandatory    | Original transaction identifier on consumer&#xD;<br />system                                                                                                                            |
| `originalReferenceNo`         | String   | 40         | Mandatory    | Original transaction identifier on service&#xD;<br />provider system                                                                                                                    |
| `latestTransactionStatus`     | String   | 2          | Mandatory    | Category code for the status of the&#xD;<br />transaction. [Payout Transaction Status](docId\:nVCLmByGXR5Uc_5qmyu7-)  Example :<br />`00`- Success<br />`03`- Pending<br />`09`- Failed |
| `transactionStatusDesc`       | Object   | 50         | Optional     | Description status transaction                                                                                                                                                          |
| `beneficiaryBankCode`         | String   | 4          | Mandatory    | Beneficiary [Bank Code - API SNAP](docId:5PxU_cbDXVy2bIIli8_cv)                                                                                                                         |
| `beneficiaryAccountNo`        | String   | 25         | Mandatory    | Beneficiary Account Number                                                                                                                                                              |
| `beneficiaryName`             | String   | 100        | Mandatory    | Beneficiary Name                                                                                                                                                                        |
| `amount`                      | Object   | Variable   | Mandatory    | Amount of transaction                                                                                                                                                                   |
| `value`                       | String   | 12         | Mandatory    | Value                                                                                                                                                                                   |
| `currency`                    | String   | 3          | Mandatory    | Currency                                                                                                                                                                                |
| `transactionDateTime`         | String   | 25         | Optional     | Transaction Date Using ISO-8601 Format<br />`YYYY-MM-DDTHH:MM:SS`                                                                                                                       |



## Response Notification Header Parameter

| **Parameter**  | **Type** | **Required** | **Description**                                                                                                                                                                   |
| -------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Type` | String   | Mandatory    | `Application / JSON`                                                                                                                                                              |
| `X-TIMESTAMP`  | String   | Mandatory    | Using ISO 8601 as timestamp format.<br />Transaction date time, in format `YYYYMMDDTHH:mm:ss+07:00`.<br />Time must be in GMT+7 (Jakarta time).<br />`2022-03-21T10:11:40+07:00`. |



## Response Notification Body Parameter

| **Parameter**     | **Type** | **Length** | **Required** | **Description**                                                              |
| ----------------- | -------- | ---------- | ------------ | ---------------------------------------------------------------------------- |
| `responseCode`    | String   | 7          | Mandatory    | [General Response Code and Message - API SNAP](docId\:bJr4kjAmZCKnlN-5zRnvW) |
| `responseMessage` | String   | 150        | Mandatory    | Response Message                                                             |



## Sample Post For Notification

:::CodeblockTabs
Sample Request Notification

```json
//HEADER SECTION
Content-type: application/json
X-TIMESTAMP: 2023-11-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-CLIENT-KEY: 82150823919040624621823174737537

{
  "originalPartnerReferenceNo": "2020102900000000000001",
  "originalReferenceNo": "TNICEPO07105202210141451109841",
  "latestTransactionStatus": "00",
  "transactionStatusDesc": "success",
  "beneficiaryBankCode": "BBBA",
  "beneficiaryAccountNo": "888801000003301",
  "beneficiaryName": "Yories Yolanda",
  "amount": {
    "value": "12345678.00",
    "currency": "IDR"
  },
  "transactionDateTime": "2019-07-03T12:08:56-07:00"
}
```

Sample Response Notification

```none
//HEADER SECTION
Content-type: application/json
X-TIMESTAMP: 2023-11-23T07:44:16+07:00

{
  "responseCode": "2000000",
  "responseMessage": "Success"
}
```
:::