Notification - API Payout (Disbursement) SNAP

9 min

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

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 ([email protected]) 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

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 Example : 00- Success 03- Pending 09- Failed
transactionStatusDesc	Object	50	Optional	Description status transaction
beneficiaryBankCode	String	4	Mandatory	Beneficiary Bank Code - API SNAP
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
responseMessage	String	150	Mandatory	Response Message

Sample Post For Notification

//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"
}