Registration - API QRIS

15min

About API for QRIS Registration  
﻿
In   , s can use  same QR code for recurring s by s. QR codes can also be used by cross-channel s, such as for example, issuance of QR codes by  in collaboration with ShopeePay. 
﻿ can use other  application (OVO, Gopay, and DANA) or mobile banking other than ShopeePay to    with QR code. Real-time  will sent after  finish  .
QR Code recommends using white background for easy scanning.
﻿ visit  QRIS﻿  to learn general  about   .
﻿
API for QRIS Registration   
﻿
The  Registration  aims to enable s to register    for s on    and integrate it with   from . This step is carried out first so that   knows that   in question has been officially registered and can be connected to    from .
API url
/nicepay/direct/v2/registration
Request Method 
﻿POST﻿
Description
﻿  
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format
application/x-www-form-urlencoded
﻿
Request Parameter for QRIS Registration   
﻿
The following is a list of s for requesting registration of   . This  is used through    platform as one of  stages so that  's  can be connected to s from . Learn more about  general explanation of QRIS﻿.
Parameter
Type
Size
Description
Example / Notes
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20230423100505
iMid
﻿Required﻿
AN
10
﻿ ID	
﻿
IONPAYTEST
payMethod
﻿Required﻿
N
2
﻿Payment Method Code﻿ 
﻿
08
currency
﻿Required﻿
A
3
Currency
﻿
IDR
amt 
﻿Required﻿
N
12
Amount
﻿
5
referenceNo
﻿Required﻿
ANS
40
﻿'s Reference Number	
﻿
ORD54321
goodsNm 
﻿Required﻿ ﻿
AN
100
Goods Name	
﻿
Test Transaction 
billingNm 
﻿Required﻿
A
100
Buyer Name	
﻿
Andi Pamungkas
billingPhone
﻿Required﻿
N
15
Buyer Phone Number
﻿
081234567890
billingEmail
﻿Required﻿
ANS
40
Buyer E-Mail	
﻿
[email protected]
billingCity
﻿Required﻿
A
50
Buyer City	
﻿
Jakarta
billingState
﻿Required﻿
A
50
Billing State	
﻿
DKI Jakarta
billingPostCd
﻿Required﻿
N
10
Billing Post Number	
﻿
12345
billingCountry
﻿Required﻿
A
10
Billing Country	
﻿
﻿ 
paymentExpDt
N
6
QR  Expiry Date (YYYYMMDD)	
﻿
paymentExpTm
N
N
QR  Expiry Time (HH24MISS)	
﻿
cartData 
JSONstring

4000
Cart Data
﻿
{"count":1,"item":[{"img_url":"http:\/\/www.jamgora.com\/media\/avatar\/noimage.png","goods_name":"Hoodie","goods_detail":"Hoodie","goods_amt":"5"}]}
mitraCd
﻿Required for CVS, E-Wallet, Payloan,QRIS﻿
A
4
﻿Mitra Code﻿ 
QSHP
userIP 
﻿Required for CC, E-Wallet, Payloan,QRIS﻿
AN
15
User IP
﻿
127.0.0.1

dbProcessUrl
﻿Required﻿
ANS
255
Notification URL	
﻿
https://merchant.com/dbProcessUrl
merchantToken
﻿Required﻿
AN
255
﻿ Token	
﻿
14b2d810fd2c2725bde0e747392bdd6353b5dcfd3807ccc7a0b5106bdd4af099
shopId
﻿Required for QRIS	
AN
32
Shop ID
﻿
﻿ 
﻿
Additional Information Request for QRIS Registration 
﻿


