NICEPAY API
...
Payment API
API GPN

Notification - API GPN

7min

Tentang API GPN Notification



NICEPAY mengirimkan push notification yang dikirim melalui dbProcessUrl Merchant. Merchant harus memastikan tidak melakukan Blacklist IP NICEPAY dan melakukan Whitelist IP NICEPAY untuk mendapatkan push notification yang hanya dikirim dari server NICEPAY.

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 notifikasi diterima pada dbProcessUrl Anda, kami sangat menyarankan Merchant untuk melakukan verifikasi notifikasi 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

Payment 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

Payment Flag (Notification Match Amount Indicator)

1

preauthToken

AN

64

Pre-Auth Token

null

cardExpYymm

N

4

Card Expiry (YYMM)

3112

acquBankNm

A

255

Acquiring Bank Name

BNI

payMethod

N

2

09

currency

A

3

Currency

IDR

instmntMon

Required for CC

N

2

Installment Month

1

issuBankNm

A

255

Issuing Bank Name

Mandiri

merchantToken

AN

255

Merchant Token

8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823

goodsNm

AN

100

Goods Name

Goods Name

Payment+of+Invoice+No+20221214132651

referenceNo

ANS

40

Merchant 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

VAT

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

Payment 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 yang diterima dari Notification, Merchant harus melakukan perbandingan kembali secara internal untuk mencegah notifikasi palsu/tidak berlaku.

💡Contoh Kasus:

Misalnya, Anda memiliki merchantKey yang digunakan untuk melakukan generate token, yaitu 1234. Ketika merchantToken yang di-generate Merchant diketahui adalah abcd, sementara merchantToken yang didapatkan pada notifikasi adalah abdd, maka notifikasi tersebut dianggap palsu/tidak berlaku.



Sample for GPN Notification


Sample POST for GPN Notification