QRIS - API Checkout

about qris api checkout this {{api}} uses by {{merchant}} to requests a {{payment}} to {{the}} {{nicepay}} for {{qris}} {{payment}} method using {{checkoutproduct}} {{api}} process flow steps description the {{customer}} does {{checkout}} the {{customer}} sends data checkout to {{merchant}} the {{merchant}} sends request checkout using {{api}} registration to {{nicepay}} {{nicepay}} does {{checkout}} registration {{process}} {{nicepay}} redirects {{merchant}} to {{nicepay}} {{payment}} {{page}} {{merchant}} displays {{nicepay}} {{page}} to {{the}} {{customer}} the {{customer}} chooses {{paymethod}} the {{customer}} scan qr and send {{the}} {{process}} result to {{qris}} {{partner}} {{qris}} {{partner}} does {{payment}} {{process}} {{qris}} {{partner}} sends {{payment}} note {{transaction}} result to {{the}} {{customer}} {{qris}} {{partner}} sends {{notification}} or {{payment}} message to {{nicepay}} {{nicepay}} updates {{payment}} {{status}} {{nicepay}} sends dbprocessurl {{notification}} to {{merchant}} {{merchant}} receives {{notification}} {{merchant}} request {{status}} inquiry to {{nicepay}} {{nicepay}} receives {{the}} request {{nicepay}} sends {{status}} inquiry response to {{merchant}} {{merchant}} receives final {{status}} {{merchant}} sends result {{page}} {{transaction}} to {{the}} {{customer}} before making an {{api}} calls for payment api checkout , execute {{the}} transaction registration first nicepay secure payment page the image above is a sample of {{checkout}} {{payment}} procedures with {{the}} {{qris}} method using {{the}} {{nicepay}} secure {{paymentproduct}} page the {{customer}} can't go back to {{the}} secure {{paymentproduct}} {{page}} after choosing {{the}} {{qris}} {{paymethod}} because {{the}} qr code {{transaction}} has already been generated successfully and is ongoing if {{the}} {{paymethod}} needs to be changed, {{the}} {{merchant}} must re create {{the}} {{transaction}} starting from {{the}} initial {{transaction}} after choosing {{the}} {{qris}} method, {{the}} qr code will appear on {{the}} next {{page}} the {{customer}} can scan {{the}} code directly by following {{the}} qris payment guide or download {{the}} image firsthand through {{the}} download qr image {{button}} if {{the}} qr code hasn't been used on {{the}} {{transaction}} but has already expired, {{the}} {{customer}} must repeat {{the}} generated qr code {{process}} by returning to {{the}} {{checkout}} {{page}} first api checkout transaction payment api url /nicepay/redirect/v2/payment request method redirect get header content type application/form urlencoded request parameters for payment the following are request parameter lists for {{qris}} {{paymentproduct}} {{api}} on {{checkoutproduct}} {{api}} parameter tipe ukuran deskripsi contoh / catatan paymenturl required required url 14 {{paymentproduct}} url https //www nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id ionpaytest00202103191252519205 response parameters (callbackurl) payment parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 result code 0000 resultmsg an 255 result message error code success txid an 30 transaction id (key from {{nicepay}} ) 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 bank code bmri when success – only cc issubankcd a bank code othr when success – only cc vat n 12 {{vat}} 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 bank code bmri mitracd a 4 mitra code ovoe when success {{directdebit}} , {{ewallet}} , {{payloan}} bankvacctno n 20 va number 447770956314286 when success – va payno n 20 {{paymentproduct}} number 9041071059504308 when success – cvs currency a 3 currency idr when success – {{ewallet}} , {{payloan}} goodsnm an 100 goods name testing transaction {{nicepay}} when success – {{ewallet}} , {{payloan}} billingnm a 100 billing name ionpay network testing when success – {{ewallet}} , {{payloan}} paymethod n 2 payment method code 03 when success – {{ewallet}} , {{payloan}} note the response {{parameter}} will be sent through callbackurl with content type application/json and method post parameter sample parameter for callbackurl api checkout payment on {{the}} {{payment}} in {{checkoutproduct}} , {{the}} response from {{the}} request that gets hit is {{the}} callback url url request https //www nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202103191252519205 callback handling api checkout payment when your callback already received callbackurl , we recommended {{the}} {{merchant}} to do {{the}} {{status}} verification using {{the}} status inquiry api checkout callback handling is very important to minimize {{the}} fraud act, we highly recommend {{the}} {{merchant}} to do {{the}} verification using 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 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