QRIS - API Checkout
This uses by to requests a to for method using .
Steps description:
- The does .
- The sends data checkout to .
- The sends request checkout using Registration to .
- does registration .
- redirects to .
- displays to .
- The chooses .
- The scan QR and send result to .
- does .
- sends note result to .
- sends or message to .
- updates .
- sends dbProcessUrl to .
- receives .
- request inquiry to .
- receives request.
- sends inquiry response to .
- receives final .
- sends result to .
Before making an calls for Transaction Payment, execute Transaction Registration first.
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 .
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 url | /nicepay/redirect/v2/payment |
|---|---|
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
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 |
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.
On in , response from request that gets hit is Callback URL.
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.
