NICEPAY API
...
Payment API
API GPN

Notification - API GPN

7 min

Tentang API GPN Notification



 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



Notification Parameter GPN Notification



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

Credit Card Transaction Type 

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

Issuing Bank Code

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

Payment Method Code

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

Installment Type Code

2

billingNm

A

100

Buyer Name

Buyer Name

John+Doe

acquBankCd

A

4

Acquiring Bank Code

BNIN

transDt

N

8

Transaction Date (YYYYMMDD)

20221214

status

A

1

Deposit Status: Notification Status Code

0 : Deposit

1 : Reversal

0



Additional Parameter for Others Payment Method Notification



Parameter

Tipe

Ukuran

Deskripsi

mitraCd

A

4

Mitra Code

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.



Sample for GPN Notification


Sample POST for GPN Notification




Updated 18 Sep 2024
Did this page help you?
PREVIOUS
Status Inquiry - API GPN
NEXT
Cancel - API GPN
Docs powered by Archbee