NICEPAY API
...
Payment API
API GPN

Notification - API GPN

7min

About API GPN Notification



 provides push s via dbProcessUrl . The needs to reassure there is no Blacklist IP and should Whitelist IP to get push only from 's 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



When your dbProcessUrl received a , strongly encourage s to verify using Status Inquiry - API GPN.

Parameter

Type

Size

Description

Example / Notes

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

Issuing Bank Code

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

Payment Method Code

09

currency

A

3

Currency

IDR

instmntMon

Required for CC

N

2

Installment Month Required for CC

1

issuBankNm

A

255

Issuing Name

Mandiri

merchantToken

AN

255

 Token

8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823

goodsNm

AN

100

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

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

Type

Size

Description

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)



The Token received by Notification Endpoint must compare internally to prevent fake/invalid s.

💡Example Case:

For example, you have a merchantKey that is used to generate a token, which is 1234. When merchantToken generated by is known, it is abcd, while merchantToken obtained in is abdd. Then is considered fake/invalid.



Sample for GPN Notification


Sample POST for GPN Notification