NICEPAY API
...
API QRIS
Registration - API QRIS
15 min
tentang api for qris registration pada , dapat menggunakan kode qr sama untuk berulang oleh kode qr juga dapat digunakan oleh lintas channel, seperti penerbitan kode qr oleh bekerja sama dengan shopeepay dapat menggunakan aplikasi lain (ovo, gopay, dan dana) atau mobile banking selain shopeepay untuk melakukan dengan kode qr notifikasi real time akan dikirimkan setelah menyelesaikan kode qr disarankan menggunakan background putih agar mudah dipindai kunjungi docid\ krbnurjoreow1yejzs3 q untuk mempelajari umum mengenai api for qris registration registrasi bertujuan supaya dapat mendaftarkan pada sisi agar ter dengan dari tahapan ini dilakukan pertama kali untuk melakukan pemeriksaan apakah sudah terdaftar secara resmi dan bisa terhubung dengan pada api url /nicepay/direct/v2/registration request method post post description merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/x www form urlencoded request parameter for qris registration berikut ini adalah daftar untuk melakukan request registrasi parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20230423100505 imid required required an 10 id ionpaytest paymethod required required n 2 docid\ iifmsruuw7j9vmwefjz97 08 currency required required a 3 currency idr amt required required n 12 amount 5 referenceno required required ans 40 's reference number ord54321 goodsnm required required an 100 goods name test transaction billingnm required required a 100 buyer name andi pamungkas billingphone required required n 15 buyer phone number 081234567890 billingemail required required ans 40 buyer e mail email\@merchant com billingcity required required a 50 buyer city jakarta billingstate required required a 50 billing state dki jakarta billingpostcd required required n 10 billing post number 12345 billingcountry required 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 required for cvs, e wallet, payloan,qris a 4 docid\ tm257gq3dxgzf98uz0l33 qshp userip required for cc, e wallet, payloan,qris required for cc, e wallet, payloan,qris an 15 user ip 127 0 0 1 dbprocessurl required required ans 255 notification url https //merchant com/dbprocessurl merchanttoken required required an 255 token 14b2d810fd2c2725bde0e747392bdd6353b5dcfd3807ccc7a0b5106bdd4af099 userip an 15 user ip address 127 0 0 1 shopid required for qris required for qris an 32 shop id additional information request for qris registration parameter tipe ukuran deskripsi contoh / catatan mitracd required required a 4 docid\ tm257gq3dxgzf98uz0l33 qshp shopid required required n 12 shop id paymenexpdt n 6 qr expiry qr expiry date ( yyyymmdd ) paymenexptm n 6 qr expiry qr expiry time ( hh24miss ) parameter paymenexpdt dan paymenexptm dapat di set pada sisi dengan lama waktu 5 20 menit response parameter for qris registration berikut adalah response parameter dari hasil request parameter untuk mendaftarkan parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message docid\ wpcemazro xvnxz 1zaib success txid an 30 transaction id ionpaytest08202212071126251707 referenceno ans 40 reference number ord54321 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 08 amt n 12 amount 5 transdt n 8 transaction date ( yyyymmdd ) 20230423 transtm n 6 transction time ( hh24miss ) 112625 description an 100 transaction description null bankcd a 4 docid\ ky4ppujot06atnie easf 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 payment number null mitracd an 4 docid\ tm257gq3dxgzf98uz0l33 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 tipe ukuran deskripsi mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 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 { "timestamp" "20230423100505", "imid" "ionpaytest", "paymethod" "08", "currency" "idr", "amt" "5", "referenceno" "ord54321", "goodsnm" "test transaction nicepay", "billingnm" "andi pamungkas", "billingphone" "081234567890", "billingemail" "email\@merchant com", "billingcity" "jakarta", "billingstate" "dki jakarta", "billingpostcd" "12345", "billingcountry" "indonesia", "dbprocessurl" "https //merchant com/dbprocessurl", "merchanttoken" "14b2d810fd2c2725bde0e747392bdd6353b5dcfd3807ccc7a0b5106bdd4af099", "paymentexpdt" "", "paymentexptm" "", "userip" "127 0 0 1", "cartdata" "{\\"count\\" 1,\\"item\\" \[{\\"img url\\" \\"http \\\\\\/\\\\\\/www jamgora com\\\\\\/media\\\\\\/avatar\\\\\\/noimage png\\",\\"goods name\\" \\"hoodie\\",\\"goods detail\\" \\"hoodie\\",\\"goods amt\\" \\"5\\"}]}", "mitracd" "qshp", "shopid" "nicepay" } json response { 	"resultcd" "0000", 	"resultmsg" "success", 	"txid" "ionpaytest08202212071126251707", 	"referenceno" "ord54321", 	"paymethod" "08", 	"amt" "5", 	"transdt" "20230423", 	"transtm" "112625", 	"description" null, 	"bankcd" null, 	"vacctno" null, 	"mitracd" "qshp", 	"payno" null, 	"currency" "idr", 	"goodsnm" "test transaction nicepay", 	"billingnm" "andi pamungkas", 	"vacctvaliddt" null, 	"vacctvalidtm" null, 	"payvaliddt" null, 	"payvalidtm" null, 	"requesturl" null, 	"paymentexpdt" "20221207", 	"paymentexptm" "113125", 	"qrcontent" "00020101021226590016id co shopee www011893600918000041566602064156660303ume52045399530336054045 005802id5913nicepay dummy6015kota jakarta se61051287062360520082022120711262558370708t00000016304740d", 	"qrurl" "https //mapi gw\ airpay co id/v3/merchant host/qr/download?qr=un74au2lzvwxiv9lpbqgpg21catmhngp0rvbeb9v6h" } 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\@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 pada registrasi berguna untuk mendeklarasikan item akan melalui checkout beserta rincian dan harga per item parameter deskripsi contoh / catatan count total jumlah dari keseluruhan cart data 2 item terbagi menjadi 4 macam , yaitu img url , goods name , goods detail , dan goods amt penjelasan rincian pada item parameter deskripsi contoh / catatan img url url gambar barang (ukuran 50px x 50px) htttps\ //www merchant com/image goods1 jpg goods name nama barang nama item 1 goods detail deskripsi detail barang detail item 1 goods amt harga barang 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" } ] }