Notification Transaction - API E-Wallet (Direct Debit) SNAP

11 min

Tentang Notification Transaction - API E-Wallet (Direct Debit) SNAP

API ini digunakan untuk mengirimkan notifikasi transaksi pembayaran pada metode pembayaran E-Wallet dengan Fitur Direct Debit Host to Host yang sesuai standar SNAP.

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 E-Wallet (Direct Debit) SNAP

Service Code	56
API Endpoint	[merchant-domain]/api/v1.0/debit/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 Header Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP

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 Body Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
originalReferenceNo	String	40	Mandatory	Original transaction identifier on service provider system
originalPartnerReferenceNo	String	40	Mandatory	Original transaction identifier on consumer system
externalStoreId	String	32	Optional	Unique identifier of shop id in client system
amount	Object	Variable	Mandatory	Amount of transaction
value	String	12	Mandatory	Value
currency	String	3	Mandatory	Currency
latestTransactionStatus	String	2	Mandatory	Category code for the status of the transaction. Example : 00- Success 06- Failed
transactionStatusDesc	String	50	Optional	Description status transaction
additionalInfo	Object	Variable	Mandatory	Additional information
transactionDateTime	String	25	Optional	Transaction Date Using ISO-8601 Format YYYY-MM-DDTHH:MM:SS
mitraCd	String	4	Mandatory	Mitra Code - API SNAP Example : OVO : OVOE Link Aja : LINK DANA : DANA ShopeePay : ESHP
goodsNm	String	200	Mandatory	Goods Name
billingNm	String	100	Mandatory	Buyer Name
billingPhone	String	20	Mandatory	Buyer Phone Number

Response Header Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP

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 Body Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
responseCode	String	7	Mandatory	General Response Code and Message - API SNAP
responseMessage	String	150	Mandatory	Response Message

Sample Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP

Request Parameter

curl -X POST \
  'https://merchant.com/api/v1.0/debit/notify' \
  -H 'Content-type: application/json' \
  -H 'X-TIMESTAMP: 2023-11-23T07:44:11+07:00' \
  -H 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \
  -H 'X-CLIENT-KEY: 82150823919040624621823174737537' \
  -d '{"originalPartnerReferenceNo":"2020102977770000000009","originalReferenceNo":"TNICEEW05108202210141451109841","amount":{"value":"10000.00","currency":"IDR"},"latestTransactionStatus":"00","transactionStatusDesc":"Success","externalStoreId":"91863213913112","additionalInfo":{"transactionDateTime":"2019-07-03T12:08:56-07:00","mitra_cd":"DANA","goodsNm":"Merchant Goods 1","billingNm":"Buyer Name","billingPhone":"02112345678"}}'

Response Parameter

{
  "responseCode": "2005600",
  "responseMessage": "Success"
}