Notification - API GPN
mengirimkan push notification dikirim melalui dbProcessUrl . harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan push notification hanya dikirim dari server .
Request Method | POST |
|---|---|
Merchant Token | SHA256 ( iMid+ tXid + amt+ merchantKey) |
IP | 103.20.51.0/24 103.117.8.0/24 |
User-Agent | User-Agent: Jakarta Commons-HttpClient/3.1 |
Ketika diterima pada dbProcessUrl , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan Status Inquiry - API GPN.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
ccTransType | N | 2 | 1: Normal 2: Recurring 3: Pre-auth 4: Capture | When Success |
fee | N | 12 | Service Fee | 0 When Success, CC |
tXid | AN | 30 | Transaction ID | IONPAYTEST01202212141326511512 |
amt | N | 12 | Amount | 15000 |
notaxAmt | N | 12 | Tax-Free Amount | 0 |
cardNo | N | 20 | Card Number | 41111111****1111 |
issuBankCd | A | 4 | OTHR When success, CC | |
matchCl | N | 1 | Flag (Notification Match Amount Indicator) | 1 |
preauthToken | AN | 64 | Pre-Auth Token | null |
cardExpYymm | N | 4 | Card Expiry (YYMM) | 3112 |
acquBankNm | A | 255 | Acquiring Name | BNI |
payMethod | N | 2 | 09 | |
currency | A | 3 | Currency | IDR |
instmntMon Required for CC | N | 2 | Installment Month | 1 |
issuBankNm | A | 255 | Issuing Name | Mandiri |
merchantToken | AN | 255 | Token | 8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823 |
goodsNm | AN | 100 | Goods Name | Goods Name Payment+of+Invoice+No+20221214132651 |
referenceNo | ANS | 40 | Reference Number | 20221214132651 |
authNo | N | 10 | Approval Number | 511512 |
transTm | N | 6 | Transaction Time (HH24MISS) | 132651 |
cpGuaranteeableStatus | N | 4 | Status Guaranteeable | null |
recurringToken | AN | 64 | Recurring Token | null |
vat | N | 12 | | 0 When Success, CC |
instmntType | N | 2 | 2 | |
billingNm | A | 100 | Buyer Name | Buyer Name John+Doe |
acquBankCd | A | 4 | BNIN | |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221214 |
status | A | 1 | 0 |
Parameter | Tipe | Ukuran | Deskripsi |
|---|---|---|---|
mitraCd | A | 4 | |
payNo | N | 12 | Number |
payValidDt | N | 8 | Expiry Date (YYYYMMDD) |
payValidTm | N | 6 | Expiry Time (HH24MISS) |
receiptCode | ANS | 20 | Authorization Number |
mRefNo | AN | 18 | Reference Number |
depositDt | N | 8 | Deposit Date (YYYYMMDD) |
depositTm | N | 6 | Deposit Time (HH24MISS) |
Merchant Token diterima dari Notification, harus melakukan perbandingan kembali secara internal untuk mencegah palsu/tidak berlaku.
💡Contoh Kasus:
Misalnya, memiliki merchantKey digunakan untuk melakukan generate token, yaitu 1234. Ketika merchantToken di-generate diketahui adalah abcd, sementara merchantToken didapatkan pada adalah abdd, maka tersebut dianggap palsu/tidak berlaku.