Parameter
Type
Size
Description
Example / Notes
mitraCd 
﻿Required﻿
A
4
﻿Mitra Code﻿ 
QSHP
shopId 
﻿Required﻿
N
12
Shop ID
﻿
paymenExpDt
N
6
QR Expiry Date
QR  Expiry Date (YYYYMMDD)
paymenExpTm
N
6
QR Expiry Time
QR  Expiry Time (HH24MISS)
Parameters paymentExpDt and  paymentExpTm can be set on   side with a length of time of 5 - 20 minutes.
﻿
Response Parameter for QRIS Registration
﻿
Following are  response s from  results of  request s to register   .
Parameter
Type
Size
Description
Example / Notes
resultCd
N
4
﻿Result Code﻿ 
0000
resultMsg
AN
255
Result Message: Error Code﻿ 
SUCCESS
tXid
AN
30
Transaction ID
IONPAYTEST08202212071126251707
referenceNo
ANS
40
﻿ Reference Number
ORD54321
payMethod
N
2
﻿Payment Method Code﻿ 
08
amt
N
12
﻿ Amount
5
transDt
N
8
Transaction Date (YYYYMMDD)
20230423
transTm
N
6
Transaction Time (HH24MISS)
112625
description
AN
100
Transaction Description
null
bankCd
A
4
﻿Bank Code﻿
null
vacctNo
N
20
VA Number
null
currency
A
3
Currency
IDR
goodsNm
AN
100
Goods Name
Test Transaction  
billingNm
A
100
Buyer Name
John Doe
vacctValidDt
N
8
VA Expiry Date (YYYYMMDD)
null
vacctValidTm
N
6
VA Expiry Time (HH24MISS)
null
payNo
N
12
﻿ Number
null
mitraCd
AN
4
﻿Mitra Code﻿ 
QSHP
payValidDt
N
8
Expiry Date (YYYYMMDD)
null
payValidTm
N
6
Expiry Time (HH24MISS)
null
requestURL
ANS
360
Request URL
null
paymentExpDt
N
6
QR  Expiry Date (YYYYMMDD)
20221207
paymentExpTm
N
6
QR  Expiry Time (HH24MISS)
144135
qrContent
ANS
360
QR String in Plain Text
00020101021226590016ID.CO.SHOPEE.WWW011893600918000041566602064156660303UME52045399530336054045.005802ID5913NICEPAY dummy6015KOTA JAKARTA SE61051287062360520082022120711262558370708T00000016304740D
qrUrl
ANS
360
URL for QR Image, Valid for 5 minutes
https://mapi.gw.airpay.co.id/v3/merchant-host/qr/download?qr=un74au2lzvWXiv9LpBQGPG21CaTMhNgP0rvBeb9V6h
﻿
Additional Response Parameters - QRIS
﻿
Parameter
Type
Size
Description
mitraCd
A
4
﻿Mitra Code﻿﻿
cancelAmt
N
12
Cancel amount
paymentTrxSn
AN
32
QR  Expiry Date (YYYYMMDD)
paymenExpDt
N
6
QR  Expiry Date (YYYYMMDD)
shopId
AN
32
Shop ID
paymenExpTm
N
6
QR  Expiry Time (HH24MISS)
cancelTrxSn
AN
32
Cancel Transaction Number
userId
AN
128
﻿ User ID Hash
﻿

Sample JSON for QRIS Registration   
﻿
JSON Request
JSON Response
Java Request
//QRIS Registration//
nicePay.setTimeStamp("20230423100505");
nicePay.setiMid("IONPAYTEST");
nicePay.setPayMethod("08");
nicePay.setCurrency("IDR");
nicePay.setAmt("5");
nicePay.setReferenceNo("ORD54321");
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken());
nicePay.setGoodsNm("Test Transaction Nicepay");
nicePay.setBillingNm("Andi pamungkas");
nicePay.setBillingPhone("081234567890");
nicePay.setBillingEmail("[email protected]");
nicePay.setBillingAddr("Jln. Raya Kasablanka Kav.88");
nicePay.setBillingCity("South Jakarta");
nicePay.setBillingState("DKI Jakarta");
nicePay.setBillingCountry("Indonesia");
nicePay.setBillingPostCd("12800");
nicePay.setDbProcessUrl("https://ptsv2.com/t/rizal/post");
nicePay.setMirtaCd("QSHP");
nicePay.setCardData("{\"count\":1,\"item\":[{\"img_url\":\"http:\\\/\\\/www.jamgora.com\\\/media\\\/avatar\\\/noimage.png\",\"goods_name\":\"Hoodie\",\"goods_detail\":\"Hoodie\",\"goods_amt\":\"5\"}]}");
nicePay.setShopId("NICEPAY");
nicePay.setPaymentExpDt("");
nicePay.setpaymentExpTm("");
// Request QRIS Registration
nicePay.qrisRegist();

// Response String //
System.out.println("Final Response String : " + nicePay.getResponseString());

