NICEPAY API
...
API Versi 1
V1 Enterprise
QRIS - V1 Enterprise
8 min
tentang qris {{nicepay}} menyediakan {{layanan}} baru dalam {{metodebayar}} {{qris}} dari kerja sama dengan shopeepay dengan menggunakan metode ini, {{pelanggan}} akan memiliki pilihan untuk melakukan {{pembayaran}} melalui {{ewallet}} (shopeepay, ovo, gopay, dan dana) notifikasi real time akan dikirimkan setelah {{pelanggan}} menyelesaikan {{pembayaran}} harap background kode qr menggunakan warna putih agar mudah dipindai qris flow v1 {{merchant}} melakukan request ke {{api}} register {{nicepay}} {{merchant}} menampilkan qr code and memberitahukan langkah {{pembayaran}} ke {{pelanggan}} {{pelanggan}} akan scan qr, dan melakukan autentikasi untuk {{pembayaran}} {{nicepay}} akan memeriksa {{status}} {{pembayaran}} , lalu mengirimkan notifikasi {{merchant}} mengolah {{notifikasi}} {{yang}} didapatkan transaction flow deskripsi langkah {{pelanggan}} melakukan checkout pesanan kepada {{merchant}} {{merchant}} melakukan pendaftaran checkout melalui {{api}} registration ( /nicepay/api/onepass do ) kepada {{nicepay}} {{nicepay}} mengajukan {{pembayaran}} pesanan kepada {{mitra}} {{qris}} {{mitra}} {{qris}} melakukan generate kode qr {{mitra}} {{qris}} mengirimkan response qr kepada {{nicepay}} {{nicepay}} mengirimkan response qr kepada {{merchant}} {{merchant}} menampilkan qr kepada {{pelanggan}} {{pelanggan}} memindai qr dan menginisiasi {{pembayaran}} kepada {{mitra}} {{qris}} {{mitra}} {{qris}} menampilkan response {{pembayaran}} kepada {{pelanggan}} {{mitra}} {{qris}} mengirimkan push notificatio n kepada {{nicepay}} {{nicepay}} melakukan validasi {{notifikasi}} {{nicepay}} memeriksa {{status}} {{pembayaran}} kepada {{mitra}} {{qris}} {{mitra}} {{qris}} mengirimkan response {{status}} {{pembayaran}} kepada {{nicepay}} {{nicepay}} memperbaharui {{status}} {{nicepay}} mengirimkan push notification kepada {{merchant}} {{merchant}} mengajukan pemeriksaan {{status}} menggunakan check status {{api}} kepada {{nicepay}} {{nicepay}} mengirimkan response pemeriksaan {{status}} kepada {{merchant}} {{merchant}} menerima {{status}} akhir {{merchant}} mengirimkan konfirmasi upda te {{status}} kepada {{pelanggan}} qris registration api specifications qris registration api endpoint /nicepay/api/onepass do request method application/x www form urlencoded application/x www form urlencoded post post description {{qris}} {{paymentproduct}} {{api}} merchant token sha256( imid + referenceno + amt + merchantkey ) payment method 08 {{qris}} request parameter qris registration qris registration request parameter imid\ ionpaytest paymethod 08 currency\ idr amt 1000 referenceno\ order2909 goodsnm\ test transaction nicepay billingnm\ john doe billingphone 081234567890 billingemail\ email\@customer com billingcity\ jakarta billingstate\ dki jakarta billingpostcd 14350 billingcountry\ indonesia callbackurl\ https //merchant com/api/callbackurl dbprocessurl\ https //merchant com/api/dbprocessurl/notif mitracd\ qshp merchanttoken 4bfd36804a5ad4741256b64b3e0152b00de458ec8d75d04cc095f725cd14770c cartdata {"count" 1,"item" \[{"img url" "https //images com/image png","goods name" "shoe","goods detail" "shoe","goods amt" 1000}]} shopid\ nicepay userip 127 0 0 1 parameter tipe ukuran deskripsi contoh / catatan imid required required an 10 {{merchant}} id ionpaytest paymethod required required n 2 v1 nicepay code docid\ pnv6uw k42cisgzemke y 08 currency required required a 3 currency idr amt required required n 12 goods amount 15000 referenceno required required ans 40 {{merchant}} order number ordno123124 goodsnm required required an 100 goods name test goods billingnm required required a a billing name john doe billingphone required required n 15 billing phone number 081249195 billingemail required required ans 40 billing e mail test\@merchant com billingcity required required a 50 billing city jakarta billingstate required required a 50 billing state dki jakarta billingpostcd required required n 10 billing post number 14350 billingcountry required required a 10 billing country {{indonesia}} callbackurl required required ans 255 {{paymentproduct}} result url https //merchant com/callbackurl dbprocessurl required required ans 255 {{paymentproduct}} notif url https //merchant com/dbprocessurl description required required an 100 description test item merchanttoken required required an 255 {{merchant}} token 6cfccfc0046773c1b589d8e 98f8b596c284f3c70a4ecf8 6eba14c18944b74bcd userip required required ans 15 user ip ( {{customer}} ) 127 0 0 1 cartdata required required json object 4000 cart data (json format) {} mitracd required required a 4 v1 nicepay code docid\ pnv6uw k42cisgzemke y qshp shopid required 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 registration response qris registration qris registration response parameter { "resultcd" "0000", "resultmsg" "success", "txid" "ionpaytest08202104011206088687", "referenceno" "order2909", "paymethod" "08", "amount" "1000", "transdt" "20210401", "transtm" "120609", "description" null, "callbackurl" "https //merchant com/api/callbackurl", "paymentexpdt" "20210401", "paymentexptm" "121109", "qrcontent" "00020101021226580016id co shopee www01189360091800000169110205169110303umi52041234530336054071000 005802id5907nicepay6015kota jakarta pu61051234562360520082021040112060930000708t000000163041210", "qrurl" "https //api uat wallet airpay co id/v3/merchant host/qr/download?qr=9d0dmd3uqavzlmnwz05b1exk3gax7yy07x3wg4oykk", "currency" "idr", "goodsnm" "merchant goods 1", "billingnm" "john doe" } parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 v1 nicepay code docid\ pnv6uw k42cisgzemke y 0000 resultmsg an 255 v1 nicepay code docid\ pnv6uw k42cisgzemke y success txid an 30 transaction id ionpaytest08202104011206088687 referenceno ans 40 {{merchant}} reference number order2909 paymethod n 2 v1 nicepay code docid\ pnv6uw k42cisgzemke y 08 amount n 12 {{paymentproduct}} 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 {{paymentproduct}} expired date ( yyyymmdd ) 20210401 paymentexptm n 6 qr {{paymentproduct}} 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