Notification Transaction - API E-Wallet (Direct Debit) SNAP
This API uses to send payment transaction notifications on the E-Wallet payment method with Direct Debit Host to Host Feature based on the SNAP BI standard..
The following is guidance to proceed X-SIGNATURE validation on Request Header Notify:
SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP
The following is the example of X-SIGNATURE result from the above guidance validation"
mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+
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 | Type | Required | Description |
|---|---|---|---|
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 | Request message signature (85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5) |
Parameter | Type | Length | Required | Description |
|---|---|---|---|---|
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 | 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 | Type | Required | Description |
|---|---|---|---|
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 | Type | Length | Required | Description |
|---|---|---|---|---|
responseCode | String | 7 | Mandatory | |
responseMessage | String | 150 | Mandatory | Response Message |