NICEPAY API
...
Checkout API
Payment - API Checkout
Virtual Account - API Checkout
15 min
about virtual account api checkout this {{api}} uses by {{merchant}} s to request {{payment}} to {{nicepay}} with a {{va}} {{paymethod}} using {{checkoutproduct}} {{api}} flow process steps description the {{customer}} performs {{checkout}} the {{customer}} sends {{checkout}} data to {{the}} {{merchant}} the {{merchant}} requests {{checkout}} using registration {{api}} to {{nicepay}} {{nicepay}} redirects {{the}} {{merchant}} to {{payment}} {{page}} the {{merchant}} sends {{nicepay}} 's {{payment}} {{page}} to {{the}} {{customer}} the {{customer}} chooses {{the}} {{paymethod}} the {{customer}} makes {{the}} {{payment}} using va to {{bank}} {{bank}} {{proceed}} s {{the}} {{payment}} {{bank}} sends {{the}} {{payment}} result to {{the}} {{customer}} {{bank}} sends {{payment}} {{notification}} to {{nicepay}} {{nicepay}} updates {{the}} {{status}} of {{payment}} {{nicepay}} sends dbprocessurl {{notification}} to {{the}} {{merchant}} the {{merchant}} receives {{the}} {{status}} the {{merchant}} requests inquiry {{status}} to {{nicepay}} {{nicepay}} receives {{the}} request {{nicepay}} sends {{the}} response of inquiry {{status}} to {{the}} {{merchant}} the {{merchant}} receives {{the}} final {{status}} the {{merchant}} sends {{the}} {{transaction}} result {{page}} to {{the}} {{customer}} nicepay secure payment page {{please}} visit {{the}} va payment guide {{page}} to be able to provide your {{customer}} with {{payment}} guide on {{the}} {{va}} method the image above is a {{payment}} sample with {{va}} method using {{nicepay}} secure {{paymentproduct}} page {{please}} directs your {{customer}} to choose {{paymethod}} options for atm/ {{bank}} transfer on {{nicepay}} 's {{payment}} {{page}} to {{proceed}} {{va}} {{transaction}} after choosing {{the}} method with {{bank}} transfer, your {{customer}} will provide with {{bank}} lists that can choose to continue {{the}} {{payment}} {{process}} api checkout transaction payment checkout transaction {{paymentproduct}} {{api}} for {{va}} use to request registration and {{payment}} api url /nicepay/redirect/v2/payment request method redirect get header content type application/form urlencoded request parameters for checkout payment virtual account parameter type size description remark paymenturl required required ans 14 {{paymentproduct}} url https //dev nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id ionpaytest00202212231003086046 response parameters (callbackurl) checkout payment virtual account parameter type size description remark resultcd n 4 result code 0000 resultmsg an 255 result message error code success bankvacctno n 30 {{va}} number 111111101003086046 when success txid an 30 transaction id ionpaytest00202212231003086046 when success referenceno ans 40 order number ordno20221223101289 when success amount n 12 transaction amount 10000 when success transdt n 8 transaction date ( yyyymmdd ) 20221223 when success transtm n 6 transaction time ( hh24miss ) 100308 when success bankcd a 4 mitra code cena when success description an 100 transaction description testing+transaction+virtual+account when success note response {{parameter}} will be sent through callbackurl with content type application/json and method post parameter sample parameter for callbackurl api checkout payment virtual account on {{the}} {{payment}} when {{checkoutproduct}} , {{the}} response from {{the}} request that got hit is a callback url url request https //dev nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202212231003086046 url callback https //www merchant com/callbackurl?resultcd=0000\&resultmsg=success\&bankvacctno=111111101003086046\&txid=ionpaytest00202212231003086046\&referenceno=ordno20221223101289\&transdt=20221223\&transtm=100308\&amount=10000\&bankcd=cena\&description=testing+transaction+virtual+account response callback resultcd=0000 resultmsg=success bankvacctno=111111101003086046 txid=ionpaytest00202212231003086046 referenceno=ordno20221223101289 transdt=20221223 transtm=100308 amount=10000 bankcd=cena description=testing+transaction+virtual+account callback handling api checkout payment virtual account 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 url callback "callbackurl" "https //www merchant com/callbackurl/" response callback resultcd 0000 resultmsg\ success bankvacctno 111111101452274313 txid\ ionpaytest00202212201452274313 referenceno\ ordno20221220141258 transdt 20221220 transtm 144009 amount 10000 bankcd\ cena description\ testing api