Registration - API QRIS

tentang api for qris registration pada {{metodebayar}} {{qris}} , {{merchant}} dapat menggunakan kode qr {{yang}} sama untuk {{pembayaran}} berulang oleh {{pelanggan}} kode qr juga dapat digunakan oleh {{metodebayar}} lintas channel, seperti penerbitan kode qr oleh {{nicepay}} bekerja sama dengan shopeepay {{pelanggan}} dapat menggunakan aplikasi {{ewallet}} lain (ovo, gopay, dan dana) atau mobile banking selain shopeepay untuk melakukan {{pembayaran}} dengan kode qr notifikasi real time akan dikirimkan setelah {{pelanggan}} menyelesaikan {{pembayaran}} kode qr disarankan menggunakan background putih agar mudah dipindai {{silakan}} kunjungi {{bagian}} qris docid\ krbnurjoreow1yejzs3 q untuk mempelajari {{informasi}} umum mengenai {{metodebayar}} {{qris}} api for qris registration {{api}} registrasi {{qris}} bertujuan supaya {{merchant}} dapat mendaftarkan {{sistem}} {{api}} pada sisi {{merchant}} agar ter {{integrasi}} dengan {{sistem}} dari {{nicepay}} tahapan ini dilakukan pertama kali untuk melakukan pemeriksaan apakah {{merchant}} sudah terdaftar secara resmi dan bisa terhubung dengan {{metodebayar}} {{qris}} pada {{sistem}} {{nicepay}} api url /nicepay/direct/v2/registration request method post post description {{qris}} {{paymentproduct}} {{api}} merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/x www form urlencoded request parameter for qris registration berikut ini adalah daftar {{parameter}} untuk melakukan request registrasi {{metodebayar}} {{qris}} parameter ini digunakan melalui platform pengujian {{api}} sebagai salah satu tahapan supaya {{sistem}} milik {{merchant}} dapat terhubung dengan {{layanan}} dari {{nicepay}} parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20230423100505 imid required required an 10 {{merchant}} id ionpaytest paymethod required required n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 08 currency required required a 3 currency idr amt required required n 12 amount 5 referenceno required required ans 40 {{merchant}} 's reference number ord54321 goodsnm required required an 100 goods name test transaction {{nicepay}} 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 {{indonesia}} paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) paymentexptm n n qr {{paymentproduct}} 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 mitra code 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 {{merchant}} token 14b2d810fd2c2725bde0e747392bdd6353b5dcfd3807ccc7a0b5106bdd4af099 userip an 15 user ip address 127 0 0 1 shopid required for qris required for qris an 32 shop id {{nicepay}} additional information request for qris registration parameter tipe ukuran deskripsi contoh / catatan mitracd required required a 4 mitra code docid\ tm257gq3dxgzf98uz0l33 qshp shopid required required n 12 shop id {{nicepay}} paymenexpdt n 6 qr expiry qr {{paymentproduct}} expiry date ( yyyymmdd ) paymenexptm n 6 qr expiry qr {{paymentproduct}} expiry time ( hh24miss ) parameter paymenexpdt dan paymenexptm dapat di set pada sisi {{merchant}} dengan lama waktu 5 20 menit response parameter for qris registration berikut adalah response parameter dari hasil request parameter untuk mendaftarkan {{metodebayar}} {{qris}} parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 result code docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message error code docid\ wpcemazro xvnxz 1zaib success txid an 30 transaction id ionpaytest08202212071126251707 referenceno ans 40 {{merchant}} reference number ord54321 paymethod n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 08 amt n 12 {{paymentproduct}} 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 bank code docid\ ky4ppujot06atnie easf null vacctno n 20 va number null currency a 3 currency idr goodsnm an 100 goods name test transaction {{nicepay}} 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 mitra code 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 {{paymentproduct}} expiry date ( yyyymmdd ) 20221207 paymentexptm n 6 qr {{paymentproduct}} 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 mitra code docid\ tm257gq3dxgzf98uz0l33 cancelamt n 12 cancel amount paymenttrxsn an 32 qr {{paymentproduct}} expiry date ( yyyymmdd ) paymenexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) shopid an 32 shop id paymenexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) canceltrxsn an 32 cancel transaction number userid an 128 {{qris}} 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 {{qris}} berguna untuk mendeklarasikan item {{yang}} akan melalui {{proses}} checkout beserta rincian dan harga per item parameter deskripsi contoh / catatan count total jumlah dari keseluruhan cart data 2 item terbagi menjadi 4 macam {{parameter}} , yaitu img url , goods name , goods detail , dan goods amt penjelasan rincian pada {{parameter}} 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" } ] }