Recurring - Payment API Credit Card

tentang recurring payment api credit card pembayaran tipe recurring adalah fitur lain dari {{kartukredit}} {{yang}} dapat melakukan {{pembayaran}} suatu tagihan dari {{pelanggan}} {{anda}} secara berkala dengan nominal {{yang}} sama seperti {{yang}} ditagihkan pada awal {{pembayaran}} {{api}} {{yang}} digunakan pada tahap {{pembayaran}} ini sama dengan {{api}} untuk {{pembayaran}} tipe full {{paymentproduct}} & installment dan pre auth & capture namun, terdapat perbedaan pada request {{parameter}} {{yang}} dikirimkan {{nicepay}} akan memberikan sebuah recurringtoken sebagai {{parameter}} {{paymentproduct}} {{api}} response {{yang}} disebut sebagai recurring token making {{merchant}} dapat menggunakan recurringtoken pada {{paymentproduct}} {{api}} request selanjutnya tanpa menggunakan cardno dan cardexpyymm recurring payment api credit card (first payment) untuk dapat mengaktifkan {{transaksi}} {{kartukredit}} dengan jenis recurring , {{anda}} wajib membayarkan {{transaksi}} {{yang}} sudah dibuat untuk mendapatkan recurringtoken terlebih dahulu api endpoint /nicepay/direct/v2/payment method application/x www form urlencoded application/x www form urlencoded post post description recurring {{paymentproduct}} {{cc}} merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) spesifikasi {{api}} {{yang}} digunakan sama dengan recurring registration api credit card docid\ ylje0zpb9xkbfa0e0mrzc request payment for credit card recurring (first payment) berikut adalah request payment pada recurring untuk mendapatkan recurringtoken {{yang}} di mana {{anda}} diperlukan untuk menyelesaikan recurring registration api credit card docid\ ylje0zpb9xkbfa0e0mrzc terlebih dahulu {{anda}} masih membutuhkan cardno , cardexpyymm , cardcvv , cardholdernm & cardholderemail dari {{pelanggan}} pada {{pembayaran}} pertama dalam skema recurring ini parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20230522080502 txid required required an 30 transaction id ionpaytest01202305220041509298 referenceno required required ans 40 {{merchant}} order number merchantreferencenumber001 merchanttoken required required an 255 {{merchant}} token ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae cardno required required n 20 {{cc}} number 51234500 0000 cardexpyymm required required a 4 card expiry ( yymm ) 3901 cardcvv required required n 4 card cvv 100 cardholdernm required required an 45 card holder name john doe only alphabet allowed cardholderemail required required ans 100 card holder email johndoe\@gmail com callbackurl required required ans 255 {{paymentproduct}} result url https //www nicepay co id/ionpay client/paymentresult jsp response parameter for credit card recurring (first payment) berikut adalah rincian response {{yang}} {{anda}} dapatkan mohon untuk melakukan save & store recurringtoken {{yang}} sudah didapat demi menjalankan {{proses}} fitur recurring pada {{transaksi}} selanjutnya dengan {{kartukredit}} {{pelanggan}} {{yang}} sama parameter tipe ukuran deskripsi contoh / catatan timestamp n 14 response date ( yyyymmddhh24miss ) 20230520135959 resultcd n 4 result code docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 error code docid\ wpcemazro xvnxz 1zaib success txid an 30 transaction id ionpaytest01202305161007570327 referenceno ans 40 {{merchant}} order number merchantreferencenumber001 paymethod n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 01 when success amount n 12 {{paymentproduct}} amount 10000 when success currency an 3 currency idr when success goodsnm an 100 goods name {{merchant}} goods 1 when success billingnm an 100 buyer name john doe when success transdt n 8 transaction date ( yyyymmdd ) 20230516 when success transtm n 6 transaction time ( hh24miss ) 135959 when success description an 100 transaction description this is the description of the {{paymentproduct}} when success authno n 10 approval number 123456 when success issubankcd a 4 bank code docid\ ky4ppujot06atnie easf cena (refer {{bank}} code) when success acqubankcd a 4 bank code docid\ ky4ppujot06atnie easf bnia (refer {{bank}} code) when success cardno an 20 card number (masked) 51234500 0008 when success cardexpyymm n 4 card expiry ( yymm ) 3901 when success instmntmon n 1 installment month 1 when success instmnttype n 2 installment type code docid\ rt2c32s9hfl aohyoebv5 1 when success cctranstype an 2 payment status code docid 5kylpx5mpjsl96c8mhoik 1 normal 2 recurring 3 pre auth 4 capture 2 when success vat n 12 value added tax ( {{vat}} ) 0 when success fee n 12 service fee 0 when success notaxamt n 12 tax free amount 0 when success recurringtoken an 64 token that using recurring {{paymentproduct}} f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84 acqubanknm a 255 acquiring {{bank}} name cimb issubanknm a 255 issuing {{bank}} name bca sample for credit card recurring (first payment) sample request recurring payment timestamp "20230522080502" txid "ionpaytest01202305220041509298" referenceno "merchantreferencenumber001" merchanttoken "ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae" cardno "51234500 0000" cardexpyymm "3901" cardcvv "100" cardholdernm "john doe" cardholderemail "johndoe\@gmail com" callbackurl "https //www nicepay co id/ionpay client/paymentresult jsp" sample response recurring payment { "resultcd" "0000", "resultmsg" "success", "authno" "063471", "txid" "ionpaytest01202305161007570327", "referenceno" "merchantreferencenumber001", "transdt" "20230522", "transtm" "224343", "amount" "10000", "recurringtoken" "f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84", "cardno" "51234500 0008", "acqubankcd" "bnia", "issubankcd" "cena", "acqubanknm" "cimb", "issubanknm" "bca" } java request //credit card recurring issue //initialize parameters nicepay settimestamp("20221202141217"); nicepay settxid("ionpaytest01202212021455054652"); nicepay setreferenceno("merchantreferencenumber001"); nicepay setmerchanttoken("ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae"); nicepay setcardno("512345 0008"); nicepay setcardexpyymm("3901"); nicepay setcardcvv("100"); nicepay setcardholdernm("john doe"); nicepay setcardholderemail("johndoe\@gmail com"); nicepay setcallbackurl("https //www merchant com/callbackurl/"); //request credit card recurring issue nicepay ccrecurringissue(); //response credit card recurring issue system out println("response " + nicepay getresponsestring()); string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string authno = nicepay get("authno"); string txid = nicepay get("txid"); string referenceno = nicepay get("referenceno"); string transdt = nicepay get("transdt"); string transtm = nicepay get("transtm"); string amount = nicepay get("amount"); string recurringtoken = nicepay get("recurringtoken"); string cardno = nicepay get("cardno"); string acqubankcd = nicepay get("acqubankcd"); string issubankcd = nicepay get("issubankcd"); string acqubanknm = nicepay get("acqubanknm"); string issubanknm = nicepay get("issubanknm"); continual recurring payment api credit card setelah melakukan {{pembayaran}} pertama dan telah mendapatkan recurringtoken pada recurring payment api credit card docid\ usdsc5jkc1ezifs5c6w9l {{anda}} dapat menggunakan recurringtoken tersebut untuk melakukan {{pembayaran}} tagihan lain menggunakan kredensial {{kartukredit}} {{pelanggan}} {{yang}} sama demi menerapkan mekanisme {{pembayaran}} secara berkala atau recurring (subscription) namun, untuk menjalankan {{proses}} payment continual recurring ini, {{anda}} tetap diperlukan untuk melakukan registrasi {{transaksi}} terlebih dahulu pada recurring registration api credit card docid\ ylje0zpb9xkbfa0e0mrzc berikut adalah rincian request dan response {{yang}} digunakan pada {{pembayaran}} berikutnya menggunakan recurring token {{yang}} sama api endpoint /nicepay/direct/v2/payment method application/x www form urlencoded application/x www form urlencoded post post description recurring continual {{paymentproduct}} {{cc}} merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) spesifikasi {{api}} {{yang}} digunakan sama dengan recurring registration api credit card docid\ ylje0zpb9xkbfa0e0mrzc request payment for credit card recurring {{anda}} hanya perlu menggunakan recurringtoken pada {{paymentproduct}} {{api}} recurring untuk request selanjutnya ini tanpa menggunakan {{parameter}} cardno dan cardexpyymm parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20230522080502 txid required required an 30 transaction id ionpaytest01202305220041509298 referenceno required required ans 40 {{merchant}} order number merchantreferencenumber001 merchanttoken required required an 255 {{merchant}} token ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae recurringtoken required required a n 64 token that using recurring payment when success f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84 cardcvv required required n 4 card cvv 100 cardholdernm required required an 45 card holder name john doe only alphabet allowed cardholderemail required required ans 100 card holder email johndoe\@gmail com callbackurl required required ans 255 {{paymentproduct}} result url https //www nicepay co id/ionpay client/paymentresult jsp mencantumkan cardcvv pada setiap {{transaksi}} bergantung dari mid tipe cvv atau non cvv response payment for credit card recurring parameter tipe ukuran deskripsi contoh / catatan timestamp n 14 response date ( yyyymmddhh24miss ) 20230520135959 resultcd n 4 result code docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 error code docid\ wpcemazro xvnxz 1zaib success txid an 30 transaction id ionpaytest202206230959067259 referenceno ans 40 {{merchant}} order number merchantreferencenumber001 paymethod n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 01 when success amt n 12 payment amount 10000 when success currency an 3 currency idr when success goodsnm an 100 goods name merchant goods 1 when success billingnm an 100 buyer name john doe when success transdt n 8 transaction date ( yyyymmdd ) 20230516 when success transtm n 6 transaction time ( hh24miss ) 135959 when success description an 100 transaction description this is the description of the {{paymentproduct}} when success authno n 10 approval number 123456 when success issubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l cena (refer {{bank}} code) when success acqubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l cena (refer {{bank}} code) when success cardno an 20 card number (masked) 51234500 0008 when success cardexpyymm n 4 card expiry ( yymm ) 3901 when success instmntmon n 1 installment month 1 when success instmnttype n 2 installment type code docid\ rt2c32s9hfl aohyoebv5 1 when success cctranstype an 2 payment status code docid 5kylpx5mpjsl96c8mhoik 1 normal 2 recurring 3 pre auth 4 capture 2 when success vat n 12 value added tax ( {{vat}} ) 0 when success fee n 12 service fee 0 when success notaxamt n 12 tax free amount 0 when success acqubanknm a 255 acquiring {{bank}} name cimb issubanknm a 255 issuing {{bank}} name bca sample json for credit card recurring payment sample request continual payment timestamp "20230522080502" txid "ionpaytest01202305220041509298" referenceno "merchantreferencenumber001" merchanttoken "ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae" recurringtoken "f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84" cardcvv "100" callbackurl "https //www nicepay co id/ionpay client/paymentresult jsp" sample response continual payment { "resultcd" "0000", "resultmsg" "success", "authno" "063471", "txid" "ionpaytest01202305161007570327", "referenceno" "merchantreferencenumber001", "transdt" "20230522", "transtm" "224343", "amount" "10000", "cardno" "51234500 0008", "acqubankcd" "bnia", "issubankcd" "cena", "acqubanknm" "cimb", "issubanknm" "bca" } sample java request continual //credit card recurring continual //initialize parameters nicepay settimestamp("20221202141217"); nicepay settxid("ionpaytest01202212021455054652"); nicepay setreferenceno("merchantreferencenumber001"); nicepay setmerchanttoken("ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae"); nicepay setrecurringtoken("f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84"); nicepay setcardcvv("100"); nicepay setcallbackurl("https //www merchant com/callbackurl/"); //request credit card recurring issue nicepay ccrecurringissue(); //response credit card recurring issue system out println("response " + nicepay getresponsestring()); string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string authno = nicepay get("authno"); string txid = nicepay get("txid"); string referenceno = nicepay get("referenceno"); string transdt = nicepay get("transdt"); string transtm = nicepay get("transtm"); string amount = nicepay get("amount"); string recurringtoken = nicepay get("recurringtoken"); string cardno = nicepay get("cardno"); string acqubankcd = nicepay get("acqubankcd"); string issubankcd = nicepay get("issubankcd"); string acqubanknm = nicepay get("acqubanknm"); string issubanknm = nicepay get("issubanknm"); callback handling for credit card payment txid tidak akan sama dengan request hold proses capture akan memastikan bahwa nilai amount {{yang}} di capture tidak melebihi dana {{yang}} dimiliki saat callback telah diterima callbackurl {{anda}} , kami sangat menganjurkan {{merchant}} untuk melakukan verifikasi {{status}} menggunakan status inquiry api credit card docid 9ivqi i4yka9s1oz6s ha callback handling dapat sangat membantu untuk meminimalisir terjadinya fraud , kami sangat merekomendasikan {{merc}} untuk melakukan verifikasi callback handling 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" }