Registration - API QRIS

about api for qris registration in , s can use same qr code for recurring s by s qr codes can also be used by cross channel s, such as for example, issuance of qr codes by in collaboration with shopeepay can use other application (ovo, gopay, and dana) or mobile banking other than shopeepay to with qr code real time will sent after finish qr code recommends using white background for easy scanning visit docid\ ah5xsybmj1r1ywtjwlzpw to learn general about api for qris registration the registration aims to enable s to register for s on and integrate it with from this step is carried out first so that knows that in question has been officially registered and can be connected to from 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 the following is a list of s for requesting registration of this is used through platform as one of stages so that 's can be connected to s from learn more about 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 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 '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 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 token 14b2d810fd2c2725bde0e747392bdd6353b5dcfd3807ccc7a0b5106bdd4af099 shopid required for qris required for qris an 32 shop id 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 paymenexpdt n 6 qr expiry date qr expiry date ( yyyymmdd ) paymenexptm n 6 qr expiry time qr expiry time ( hh24miss ) parameters paymentexpdt and paymentexptm can be set on side with a length of time of 5 20 minutes response parameter for qris registration following are response s from results of request s to register 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 reference number ord54321 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 08 amt n 12 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 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 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 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 type size description mitracd a 4 docid 0upx1lyg1o2f4biu3ssp 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 in registration is useful for declaring what items will be checked out along with item details and price per item parameter description example / notes count the total number of all card data 2 item it is divided into 4 kinds of 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" } ] }