String resultCd = nicePay.Get("resultCd");
String resultMsg = nicePay.Get("resultMsg");
String tXid = nicePay.Get("tXid");
String referenceNo = nicePay.Get("referenceNo");
String payMethod = nicePay.Get("payMethod");
String amt = nicePay.Get("amt");
String transDt = nicePay.Get("transDt");
String transTm = nicePay.Get("transTm");
String qrContent = nicePay.Get("qrContent");
String qrUrl = nicePay.Get("qrUrl");
//QRIS Registration//
nicePay.setTimeStamp("20230423100505");
nicePay.setiMid("IONPAYTEST");
nicePay.setPayMethod("08");
nicePay.setCurrency("IDR");
nicePay.setAmt("5");
nicePay.setReferenceNo("ORD54321");
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken());
nicePay.setGoodsNm("Test Transaction Nicepay");
nicePay.setBillingNm("Andi pamungkas");
nicePay.setBillingPhone("081234567890");
nicePay.setBillingEmail("email@merchant.com");
nicePay.setBillingAddr("Jln. Raya Kasablanka Kav.88");
nicePay.setBillingCity("South Jakarta");
nicePay.setBillingState("DKI Jakarta");
nicePay.setBillingCountry("Indonesia");
nicePay.setBillingPostCd("12800");
nicePay.setDbProcessUrl("https://ptsv2.com/t/rizal/post");
nicePay.setMirtaCd("QSHP");
nicePay.setCardData("{\"count\":1,\"item\":[{\"img_url\":\"http:\\\/\\\/www.jamgora.com\\\/media\\\/avatar\\\/noimage.png\",\"goods_name\":\"Hoodie\",\"goods_detail\":\"Hoodie\",\"goods_amt\":\"5\"}]}");
nicePay.setShopId("NICEPAY");
nicePay.setPaymentExpDt("");
nicePay.setpaymentExpTm("");
// Request QRIS Registration
nicePay.qrisRegist();

// Response String //
System.out.println("Final Response String : " + nicePay.getResponseString());

String resultCd = nicePay.Get("resultCd");
String resultMsg = nicePay.Get("resultMsg");
String tXid = nicePay.Get("tXid");
String referenceNo = nicePay.Get("referenceNo");
String payMethod = nicePay.Get("payMethod");
String amt = nicePay.Get("amt");
String transDt = nicePay.Get("transDt");
String transTm = nicePay.Get("transTm");
String qrContent = nicePay.Get("qrContent");
String qrUrl = nicePay.Get("qrUrl");
﻿
﻿
﻿Cart Data QRIS Registration﻿
﻿
CartData in  Registration is useful for declaring what items will be checked out along with item details and  price per item.
Parameter
Description
Example / Notes
Count
The total number of all card data
2
Item
It is divided into 4 kinds of s, namely img_url, goods_name, goods_detail and goods_amt
-
Detailed explanation on Item parameters
Parameter
Description
Example / Notes
img_url
Item Image URL (Size 50px x 50px)
htttps://www.merchant.com/image_goods1.jpg
goods_name
Name of goods
Nama Item-1
goods_detail
Detailed Description of Goods
Detail Item-1
goods_amt
Price of Goods
1000
﻿
cartData QRIS Registration
{
    "count": "2",  
    "item": [  
        {
            "img_url": "http://www.merchant.com/image_goods1.jpg",  
            "goods_name": "Item 1 Name",
            "goods_detail": "Item 1 Detail",
            "goods_amt": "1000"
        },  
        {
            "img_url": "http://www.merchant.com/image_goods2.jpg",
            "goods_name": "Item 2 Name",
            "goods_detail": "Item 2 Detail",
            "goods_amt": "1000"
        }  
        ] 
}
{
    "count": "2",  
    "item": [  
        {
            "img_url": "http://www.merchant.com/image_goods1.jpg",  
            "goods_name": "Item 1 Name",
            "goods_detail": "Item 1 Detail",
            "goods_amt": "1000"
        },  
        {
            "img_url": "http://www.merchant.com/image_goods2.jpg",
            "goods_name": "Item 2 Name",
            "goods_detail": "Item 2 Detail",
            "goods_amt": "1000"
        }  
        ] 
}
﻿
﻿

API url	/nicepay/direct/v2/registration
Request Method	POST
Description
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format	application/x-www-form-urlencoded

