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

9min

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 BI
﻿
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 (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 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
103.20.51.0/24
103.117.8.0/24
﻿
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
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 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
Sample Request Notification
Sample Response Notification
//HEADER SECTION
Content-type: application/json
X-TIMESTAMP: 2023-11-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-CLIENT-KEY: 82150823919040624621823174737537

{
  "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"
  }
}
//HEADER SECTION
Content-type: application/json
X-TIMESTAMP: 2023-11-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-CLIENT-KEY: 82150823919040624621823174737537

{
  "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"
  }
}
﻿

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 103.20.51.0/24 103.117.8.0/24

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

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

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.

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

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

Payout API (Disbursement) - SNAP

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

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

Panduan Validasi X-SIGNATURE

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

Request Notification Header Parameter

Request Notification Body Parameter

Response Notification Header Parameter

Response Notification Body Parameter

Sample Post For Notification

Selamat Datang di NICEPAY DOCS