NICEPAY API
...
API Version 2 (V2)
Checkout API

Payment - API Checkout

10min
displays payment page from paymenturl when you successfully registers {{the}} {{transaction}} request on {{the}} registration api checkout docid 066dopsepwv3fgkypjzaf , you will get response in {{the}} form of paymenturl to displays {{payment}} {{page}} on {{the}} front end's side, you are required to does paymenturl mapping at first with an additional {{parameter}} s on {{the}} url, which is ?txid= and completed by txid obtained in {{the}} registration api checkout docid 066dopsepwv3fgkypjzaf response consider {{the}} following example paymenturl https //www nicepay co id/nicepay/redirect/v2/payment txid ionpaytest00202203211640309389 nicepay payment page https //www nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202203211640309389 when {{the}} {{paymentproduct}} page is already appropriate, then your requested {{transaction}} is ready to be paid by {{the}} {{customer}} you only needed to display {{the}} link or embedded link on your website for {{the}} {{ewallet}} {{paymethod}} with shopeepay and ovo, we suggest your {{customer}} open {{the}} {{paymethod}} through their mobile phone devices parameter format payment page parameter type size description remark paymenturl required required ans 14 {{paymentproduct}} url https //nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id ionpaytest00202203211640309389 after payment handling after {{the}} {{transaction}} is successfully done by your {{customer}} , a {{notification}} related to {{the}} {{status}} {{transaction}} , either successful or failed, will be sent automatically to your {{system}} through {{the}} inputted callbackurl and dbprocessurl {{parameter}} s during request through registration api checkout docid 1ivcsjrorn0g44yyx dpb {{please}} visit {{the}} notification api checkout docid 30h3gerjvbj epdfljl h {{page}} for more detailed {{information}} regarding dbprocessurl response parameters (callbackurl) parameter type size description remark resultcd n 4 result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message error code docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest01202212141112221428 when success referenceno ans 40 order number (empty) when success paymethod e wallet, payloan e wallet, payloan n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 01 when success amt n 12 transaction amount 10000 when success currency e wallet, payloan e wallet, payloan a 3 currency idr when success payno cvs cvs n 20 {{paymentproduct}} number goodsnm e wallet, payloan e wallet, payloan an 100 goods name testing transaction {{nicepay}} when success billingnm e wallet, payloan e wallet, payloan a 100 billing name john doe when success transdt n 8 transaction date ( yyyymmdd ) 20221212 when success transtm n 6 transaction time ( hh24miss ) 121212 when success description an 100 transaction description testing {{cc}} transaction when success authno only cc (additional) only cc (additional) n 10 approval number 080623 when success issubankcd only cc only cc a 4 bank code docid\ qbeq29lj53z vbvxtvb7l othr when success acqubankcd only cc only cc a 4 bank code docid\ qbeq29lj53z vbvxtvb7l bmri when success cardno only cc only cc ans 20 card number with masking 453211 1111 when success timestamp n 14 {{api}} request timestamp 20221212121212 when success merchanttoken cc cc an 255 {{merchant}} token 2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6 when success cardexpyymm cc cc n 4 card expiration ( yymm ) 2712 when success instmntmon cc cc n 2 installment month 1 1 month/full payment, if instmnttype null/1 3 3 months 6 6 months 12 12 months 1 when success instmnttype cc cc n 2 installment type code docid\ wfsinjxqc2s9yubbybpep 1 when success cctranstype cc cc an 2 payment status code docid 7pas vd5ylg4vdurmygwo 1 normal 2 recurring 3 pre auth 4 capture 1 when success recurringtoken only cc (additional) only cc (additional) an 255 recurring token vat cc cc n 12 value added tax ( {{vat}} ) fee cc cc n 12 service fee notaxamt cc cc n 12 tax fee amount mitracd direct debit, e wallet, payloan direct debit, e wallet, payloan a 4 mitra code docid\ tm257gq3dxgzf98uz0l33 bankvacctno va va n 20 va number response {{parameter}} will be sent through callbackurl with content type application/json and method post parameter sample json for callbackurl url payment https //nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202203211640309389 response callback { "resultcd" "0000", "resultmsg" "success", "txid" "ionpaytest01202212141112221428", "referenceno" "", "paymethod" "01", "amt" "10000", "transdt" "20221212", "transtm" "121212", "description" "testing credit card transaction", "authno" "080623", "issubankcd" "othr" "acqubankcd" "bmri", "cardno" "453211 1111", "goodsnm" "test transaction nicepay" "billingnm" "john doe", "currency" "idr", "timestamp" "20221212121212", "merchanttoken" "2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardexpyymm" "2712", "instmntmon" "1", "instmnttype" "1", "cctranstype" "1" } callback handling api checkout the txid won't be {{the}} same as {{the}} request hold the capture {{process}} will make sure that {{the}} amount value being captured doesn't exceed {{the}} funds owned when callback received to your callbackurl , we strongly recommend {{the}} {{merchant}} to verify {{the}} status using status inquiry api checkout docid\ tsmzvn ulka6hnmbkk5wl callback handling is very helpful to minimalize fraud actions, we strongly recommend {{the}} {{merchant}} to verify {{the}} callback handling