NICEPAY API
...
API Version 2 (V2)
Checkout API

Payment - API Checkout

10min

Displays Payment Page from PaymentURL



When you successfully registers request on Registration - API Checkout, you will get response in form of paymentURL. To displays on Front-End's side, you are required to does paymentURL mapping at first with an additional s on URL, which is ?tXid= and completed by txid obtained in Registration - API Checkout response.

Consider following example:

Text


When Page is already appropriate, then your requested is ready to be paid by . You only needed to display link or embedded link on your website.

For with ShopeePay and OVO, we suggest your open through their mobile phone devices.

Successful Payment Page
Successful Payment Page


Parameter Format Payment Page

Parameter

Type

Size

Description

Remark

paymentURL

Required

ANS

14

 URL

https://nicepay.co.id/nicepay/redirect/v2/payment

tXid

Required

AN

30

Transaction ID



IONPAYTEST00202203211640309389



After Payment Handling



After is successfully done by your , a related to , either successful or failed, will be sent automatically to your through inputted callbackURL and dbProcessURL s during request through Registration - API Checkout.

 visit Notification - API Checkout for more detailed regarding dbProcessURL.

Response Parameters (CallbackUrl)

Parameter

Type

Size

Description

Remark

resultCd

N

4

Result Code

0000

resultMsg

AN

255

Result Message: Error Code

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST01202212141112221428



When success

referenceNo

ANS

40

Order Number

(empty)



When success

payMethod

E-Wallet, Payloan

N

2

01



When success

amt

N

12

Transaction Amount

10000



When success

currency

E-Wallet, Payloan

A

3

Currency

IDR



When success

payNo

CVS

N

20

 Number



goodsNm

E-Wallet, Payloan

AN

100

Goods Name

Testing Transaction



When success

billingNm

E-Wallet, Payloan

A

100

Billing Name

John Doe



When success

transDt

N

8

Transaction Date (YYYYMMDD)

20221212



When success

transTm

N

6

Transaction Time (HH24MISS)

121212



When success

description

AN

100

Transaction Description

Testing Transaction



When success

authNo

Only CC (Additional)

N

10

Approval Number

080623



When success

issuBankCd

Only CC

A

4

OTHR



When success

acquBankCd

Only CC

A

4

BMRI



When success

cardNo

Only CC

ANS

20

Card Number with Masking

453211*****1111



When success

timestamp

N

14

 Request Timestamp

20221212121212



When Success

merchantToken

CC

AN

255

 Token

2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6



When Success

cardExpYymm

CC

N

4

Card Expiration (YYMM)

2712



When Success

instmntMon

CC

N

2

Installment Month 1: 1 Month/Full Payment, if instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months

1



When Success

instmntType

CC

N

2

1



When Success

ccTransType

CC

AN

2

1: Normal

2: Recurring

3: Pre-Auth

4: Capture

1



When Success

recurringToken

Only CC (Additional)

AN

255

Recurring Token



vat

CC

N

12

Value Added Tax ()

fee

CC

N

12

Service Fee

notaxAmt

CC

N

12

Tax Fee Amount

mitraCd

Direct Debit, E-Wallet, Payloan

A

4

Mitra Code



bankVacctNo

VA

N

20

VA Number



Response will be sent through callBackurl with Content-type: application/json and method: POST Parameter.



Sample JSON for CallbackUrl


URL payment
Response CallBack




CallBack Handling API Checkout


Callback Handling Flow
Callback Handling Flow

  • The tXid won't be same as request hold. The capture will make sure that amount value being captured doesn't exceed funds owned.
  • When Callback received to your callbackUrl, we strongly recommend to verify Status using Status Inquiry - API Checkout.
  • CallBack Handling is very helpful to minimalize Fraud actions, we strongly recommend to verify callBack Handling.