Parameter	Type	Size	Description	Example / Notes
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20230423100505
iMid Required	AN	10	ID	IONPAYTEST
payMethod Required	N	2	Payment Method Code	08
currency Required	A	3	Currency	IDR
amt Required	N	12	Amount	5
referenceNo Required	ANS	40	's Reference Number	ORD54321
goodsNm Required	AN	100	Goods Name	Test Transaction
billingNm Required	A	100	Buyer Name	Andi Pamungkas
billingPhone Required	N	15	Buyer Phone Number	081234567890
billingEmail Required	ANS	40	Buyer E-Mail	[email protected]
billingCity Required	A	50	Buyer City	Jakarta
billingState Required	A	50	Billing State	DKI Jakarta
billingPostCd Required	N	10	Billing Post Number	12345
billingCountry Required	A	10	Billing Country
paymentExpDt	N	6	QR Expiry Date (YYYYMMDD)
paymentExpTm	N	N	QR Expiry Time (HH24MISS)
cartData	JSONstring	4000	Cart Data	{"count":1,"item":[{"img_url":"http:\/\/www.jamgora.com\/media\/avatar\/noimage.png","goods_name":"Hoodie","goods_detail":"Hoodie","goods_amt":"5"}]}
mitraCd Required for CVS, E-Wallet, Payloan,QRIS	A	4	Mitra Code	QSHP
userIP Required for CC, E-Wallet, Payloan,QRIS	AN	15	User IP	127.0.0.1
dbProcessUrl Required	ANS	255	Notification URL	https://merchant.com/dbProcessUrl
merchantToken Required	AN	255	Token	14b2d810fd2c2725bde0e747392bdd6353b5dcfd3807ccc7a0b5106bdd4af099
shopId Required for QRIS	AN	32	Shop ID

Parameter	Type	Size	Description	Example / Notes
mitraCd Required	A	4	Mitra Code	QSHP
shopId Required	N	12	Shop ID
paymenExpDt	N	6	QR Expiry Date	QR Expiry Date (YYYYMMDD)
paymenExpTm	N	6	QR Expiry Time	QR Expiry Time (HH24MISS)

Parameter	Type	Size	Description	Example / Notes
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	SUCCESS
tXid	AN	30	Transaction ID	IONPAYTEST08202212071126251707
referenceNo	ANS	40	Reference Number	ORD54321
payMethod	N	2	Payment Method Code	08
amt	N	12	Amount	5
transDt	N	8	Transaction Date (YYYYMMDD)	20230423
transTm	N	6	Transaction Time (HH24MISS)	112625
description	AN	100	Transaction Description	null
bankCd	A	4	Bank Code	null
vacctNo	N	20	VA Number	null
currency	A	3	Currency	IDR
goodsNm	AN	100	Goods Name	Test Transaction
billingNm	A	100	Buyer Name	John Doe
vacctValidDt	N	8	VA Expiry Date (YYYYMMDD)	null
vacctValidTm	N	6	VA Expiry Time (HH24MISS)	null
payNo	N	12	Number	null
mitraCd	AN	4	Mitra Code	QSHP
payValidDt	N	8	Expiry Date (YYYYMMDD)	null
payValidTm	N	6	Expiry Time (HH24MISS)	null
requestURL	ANS	360	Request URL	null
paymentExpDt	N	6	QR Expiry Date (YYYYMMDD)	20221207
paymentExpTm	N	6	QR Expiry Time (HH24MISS)	144135
qrContent	ANS	360	QR String in Plain Text	00020101021226590016ID.CO.SHOPEE.WWW011893600918000041566602064156660303UME52045399530336054045.005802ID5913NICEPAY dummy6015KOTA JAKARTA SE61051287062360520082022120711262558370708T00000016304740D
qrUrl	ANS	360	URL for QR Image, Valid for 5 minutes	https://mapi.gw.airpay.co.id/v3/merchant-host/qr/download?qr=un74au2lzvWXiv9LpBQGPG21CaTMhNgP0rvBeb9V6h

Parameter	Type	Size	Description
mitraCd	A	4	Mitra Code
cancelAmt	N	12	Cancel amount
paymentTrxSn	AN	32	QR Expiry Date (YYYYMMDD)
paymenExpDt	N	6	QR Expiry Date (YYYYMMDD)
shopId	AN	32	Shop ID
paymenExpTm	N	6	QR Expiry Time (HH24MISS)
cancelTrxSn	AN	32	Cancel Transaction Number
userId	AN	128	User ID Hash

Parameter	Description	Example / Notes
Count	The total number of all card data	2
Item	It is divided into 4 kinds of s, namely img_url, goods_name, goods_detail and goods_amt	-

Parameter	Description	Example / Notes
img_url	Item Image URL (Size 50px x 50px)	htttps://www.merchant.com/image_goods1.jpg
goods_name	Name of goods	Nama Item-1
goods_detail	Detailed Description of Goods	Detail Item-1
goods_amt	Price of Goods	1000

API QRIS

Status Inquiry - API QRIS

Registration - API QRIS

About API for QRIS Registration

API for QRIS Registration

Request Parameter for QRIS Registration

Additional Information Request for QRIS Registration

Response Parameter for QRIS Registration

Additional Response Parameters - QRIS

Sample JSON for QRIS Registration

﻿Cart Data QRIS Registration﻿

Welcome to NICEPAY DOCS

Cart Data QRIS Registration