NICEPAY provides a new service in QRIS payment method from cooperation with ShopeePay. By using this method, Customer will have the option to make payment via E-Wallet (ShopeePay, OVO, GoPay, and DANA). Real-Time Notification will be sent when the Customer has completed the payment.
Steps description:
API Endpoint | /nicepay/api/onePass.do |
|---|---|
Request Method application/x-www-form-urlencoded | POST |
Description | QRIS Payment API |
Merchant Token | SHA256(iMid+referenceNo+amt+merchantKey) |
Payment Method | 08 QRIS |
Parameter | Type | Size | Description | Example Value |
|---|---|---|---|---|
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
payMethod Required | N | 2 | 08 | |
currency Required | A | 3 | Currency | IDR |
amt Required | N | 12 | Goods Amount | 15000 |
referenceNo Required | ANS | 40 | Merchant Order Number | ordNo123124 |
goodsNm Required | AN | 100 | Goods Name | Test Goods |
billingNm Required | A | A | Billing Name | John Doe |
billingPhone Required | N | 15 | Billing Phone Number | 081249195 |
billingEmail Required | ANS | 40 | Billing E-Mail | test@merchant.com |
billingCity Required | A | 50 | Billing City | Jakarta |
billingState Required | A | 50 | Billing State | DKI Jakarta |
billingPostCd Required | N | 10 | Billing Post Number | 14350 |
billingCountry Required | A | 10 | Billing Country | Indonesia |
callBackUrl Required | ANS | 255 | Payment Result URL | https://merchant.com/callBackUrl |
dbProcessUrl Required | ANS | 255 | Payment Notif URL | https://merchant.com/dbProcessUrl |
description Required | AN | 100 | Description | test item |
merchantToken Required | AN | 255 | Merchant Token | 6cfccfc0046773c1b589d8e 98f8b596c284f3c70a4ecf8 6eba14c18944b74bcd |
userIP Required | ANS | 15 | User IP (Customer) | 127.0.0.1 |
cartData Required | JSON OBJECT | 4000 | Cart Data (JSON Format) | {} |
mitraCd Required | A | 4 | Mitra Code | QSHP |
shopId Required | AN | 32 | Shop ID | NICEPAY |
billingAddr | AN | 255 | Billing Address | Jln Cendrawasih |
deliveryNm | A | 30 | Delivery Name | John Doe |
deliveryPhone | N | 15 | Delivery Phone | 08125912342 |
deliveryAddr | AN | 100 | Delivery Address | Jln Merak |
deliveryEmail | ANS | 100 | Delivery E-Mail | test@merchant.com |
deliveryCity | A | 50 | Delivery City | Jakarta |
deliveryState | A | 50 | Delivery State | DKI Jakarta |
deliveryPostCd | A | 10 | Delivery Post Code | 14350 |
deliveryCountry | A | 10 | Delivery Country | Indonesia |
vat | N | 12 | VAT | 0 |
fee | N | 12 | Service Tax | 0 |
notaxAmt | N | 12 | Tax Free Amount | 0 |
reqDt | N | 8 | Request Date (YYYYMMDD) | 20160301 |
reqTm | N | 6 | Request Time (HH24MISS) | 135959 |
reqDomain | ANS | 100 | Request Domain | merchant.com |
reqServerIP | ANS | 15 | Request Server IP | 127.0.0.1 |
reqClientVer | ANS | 50 | Request Client Version | 1.0 |
userSessionID | AN | 100 | User Session ID | userSessionID |
userAgent | ANS | 100 | User Agent | Mozilla |
userLanguage | ANS | 2 | User Language | en-US |
Parameter | Type | Size | Description | Example / Notes |
|---|---|---|---|---|
resultCd | N | 4 | Result Code | 0000 |
resultMsg | AN | 255 | SUCCESS | |
tXid | AN | 30 | Transaction ID | IONPAYTEST08202104011206088687 |
referenceNo | ANS | 40 | Merchant Reference Number | ORDER2909 |
payMethod | N | 2 | 08 | |
amount | N | 12 | Payment Amount | 1000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20210401 |
transTm | N | 6 | Transaction Time (HH24MISS) | 120609 |
description | ANS | 100 | Transaction Description | null |
callbackUrl | ANS | 100 | Callback URL | https://merchant.com/api/callBackUrl |
paymentExDt | N | 6 | QR Payment Expired Date (YYYYMMDD) | 20210401 |
paymentExpTm | N | 6 | QR Payment Expired Time (HH24MISS) | 121109 |
currency | A | 3 | Currency | IDR |
goodsNm | AN | 100 | Goods Name | Merchant Goods 1 |
billingNm | N | 30 | Buyer Name | John Doe |
qrContent | ANS | 360 | QR String in Plain Text | 00020101021226580016ID.CO.SHOPEE.WWW01189360091800000169110205169110303UMI52041234530336054071000.005802ID5907NICEPAY6015KOTA JAKARTA PU61051234562360520082021040112060930000708T000000163041210 |
qrUrl | ANS | 360 | URL for QR Image, Valid for 5 minutes | https://api.uat.wallet.airpay.co.id/v3/merchant-host/qr/download?qr=9d0DmD3uqAVzLMNWz05b1ExK3GAX7yY07x3wg4OYKK |
By accessing this site, you are agree with the applicable terms and conditions.
Bank Indonesia already release API Standard relate to the Payment listed on Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 about Standar Nasional Open Application Interface Pembayaran (SNAP) Implementation.
As the form of suppport and compliance to Bank Indonesia Rules, NICEPAY drives all Merchant to conduct the migration to API SNAP BI.
All Merchants aim to complete the API SNAP BI migration on June 2024.