QRIS - API Checkout
ini digunakan oleh untuk melakukan pengajuan kepada .
Deskripsi langkah:
- melakukan checkout.
- mengirimkan data kepada .
- mengirim pengajuan checkout menggunakan Registration kepada .
- melakukan pendaftaran checkout.
- mengalihkan menuju .
- menampilkan kepada .
- memilih .
- memindai QR dan mengirim hasil kepada .
- melakukan .
- mengirimkan hasil payment note kepada .
- mengirimkan atau pesan kepada
- memperbaharui .
- mengirimkan dbProcessUrl kepada .
- menerima .
- mengajukan inquiry kepada .
- menerima pengajuan.
- mengirim response inquiry kepada .
- menerima akhir.
- mengirimkan hasil kepada .
Gambar di atas adalah contoh Checkout dengan metode menggunakan Secure Page.
tidak dapat kembali ke Secure setelah memilih karena kode QR sudah berhasil dibuat dan sudah berjalan.
Apabila ingin memilih lain, maka wajib membuat ulang dari awal.
Setelah pilih metode dengan , kode QR akan muncul pada berikutnya. dapat langsung memindai kode tersebut dengan mengikuti panduan Panduan Bayar QRIS atau mengunduh gambar terlebih dahulu melalui Download QR Image.
Apabila kode QR belum berhasil dipakai untuk , akan tetapi sudah lebih dahulu kedaluwarsa, maka harus mengulang generate kode QR dengan kembali menuju checkout terlebih dahulu.
API url | /nicepay/redirect/v2/payment |
|---|---|
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
Berikut adalah daftar Request Parameter untuk pada .
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 | 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 | 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 – , |
Catatan: Response akan dikirimkan melalui callBackurl dengan Content-type: application/x-www-form-urlencoded dan metode: POST Parameter.
Pada saat Checkout, response dari request di-hit adalah Callback URL.
Saat Callback diterima callbackUrl , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan CallBack parameter.
