NICEPAY API
...
Payment - API Checkout
QRIS - API Checkout
17 min
about qris api checkout this uses by to requests a to for method using process flow qris process flow steps description the does the sends data checkout to the sends request checkout using registration to does registration redirects to displays to the chooses the scan qr and send result to does sends note result to sends or message to updates sends dbprocessurl to receives request inquiry to receives request sends inquiry response to receives final sends result to before making an calls for docid\ edzoz4vkv 1afv7hzbq5y , execute transaction registration first nicepay secure payment page secure payment page the image above is a sample of procedures with method using secure page the can't go back to secure after choosing because qr code has already been generated successfully and is ongoing if needs to be changed, must re create starting from initial qris secure payment page after choosing method, qr code will appear on next the can scan code directly by following docid\ m3usaoojr3czlr0uufiwb or download image firsthand through download qr image success secure payment page if qr code hasn't been used on but has already expired, must repeat generated qr code by returning to first api checkout transaction payment api url /nicepay/redirect/v2/payment request method redirect get header content type application/form urlencoded request parameter for qris api checkout (callbackurl) the following are request parameter lists for on parameter tipe ukuran deskripsi contoh / catatan paymenturl required required url 14 url https //www nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id ionpaytest00202103191252519205 response parameter for qris api checkout (callbackurl) parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id (key from ) testtest0300202008070951284276 when success referenceno ans 40 order number ord20200807090809 when success amount n 12 transaction amount 1000 when success transdt n 8 registration date ( yyyymmdd ) 20200808 when success transtm n 6 registration time ( hh24miss ) 120000 when success description an 100 transaction description this is testing transaction when success authno n 10 approval number 1234567890 when success β only cc (additional) recurringtoken an 255 recurring token 5b949971aea6d468bebef20fec7b067abde88e52a4520925cd28dfa840ce5abc when success β only cc (additional) cardno ans 20 card number with masking 420192 2327 when success β only cc acqubankcd a docid\ qbeq29lj53z vbvxtvb7l bmri when success β only cc issubankcd a docid\ qbeq29lj53z vbvxtvb7l othr when success β only cc vat n 12 number 0 when success , cc fee n 12 service fee 0 when success , cc notaxamt n 12 tax free amount 0 when success , cc bankcd a 4 docid\ qbeq29lj53z vbvxtvb7l bmri mitracd a 4 docid 0upx1lyg1o2f4biu3ssp ovoe when success , , bankvacctno n 20 va number 447770956314286 when success β va payno n 20 number 9041071059504308 when success β cvs currency a 3 currency idr when success β , goodsnm an 100 goods name testing transaction when success β , billingnm a 100 billing name ionpay network testing when success β , paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 03 when success β , note the response will be sent through callbackurl with content type application/json and method post parameter sample parameter for qris api checkout (callbackurl) on in , response from request that gets hit is callback url request parameter curl curl x get "https //www merchant com/callbackurl?cctranstype=1\&fee=0\&txid=ionpaytest00202212201540174369\&amt=1000\¬axamt=0\&cardno=46161111 1111\&issubankcd=bmri\&matchcl=1\&preauthtoken=null\&cardexpyymm=2603\&acqubanknm=mandiri\&paymethod=01\¤cy=idr\&instmntmon=1\&cc trans type=1\&issubanknm=mandiri\&merchanttoken=dc1dd9e57ff6c4db341654ae31e623cab4d4d8057b2d0b58bef43ccb0da3b494\&goodsnm=goods+for+testing+credit+card\&referenceno=ordno20221220151243\&authno=174300\&transtm=154017\&cpguaranteeablestatus=null\&recurringtoken=null\&vat=0\&instmnttype=1\&billingnm=john+doe\&acqubankcd=bmri\&transdt=20221220\&status=0" callback parameter response callback resultcd=0000 resultmsg=success txid=ionpaytest00202212211103524783 referenceno=orderku345 paymethod=09 amt=12000 billingnm=john+doe authno=150367 cardno=62210082 0590 acqubankcd=artj issubankcd=artj acqubanknm=artajasa issubanknm=artajasa callback handling api checkout transaction payment when your callback already received callbackurl , we recommended to do verification using docid 7thqvphz6emwezw5 d4an callback handling is very important to minimize fraud act, we highly recommend to do verification using callback parameter url callback https //merchant com/callback nicepay?resultcd=0000\&resultmsg=success\&txid=ionpaytest00202212211103524783\&referenceno=orderku345\&paymethod=09\&amt=12000\&billingnm=john+doe\&authno=150367\&cardno=62210082 0590\&acqubankcd=artj\&issubankcd=artj\&acqubanknm=artajasa\&issubanknm=artajasa response callback resultcd=0000 resultmsg=success txid=ionpaytest00202212211103524783 referenceno=orderku345 paymethod=09 amt=12000 billingnm=john+doe authno=150367 cardno=62210082 0590 acqubankcd=artj issubankcd=artj acqubanknm=artajasa issubanknm=artajasa