---
title: Notification - API Payout (Disbursement) SNAP
slug: nicepay-api-snap-notification-payout-disbursement
description: Informasi tentang Notification - API Payout (Disbursement) SNAP yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/_eQDXdpH3P2iCP2CEaSjk_microsoftteams-image.png
icon: {"faIcon":"fa-solid fa-book"}
docTags:
createdAt: 2023-02-17T11:12:08.000Z
---
# Tentang Notification - API Payout (Disbursement) SNAP
***
API ini digunakan untuk mengirimkan notifikasi dari hasil transaksi yang dilakukan pada proses Payout atau Disbursement.
# Panduan Validasi X-SIGNATURE
***
Berikut adalah cara untuk melakukan validasi X-SIGNATURE pada Request Header Notify:
`SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP`
:::hint{type="warning"}
Informasi khusus API Notifikasi SNAP terkait kredensial `Public_Key` akan diberikan oleh tim NICEPAY kepada Merchant melalui email, karena kredensial `Public_Key` yang akan digunakan di API Notifikasi SNAP berbeda dengan API Transaksi SNAP (Registration, Inquiry & Payment).
Silakan menghubungi Tim Integrasi melalui email ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) untuk informasi atau bantuan lebih lanjut.
:::
Berikut adalah contoh hasil X-SIGNATURE dari cara validasi di atas:
`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)
If your system use firewall, add allow policy for NICEPAY IP =
IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`
IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` |
## Request Notification Header Parameter
| **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** |
| -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Type` | String | Mandatory | `Application / JSON` |
| `X-TIMESTAMP` | String | Mandatory | Using ISO 8601 as timestamp format.
Transaction date time, in format `YYYYMMDDTHH:mm:ss+07:00`.
Time must be in GMT+7 (Jakarta time).
`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.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) |
## Request Notification Body Parameter
| **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** |
| ----------------------------- | -------- | ---------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `originalPartnerReferenc
eNo` | String | 40 | Mandatory | Original transaction identifier on consumer
system |
| `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service
provider system |
| `latestTransactionStatus` | String | 2 | Mandatory | Category code for the status of the
transaction.
[Payout Transaction Status](docId\:XxlWrB0Q8XVkSMaO7ti9a) Example :
`00`- Success
`03`- Pending
`09`- Failed |
| `transactionStatusDesc` | Object | 50 | Optional | Description status transaction |
| `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) |
| `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
`YYYY-MM-DDTHH:MM:SS` |
## Response Notification Header Parameter
| **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** |
| -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Type` | String | Mandatory | `Application / JSON` |
| `X-TIMESTAMP` | String | Mandatory | Using ISO 8601 as timestamp format.
Transaction date time, in format `YYYYMMDDTHH:mm:ss+07:00`.
Time must be in GMT+7 (Jakarta time).
`2022-03-21T10:11:40+07:00`.
|
## Response Notification Body Parameter
| **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** |
| ----------------- | -------- | ---------- | ------------- | ---------------------------------------------------------------------------- |
| `responseCode` | String | 7 | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) |
| `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"
}
```
:::