Registration - API QRIS

about api for qris registration in {{the}} {{qris}} {{paymethod}} , {{customer}} s can use {{the}} same qr code for recurring {{payment}} s by {{customer}} s qr codes can also be used by cross channel {{paymethod}} s, such as for example, issuance of qr codes by {{nicepay}} in collaboration with shopeepay {{customer}} can use other {{ewallet}} application (ovo, gopay, and dana) or mobile banking other than shopeepay to {{proceed}} {{the}} {{payment}} with qr code real time {{notification}} will sent after {{customer}} finish {{the}} {{payment}} qr code recommends using white background for easy scanning {{please}} visit {{the}} docid\ ah5xsybmj1r1ywtjwlzpw {{section}} to learn general {{information}} about {{the}} {{qris}} {{paymethod}} api for qris registration the {{qris}} registration {{api}} aims to enable {{merchant}} s to register {{the}} {{api}} {{system}} for {{payment}} s on {{the}} {{merchant}} {{system}} and integrate it with {{the}} {{system}} from {{nicepay}} this step is carried out first so that {{the}} {{system}} knows that {{the}} {{merchant}} in question has been officially registered and can be connected to {{the}} {{qris}} {{paymethod}} from {{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 the following is a list of {{parameter}} s for requesting registration of {{the}} {{qris}} {{paymethod}} this {{parameter}} is used through {{the}} {{api}} {{testing}} platform as one of {{the}} stages so that {{the}} {{merchant}} 's {{system}} can be connected to {{service}} s from {{nicepay}} learn more about {{the}} general explanation of docid\ ah5xsybmj1r1ywtjwlzpw parameter type size description example / notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20230423100505 imid required required an 10 {{merchant}} id ionpaytest paymethod required required n 2 docid\ ek 0djw7nuhytcda4sa3p 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 docid 0upx1lyg1o2f4biu3ssp 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 shopid required for qris required for qris an 32 shop id {{nicepay}} additional information request for qris registration parameter type size description example / notes mitracd required required a 4 docid 0upx1lyg1o2f4biu3ssp qshp shopid required required n 12 shop id {{nicepay}} paymenexpdt n 6 qr expiry date qr {{paymentproduct}} expiry date ( yyyymmdd ) paymenexptm n 6 qr expiry time qr {{paymentproduct}} expiry time ( hh24miss ) parameters paymentexpdt and paymentexptm can be set on {{the}} {{merchant}} side with a length of time of 5 20 minutes response parameter for qris registration following are {{the}} response {{parameter}} s from {{the}} results of {{the}} request {{parameter}} s to register {{the}} {{qris}} {{paymethod}} parameter type size description example / notes resultcd n 4 docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest08202212071126251707 referenceno ans 40 {{merchant}} reference number ord54321 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 08 amt n 12 {{paymentproduct}} 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 docid\ qbeq29lj53z vbvxtvb7l 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 {{paymentproduct}} number null mitracd an 4 docid 0upx1lyg1o2f4biu3ssp 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 type size description mitracd a 4 docid 0upx1lyg1o2f4biu3ssp 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 in {{qris}} registration is useful for declaring what items will be checked out along with item details and {{the}} price per item parameter description example / notes count the total number of all card data 2 item it is divided into 4 kinds of {{parameter}} 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" } ] }