NICEPAY API
...
Payment - API Checkout
Payloan - API Checkout
16 min
about payloan api checkout this {{api}} uses by {{merchant}} s to requests {{payment}} to {{nicepay}} for {{the}} {{payloan}} {{paymethod}} using {{checkoutproduct}} {{api}} process flow payloan payment flow description of {{payment}} procedures with {{payloan}} the {{customer}} requests {{checkout}} to {{the}} {{merchant}} the {{merchant}} sends registration {{api}} to {{nicepay}} in {{the}} registration {{section}} if using akulaku {{nicepay}} will request {{the}} {{order}} to akulaku as {{the}} {{payloan}} {{partner}} akulaku generates {{order}} akulaku sends {{the}} data response to {{nicepay}} {{nicepay}} will send {{the}} capture of {{the}} {{api}} regist response to {{the}} {{merchant}} if using kredivo/indodana {{nicepay}} will save {{the}} order regist {{nicepay}} will send {{the}} order regist response the {{merchant}} sends {{the}} {{paymentproduct}} {{api}} to {{nicepay}} then in {{the}} {{paymentproduct}} {{section}} if using akulaku {{nicepay}} will redirect {{the}} {{customer}} to {{the}} akulaku {{page}} the {{customer}} login to {{the}} account the {{customer}} confirms {{the}} {{payment}} to akulaku as {{the}} {{payloan}} {{partner}} akulaku validates {{the}} {{payment}} akulaku redirects {{the}} {{customer}} using callbackurl if using kredivo/indodana {{nicepay}} requests {{checkout}} to {{payloan}} {{partner}} {{payloan}} {{partner}} {{proceed}} s with {{the}} {{checkout}} {{process}} {{payloan}} {{partner}} sends {{the}} response and redirects to {{the}} {{payloan}} {{partner}} {{page}} the {{customer}} confirms {{the}} {{payment}} to {{payloan}} {{partner}} {{payloan}} {{partner}} sends otp to {{the}} {{customer}} the {{customer}} inputs {{the}} otp to {{the}} {{payloan}} {{partner}} {{payloan}} {{partner}} validates {{the}} otp {{payloan}} {{partner}} confirms {{the}} result {{order}} to {{the}} {{customer}} in {{the}} notification {{section}} if using akulaku akulaku as {{payloan}} {{partner}} sends push capture {{notification}} to {{nicepay}} {{nicepay}} saves {{the}} {{notification}} {{nicepay}} sends {{the}} capture of {{the}} update {{notification}} to {{the}} {{merchant}} the {{merchant}} displays {{the}} response to {{the}} {{customer}} if using kredivo/indodana {{payloan}} {{partner}} sends {{the}} push {{notification}} to {{nicepay}} {{nicepay}} validates {{the}} received {{notification}} {{nicepay}} requests {{order}} confirmation {{payloan}} {{partner}} confirms {{the}} {{order}} {{process}} {{payloan}} {{partner}} sends {{order}} confirmation data to {{nicepay}} {{nicepay}} sends {{order}} confirmation result if {{payloan}} {{partner}} used is akulaku, {{the}} {{customer}} can confirms {{the}} {{payment}} receipt the {{customer}} sends {{payment}} receipt confirmation to {{the}} {{merchant}} the {{merchant}} requests {{payment}} receipt confirmation to {{nicepay}} {{nicepay}} requests {{the}} {{process}} of {{payment}} receipt confirmation to akulaku akulaku {{proceed}} s {{the}} {{payment}} receipt confirmation {{process}} akulaku sends {{the}} data response to {{nicepay}} {{nicepay}} sends {{the}} data response to {{the}} {{merchant}} the {{merchant}} displays data results to {{the}} {{customer}} the {{merchant}} sends {{the}} request for {{transaction}} checking {{status}} by using status {{api}} to {{nicepay}} {{nicepay}} sends {{the}} response of {{transaction}} checking {{status}} to {{the}} {{merchant}} the {{merchant}} receives {{the}} final {{status}} the {{merchant}} sends {{the}} {{status}} confirmation to {{the}} {{customer}} nicepay secure payment page secure payment page the image above is a {{checkoutproduct}} {{payment}} sample with {{the}} {{payloan}} method using {{nicepay}} secure {{paymentproduct}} page payloan secure payment page after {{the}} {{process}} of {{payment}} registration request completes, you can continue {{the}} {{transaction}} {{process}} until settlement by following {{the}} guidelines in docid\ l0j9rgg k5jphiglklo7g success secure payment page api checkout transaction payment api url /nicepay/redirect/v2/payment request method redirect get header content type application/form urlencoded request parameter for payloan api checkout (callbackurl) the following are request parameter lists for {{payloan}} {{paymentproduct}} {{api}} on {{checkoutproduct}} {{api}} note for {{payloan}} , please give a warning message for {{the}} {{customer}} to open by mobile devices for {{the}} {{customer}} better user experience 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 payloantes00202212201645434449 response parameter for payloan api checkout (callbackurl) note response {{parameter}} will be sent through callbackurl with content type application/json and method post parameter parameter type size description example / remark resultcd n 4 docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id payloantes00202212201645434449 when success referenceno ans 40 order number ord20221220161200 when success paymethod e wallet, payloan e wallet, payloan n 2 docid\ ek 0djw7nuhytcda4sa3p 06 when success amt n 12 transaction amount 10000 when success currency e wallet, payloan e wallet, payloan a 3 currency idr when success goodsnm e wallet, payloan e wallet, payloan an 100 goods name john+doe when success billingnm e wallet, payloan e wallet, payloan a 100 billing name john+doe when success transdt n 8 transaction date ( yyyymmdd ) 20221220 when success transtm n 6 transaction time ( hh24miss ) 164543 when success description an 100 transaction description test+transaction+nicepay when success authno only cc only cc n 10 approval number when success issubankcd only cc only cc a 4 docid\ qbeq29lj53z vbvxtvb7l when success acqubankcd only cc only cc a 4 docid\ qbeq29lj53z vbvxtvb7l when success issubanknm a 255 issuing {{bank}} name when success acqubanknm a 255 acquiring {{bank}} name when success cardno only cc only cc ans 20 card number with masking when success recurringtoken only cc (additional) only cc (additional) an 255 recurring token when success preauthtoken an 255 pre auth token null when success cctranstype an 2 {{cc}} transaction type 1 normal 2 recurring 3 pre auth 4 capture when success mitracd direct debit, e wallet, payloan direct debit, e wallet, payloan a 4 docid 0upx1lyg1o2f4biu3ssp kdvi when success receiptcode ans 20 authorization number when success mrefno an 18 reference number when success cardexpyymm n 4 card expiry ( yymm ) when success instmnttype n 2 docid\ wfsinjxqc2s9yubbybpep 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 when success timestamp n 14 {{api}} request timestamp when success merchanttoken an 255 {{merchant}} token when success sample parameter for payloan api checkout (callbackurl) on {{the}} {{payment}} in {{checkoutproduct}} , the response from {{the}} request that get hit is {{the}} callback url request parameter curl curl x get "https //www merchant com/callbackurl?resultcd=0000\&resultmsg=success\&txid=payloantes00202212201645434449\&referenceno=ord20221220161200\&paymethod=06\&amt=10000\&transdt=20221220\&transtm=164543\&description=test+transaction+nicepay\&authno=\&issubankcd=\&acqubankcd=\&cardno=\&receiptcode=\&mitracd=kdvi\&recurringtoken=\&preauthtoken=\¤cy=idr\&goodsnm=john+doe\&billingnm=john+doe\&cctranstype=\&mrefno=\&instmnttype=\&instmntmon=\&cardexpyymm=\&issubanknm=\&acqubanknm=\×tamp=\&merchanttoken=" callback parameter response callback resultcd=0000 resultmsg=success txid=payloantes00202212201645434449 referenceno=ord20221220161200 paymethod=06 amt=10000 transdt=20221220 transtm=164543 description=test+transaction+nicepay authno= issubankcd= acqubankcd= cardno= receiptcode= mitracd=kdvi recurringtoken= preauthtoken= currency=idr goodsnm=john+doe billingnm=john+doe cctranstype= mrefno= instmnttype= instmntmon= cardexpyymm= issubanknm= acqubanknm= timestamp= merchanttoken= callback handling api checkout payment when your callback already received callbackurl , we recommended {{the}} {{merchant}} to do {{the}} {{status}} verification using {{the}} docid 7thqvphz6emwezw5 d4an callback handling is very important to minimize {{the}} fraud act, we highly recommend {{the}} {{merchant}} to do {{the}} verification using callback parameter url callback https //merchant com/api/callbackurl response callback resultcd=0000 resultmsg=success txid=payloantes00202212201645434449 referenceno=ord20221220161200 paymethod=06 amt=10000 transdt=20221220 transtm=164543 description=test+transaction+nicepay authno= issubankcd= acqubankcd= cardno= receiptcode= mitracd=kdvi recurringtoken= preauthtoken= currency=idr goodsnm=john+doe billingnm=john+doe cctranstype= mrefno= instmnttype= instmntmon= cardexpyymm= issubanknm= acqubanknm= timestamp= merchanttoken=