Direct Debit - API Checkout

about direct debit api checkout this {{api}} uses by {{merchant}} to requests {{payment}} to {{nicepay}} for {{directdebit}} {{paymethod}} using {{checkoutproduct}} {{api}} process flow direct debit payment flow steps description the {{customer}} requests {{checkout}} to {{the}} {{merchant}} the {{merchant}} will register {{checkout}} by using registration {{api}} to {{nicepay}} {{nicepay}} save {{order}} regist {{nicepay}} redirect {{merchant}} to {{the}} {{nicepay}} {{page}} the {{merchant}} displays {{nicepay}} 's {{payment}} {{page}} to {{the}} {{customer}} the {{customer}} chooses {{the}} {{paymethod}} the {{customer}} input {{the}} {{payment}} data (jenius cashtag) the {{customer}} sends {{the}} selected {{paymethod}} to {{nicepay}} {{nicepay}} requests {{payment}} to {{bank}} {{bank}} {{proceed}} s with {{the}} authentication {{process}} {{bank}} sends {{notification}} authentication to {{the}} {{customer}} the {{customer}} performs authentication the {{customer}} requests {{the}} charge to {{bank}} {{bank}} does {{the}} {{payment}} {{process}} {{bank}} sends {{the}} {{payment}} result to {{the}} {{customer}} {{bank}} sends push {{notification}} to {{nicepay}} {{nicepay}} validates {{the}} {{notification}} {{nicepay}} updates {{the}} {{status}} {{nicepay}} sends a {{notification}} to {{the}} {{merchant}} the {{merchant}} requests {{status}} checking by using status {{api}} to {{the}} {{nicepay}} {{nicepay}} sends {{the}} response {{status}} to {{the}} {{merchant}} the {{merchant}} receives {{the}} final {{status}} the {{merchant}} sends {{the}} confirmation {{status}} update to {{the}} {{customer}} nicepay secure payment page secure payment page the image above is a {{payment}} sample with {{directdebit}} method using {{nicepay}} secure {{paymentproduct}} page direct debit secure payment page after selecting {{the}} method {{directdebit}} , you will be redirected to {{the}} {{page}} to select {{the}} desired {{directdebit}} {{service}} next, you will be redirected to {{the}} form {{page}} to enter your identity in {{the}} example above, if you choose jenius {{service}} , you will be asked to enter your cashtag data in {{the}} form provided after completing {{the}} form, you can continue {{the}} {{payment}} {{process}} then, you can {{proceed}} until {{the}} {{order}} {{payment}} is successful success secure payment page the {{process}} of {{payment}} registration request has been completed you can continue {{the}} {{transaction}} {{process}} until settlement by following {{the}} guidelines in {{the}} docid\ epxddufll2lbzpb5lekho api checkout transaction payment api url /nicepay/redirect/v2/payment request method redirect get header content type application/form urlencoded request parameter for direct debit api checkout (callbackurl) 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 ionpaytest00202203211640309389 response parameter for direct debit api checkout (callbackurl) parameter type size description remark status n 1 docid\ allhyf9mj hw8 mpz4tmu 0 merchanttoken an 255 {{merchant}} token 46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa when success goodsnm direct debit, e wallet, payloan direct debit, e wallet, payloan an 100 goods name jhon+doe when success billingnm direct debit, e wallet, payloan direct debit, e wallet, payloan a 100 billing name jhon+doe when success referenceno ans 40 order number ord20230525090536 when success mitracd direct debit, e wallet, payloan direct debit, e wallet, payloan a 4 docid\ tm257gq3dxgzf98uz0l33 jenc when success txid an 30 transaction id tnicecp04100202305250918306465 when success amt n 12 transaction amount 5000 when success receiptcode ans 20 authorization number 951527524097 when success instmnttype n 2 docid\ wfsinjxqc2s9yubbybpep 2 when success instmntmon n 2 installment month 1 1 month/full {{paymentproduct}} , if instmnttype null/1 3 3 months 6 6 months 12 12 months 1 when success matchcl n 1 docid yqqe4ju5bjurdxkxdtho 0 when success mrefno an 18 reference number 202305250918303 when success paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 04 when success currency a 3 currency idr when success note response {{parameter}} will be sent through callbackurl with content type application/json and method post parameter sample parameter for direct debit api checkout (callbackurl) on {{the}} {{payment}} when {{checkoutproduct}} , {{the}} response from {{the}} request that got hit is a callback url request parameter curl curl x get "https //www merchant com/callbackurl?resultcd=0000\&resultmsg=please+do+payment+on+jenius+pay+apps\&txid=tnicecp04100202305250918306465\&referenceno=ord20230525090536\&amt=\&transdt=20230525\&transtm=091830" callback parameter response callback merchanttoken=46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa goodsnm=jhon+doe referenceno=ord20230525090536 mitracd=jenc txid=tnicecp04100202305250918306465 amt=5000 receiptcode=951527524097 instmnttype=2 billingnm=jhon+doe matchcl=0 mrefno=202305250918303 paymethod=04 currency=idr instmntmon=1 status=0 callback handling api checkout payment when your callback already received callbackurl , we recommended {{the}} {{merchant}} to do {{the}} {{status}} verification using {{the}} docid\ tsmzvn ulka6hnmbkk5wl callback handling is necessary to minimize fraud actions we strongly recommend {{merchant}} to verify using callback parameter url callback https //merchant com/callback nicepay?resultcd=0000\&resultmsg=please+do+payment+on+jenius+pay+apps\&txid=ionpaytest00202212211034026581\&referenceno=order20221012080918\&amt=\&transdt=20221221\&transtm=103402 response callback merchanttoken=46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa goodsnm=jhon+doe referenceno=ord20230525090536 mitracd=jenc txid=tnicecp04100202305250918306465 amt=5000 receiptcode=951527524097 instmnttype=2 billingnm=jhon+doe matchcl=0 mrefno=202305250918303 paymethod=04 currency=idr instmntmon=1 status=0