NICEPAY API
...
Payment API
API GPN

Notification - API GPN

7min

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

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

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

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