NICEPAY API
...
Payment API - SNAP
API E-Wallet (Direct Debit) SN...

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

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

Request message signature

(85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5)



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

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

responseMessage

String

150

Mandatory

Response Message



Sample Post For Notification

Sample Request Notification
Sample Response Notification