NICEPAY API
...
Checkout API
Registration - API Checkout

QRIS - API Checkout

16min

About QRIS - API Checkout



This uses by to requests a to for method using .



Process Flow


QRIS Process Flow
QRIS Process Flow


Steps description:

  1. The does .
  2. The sends data checkout to .
  3. The sends request checkout using Registration to .
  4.  does registration .
  5.  redirects to .
  6.  displays to .
  7. The chooses .
  8. The scan QR and send result to .
  9.  does .
  10.  sends note result to .
  11.  sends or message to .
  12.  updates .
  13.  sends dbProcessUrl to .
  14.  receives .
  15.  request inquiry to .
  16.  receives request.
  17.  sends inquiry response to .
  18.  receives final .
  19.  sends result to .

Before making an calls for Transaction Payment, execute Transaction Registration first.



NICEPAY Secure Payment Page


Secure Payment Page
Secure Payment Page


The image above is a sample of procedures with method using Secure Page.

The can't go back to Secure after choosing because QR code has already been generated successfully and is ongoing. If needs to be changed, must re-create starting from initial .

QRIS - Secure Payment Page
QRIS - Secure Payment Page


After choosing method, QR code will appear on next . The can scan code directly by following QRIS Payment Guide or download image firsthand through Download QR Image .

If QR code hasn't been used on but has already expired, must repeat generated QR code by returning to first.



API Checkout Transaction Payment



API url

/nicepay/redirect/v2/payment

Request Method

Redirect-GET

Header

Content-Type: application/Form-UrlEncoded



Request Parameters for Payment



The following are Request Parameter lists for on .

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

paymentURL

Required

URL

14

 URL



tXid

Required

AN

30

Transaction ID



IONPAYTEST00202103191252519205



Response Parameters (CallbackUrl) - Payment



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

Result Code

0000

resultMsg

AN

255

Result Message: Error Code

Success

tXid

AN

30

Transaction ID

(Key from )

TESTTEST0300202008070951284276



When success

referenceNo

ANS

40

Order Number

ord20200807090809



When success

amount

N

12

Transaction Amount

1000



When success

transDt

N

8

Registration Date (YYYYMMDD)

20200808



When success

transTm

N

6

Registration Time (HH24MISS)

120000



When success

description

AN

100

Transaction Description

This is Testing Transaction



When success

authNo

N

10

Approval Number

1234567890



When success – Only CC (Additional)

recurringToken

AN

255

Recurring Token

5b949971aea6d468bebef20fec7b067abde88e52a4520925cd28dfa840ce5abc



When success – Only CC (Additional)

cardNo

ANS

20

Card Number with Masking

420192**2327



When success – Only CC

acquBankCd

A

-

BMRI



When success – Only CC

issuBankCd

A

-

OTHR



When success – Only CC

vat

N

12

 Number

0



When success , CC

fee

N

12

Service Fee

0



When success , CC

notaxAmt

N

12

Tax Free Amount

0



When success , CC

bankCd

A

4

Bank Code

BMRI

mitraCd

A

4

Mitra Code

OVOE



When success , , 

bankVacctNo

N

20

VA Number

447770956314286



When success – VA

payNo

N

20

 number

9041071059504308



When success – CVS

currency

A

3

Currency

IDR



When success – ,

goodsNm

AN

100

Goods name

Testing Transaction



When success – , 

billingNm

A

100

Billing Name

IONPAY NETWORK TESTING



When success – ,

payMethod

N

2

03



When success – , 

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



Sample Parameter for CallbackUrl API Checkout Payment



On in , response from request that gets hit is Callback URL.

Url Request




CallBack Handling API Checkout Payment



When Your callback already received callbackUrl, we recommended to do verification using Status Inquiry - API Checkout.

CallBack Handling is very important to minimize Fraud act, we highly recommend to do verification using callBack parameter.

Callback Handling Flow
Callback Handling Flow

Response CallBack
Url Callback