Credit Card - API Checkout

about credit card api checkout there are several things that you must know when using {{checkoutproduct}} {{api}} for {{cc}} method so that your {{integration}} {{process}} will run smoothly with us flow 3ds/non 3ds process full {{paymentproduct}} feature installment feature process flow {{please}} visit {{the}} docid 5p povp7xv ohkyiebaoc {{page}} to check {{the}} explanation about 3ds 3ds cc payment flow redirect 3ds description steps of redirect {{cc}} {{payment}} flow with 3ds the {{customer}} does {{checkout}} the {{customer}} sends {{checkout}} data to {{the}} {{merchant}} the {{merchant}} requests {{checkout}} using registration {{api}} to {{nicepay}} {{nicepay}} registers {{the}} {{checkout}} data {{nicepay}} redirects {{merchant}} to {{the}} {{nicepay}} 's {{payment}} {{page}} the {{merchant}} sends {{the}} {{nicepay}} 's {{payment}} {{page}} to {{the}} {{customer}} the {{customer}} selects {{the}} {{paymethod}} the {{customer}} inputs {{the}} card data the {{customer}} sends {{the}} {{information}} of card data to {{nicepay}} {{nicepay}} {{proceed}} s with {{the}} fds calculation {{nicepay}} requests 3ds to {{bank}} {{bank}} validates {{the}} 3ds {{bank}} sends 3ds url response to {{nicepay}} {{nicepay}} receives {{the}} verification response {{nicepay}} redirects {{the}} {{customer}} to acs authentication {{page}} {{bank}} creates otp response {{bank}} sends otp to {{the}} {{customer}} the {{customer}} receives otp the {{customer}} inputs otp the {{customer}} sends otp to {{bank}} {{bank}} verifies the otp {{bank}} sends 3ds result to {{nicepay}} {{nicepay}} receives {{the}} checking result {{nicepay}} requests {{the}} {{payment}} to {{bank}} {{bank}} {{proceed}} s {{the}} {{payment}} {{bank}} sends {{payment}} {{notification}} to {{nicepay}} {{nicepay}} performs callbackurl redirect to {{the}} {{merchant}} the {{merchant}} displays {{the}} callbackurl result to {{the}} {{customer}} {{nicepay}} sends {{payment}} {{notification}} to {{the}} {{merchant}} the {{merchant}} receives {{the}} {{notification}} the {{merchant}} requests inquiry {{status}} to {{nicepay}} {{nicepay}} receives {{the}} request {{nicepay}} automatically sends {{status}} inquiry response to {{the}} {{merchant}} the {{merchant}} receives {{the}} final {{status}} the {{merchant}} sends {{the}} {{transaction}} result {{page}} to {{the}} {{customer}} non 3ds cc payment flow redirect n 3ds description steps of redirect {{cc}} {{payment}} flow with non 3ds the {{customer}} performs {{checkout}} the {{customer}} requests {{checkout}} to {{the}} {{merchant}} the {{merchant}} registers {{the}} {{checkout}} data the {{merchant}} sends {{the}} response in {{the}} form of card data form the {{customer}} requests {{checkout}} to {{the}} {{merchant}} the {{merchant}} registers {{the}} {{order}} using registration {{api}} to {{nicepay}} {{nicepay}} stores {{the}} {{order}} registration {{nicepay}} redirects {{merchant}} s to {{the}} {{nicepay}} 's {{page}} the {{merchant}} sends {{nicepay}} 's {{page}} to {{the}} {{customer}} the {{customer}} selects {{the}} {{paymethod}} the {{customer}} inputs card detail the {{customer}} requests {{payment}} using {{paymentproduct}} {{api}} to {{nicepay}} {{nicepay}} {{proceed}} s with {{the}} fds calculation {{nicepay}} requests {{the}} {{payment}} to {{bank}} {{bank}} verifies {{the}} request {{bank}} sends {{payment}} confirmation request to {{the}} {{customer}} the {{customer}} requests {{payment}} /charge to {{bank}} {{bank}} {{proceed}} s {{the}} {{payment}} {{bank}} sends {{the}} response of {{payment}} to {{nicepay}} {{nicepay}} sends {{payment}} notification using callbackurl and dbprocessurl to {{the}} {{merchant}} the {{merchant}} receives {{the}} {{notification}} the {{merchant}} requests {{status}} checking to {{nicepay}} {{nicepay}} sends {{the}} response of {{status}} checking the {{merchant}} receives {{the}} final {{status}} the {{merchant}} sends {{the}} {{order}} result to {{the}} {{customer}} nicepay secure payment page {{please}} open {{the}} docid 90sa3oaowsytgpjubaayq {{page}} to provide your {{customer}} with {{payment}} guide on {{the}} {{cc}} method secure payment page the image above is a {{payment}} sample with a {{cc}} using {{nicepay}} secure {{paymentproduct}} page after {{the}} {{customer}} selects {{the}} {{cc}} method, {{the}} {{customer}} will ask to input their card data {{nicepay}} {{system}} will automatically recognize {{the}} type of {{customer}} 's bin card like in {{the}} picture below, such as visa or mastercard, american express, etc, later {{the}} cards will be different according to {{the}} card types being used after completing {{the}} card data input, your {{customer}} can continue {{the}} {{payment}} {{process}} credit secure payment page then, {{the}} {{transaction}} will run once {{the}} {{transaction}} is successful, then {{the}} display of {{the}} {{nicepay}} {{payment}} {{page}} will appear as {{the}} image as follows success nicepay secure payment page {{please}} visit {{the}} docid\ edzoz4vkv 1afv7hzbq5y {{page}} to know {{the}} next step regarding payment handling api checkout transaction payment api url /nicepay/redirect/v2/payment request method redirect get header content type application/form urlencoded the endpoint above can use for {{cc}} {{paymethod}} s with full {{paymentproduct}} full payment credit card api checkout (callbackurl) on {{the}} full {{paymentproduct}} {{cc}} , {{the}} {{customer}} paid fully {{the}} nominal billed at once the following is {{the}} details {{api}} used on {{cc}} {{payment}} request parameter for full payment credit card 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 for {{checkoutproduct}} {{paymentproduct}} {{api}} , {{cc}} {{paymethod}} with full {{paymentproduct}} and installment got {{the}} same response response parameter for full payment credit card api checkout (callbackurl) parameter type size description remark status n 1 docid\ allhyf9mj hw8 mpz4tmu 0 txid an 30 transaction id ionpaytest00202212201540174369 when success referenceno an 40 {{merchant}} order number ordno20221220151243 when success paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 01 when success amt n 12 transaction amount 1000 when success notaxamt n 12 tax fee amount 0 when success vat n 12 value added tax ( {{vat}} ) 0 when success fee n 12 service fee 0 when success currency a 3 currency idr when success goodsnm an 100 goods name goods+for+testing+credit+card when success billingnm a 100 billing name john+doe when success transdt n 8 transaction date ( yyyymmdd ) 20221220 when success transtm n 6 transaction time ( hh24miss ) 154017 when success authno n 10 approval number 174300 when success (additional) issubankcd a 4 docid\ ky4ppujot06atnie easf bmri when success acqubankcd a 4 docid\ ky4ppujot06atnie easf bmri when success issubanknm a 255 issuing {{bank}} name mandiri when success acqubanknm a 255 acquiring {{bank}} name mandiri when success cctranstype an 2 {{cc}} transaction type 1 normal 2 recurring 3 pre auth 4 capture 1 when success cardno ans 20 card number with masking 46161111 1111 when success cardexpyymm n 4 card expiration ( yymm ) 2707 when success instmnttype n 2 docid\ wfsinjxqc2s9yubbybpep 1 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 recurringtoken an 255 recurring token null when success preauthtoken an 255 pre auth token null when success matchcl n 1 docid yqqe4ju5bjurdxkxdtho 1 when success merchanttoken an 255 {{merchant}} token 8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a sample parameter for full payment credit card api checkout (callbackurl) request parameter curl curl x get "https //www merchant com/callbackurl?cctranstype=1\&fee=0\&txid=ionpaytest00202212201540174369\&amt=1000\&notaxamt=0\&cardno=46161111 1111\&issubankcd=bmri\&matchcl=1\&preauthtoken=null\&cardexpyymm=2603\&acqubanknm=mandiri\&paymethod=01\&currency=idr\&instmntmon=1\&cc trans type=1\&issubanknm=mandiri\&merchanttoken=dc1dd9e57ff6c4db341654ae31e623cab4d4d8057b2d0b58bef43ccb0da3b494\&goodsnm=goods+for+testing+credit+card\&referenceno=ordno20221220151243\&authno=174300\&transtm=154017\&cpguaranteeablestatus=null\&recurringtoken=null\&vat=0\&instmnttype=1\&billingnm=john+doe\&acqubankcd=bmri\&transdt=20221220\&status=0" callback parameter response callback status=0 txid=ionpaytest00202212201540174369 referenceno=ordno20221220151243 paymethod=01 amt=1000 notaxamt=0 vat=0 fee=0 currency=idr goodsnm=goods+for+testing+credit+card billingnm=john+doe transdt=20221220 transtm=154017 authno=174300 issubankcd=bmri acqubankcd=bmri issubanknm=mandiri acqubanknm=mandiri cctranstype=1 cardno=46161111 1111 cardexpyymm=2707 instmnttype=1 instmntmon=1 recurringtoken=null preauthtoken=null matchcl=1 merchanttoken=8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a note response {{parameter}} will be sent through callbackurl with content type application/json and method post parameter for {{the}} {{paymentproduct}} {{integration}} {{process}} on {{checkoutproduct}} {{api}} , {{the}} response from request received after performing call request {{api}} is a callback url callback handling api checkout payment the txid won't be {{the}} same as {{the}} request hold the capture {{process}} will reassure that {{the}} captured amount value doesn't exceed {{the}} funds owned 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 "callbackurl" "https //www merchant com/callbackurl/" 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" }