QRIS - API Checkout

15min

Tentang QRIS - API Checkout 
﻿
﻿﻿ ini digunakan oleh ﻿ untuk melakukan pengajuan ﻿ ﻿ kepada ﻿.
﻿
Alur Proses
﻿
Alur Proses QRIS
﻿
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 ﻿.
﻿
NICEPAY Secure Payment Page
﻿
Secure Payment Page
﻿
﻿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.
QRIS - Secure Payment Page
﻿
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 Checkout Transaction Payment
﻿
API url
/nicepay/redirect/v2/payment
Request Method 
Redirect-GET
Header
Content-Type: application/Form-UrlEncoded
﻿
Request Parameters for Payment
﻿
Berikut adalah daftar Request Parameter untuk ﻿ ﻿ ﻿ pada ﻿ ﻿.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
paymentURL  
﻿Required﻿
URL
14
﻿﻿ URL
﻿
﻿https://www.nicepay.co.id/nicepay/redirect/v2/payment
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
-
﻿Acquiring Bank Code﻿﻿
BMRI
﻿
When success – Only CC
issuBankCd
A
-
﻿Issuing Bank Code﻿﻿
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
﻿Payment Method Code﻿ 
03
﻿
When success – ﻿, ﻿ 
Catatan: Response ﻿ akan dikirimkan melalui callBackurl dengan  Content-type: application/x-www-form-urlencoded dan metode: POST Parameter.
﻿
Sample Parameter for CallbackUrl API Checkout Payment
﻿
Pada ﻿ saat Checkout, response dari request ﻿ di-hit adalah Callback URL.
Url Request
https://www.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202103191252519205
https://www.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202103191252519205
﻿
﻿
CallBack Handling API Checkout Payment
﻿
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.
Alur CallBack Handling
﻿
Response CallBack
Url Callback
https://merchant.com/callback-nicepay?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST00202212211103524783&referenceNo=ORDERKU345&payMethod=09&amt=12000&billingNm=John+Doe&authNo=150367&cardNo=62210082****0590&acquBankCd=ARTJ&issuBankCd=ARTJ&acquBankNm=Artajasa&issuBankNm=Artajasa
https://merchant.com/callback-nicepay?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST00202212211103524783&referenceNo=ORDERKU345&payMethod=09&amt=12000&billingNm=John+Doe&authNo=150367&cardNo=62210082****0590&acquBankCd=ARTJ&issuBankCd=ARTJ&acquBankNm=Artajasa&issuBankNm=Artajasa
﻿
﻿

API url	/nicepay/redirect/v2/payment
Request Method	Redirect-GET
Header	Content-Type: application/Form-UrlEncoded

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
paymentURL Required	URL	14	URL	https://www.nicepay.co.id/nicepay/redirect/v2/payment
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	-	Acquiring Bank Code	BMRI When success – Only CC
issuBankCd	A	-	Issuing Bank Code	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	Payment Method Code	03 When success – ,

Payloan - API Checkout

GPN - API Checkout

QRIS - API Checkout

Tentang QRIS - API Checkout

Alur Proses

NICEPAY Secure Payment Page

API Checkout Transaction Payment

Request Parameters for Payment

Response Parameters (CallbackUrl) - Payment

Sample Parameter for CallbackUrl API Checkout Payment

CallBack Handling API Checkout Payment

Selamat Datang di NICEPAY DOCS