NICEPAY API
...
Checkout API
Payment - API Checkout

Credit Card - API Checkout

33min
tentang credit card api checkout terdapat beberapa hal {{yang}} {{anda}} wajib ketahui dalam menggunakan {{api}} {{checkoutproduct}} untuk metode {{kartukredit}} agar {{proses}} {{integrasi}} {{anda}} lancar bersama kami proses flow 3ds/non 3ds fitur full {{paymentproduct}} fitur installment fitur recurring token fitur pre auth token alur proses {{silakan}} kunjungi {{halaman}} fitur kartu kredit docid\ cglxg10p9zmvtux b7ga untuk memeriksa penjelasan mengenai 3ds 3ds deskripsi langkah alur {{pembayaran}} {{kartukredit}} redirect dengan 3ds {{pelanggan}} melakukan checkout {{pelanggan}} mengirim data {{checkout}} kepada {{merchant}} {{merchant}} mengajukan {{checkout}} menggunakan {{api}} registration kepada {{nicepay}} {{nicepay}} mendaftarkan data {{checkout}} {{nicepay}} mengalihkan {{pembayaran}} pada {{halaman}} milik {{nicepay}} kepada {{merchant}} {{merchant}} mengirimkan {{halaman}} {{pembayaran}} {{nicepay}} kepada {{pelanggan}} {{pelanggan}} memilih {{metodebayar}} {{pelanggan}} memasukkan data kartu {{pelanggan}} mengirimkan {{informasi}} data kartu kepada {{nicepay}} {{nicepay}} mem {{proses}} kalkulasi fds {{nicepay}} mengajukan 3ds kepada {{bank}} {{bank}} melakukan validasi 3ds {{bank}} mengirimkan response url 3ds kepada {{nicepay}} {{nicepay}} menerima response verifikasi {{nicepay}} mengalihkan {{pelanggan}} kepada {{halaman}} autentikasi acs {{bank}} membuat response otp {{bank}} mengirimkan otp kepada {{pelanggan}} {{pelanggan}} menerima otp {{pelanggan}} memasukkan otp {{pelanggan}} mengirimkan otp kepada {{bank}} {{bank}} melakukan verifikasi otp {{bank}} mengirimkan hasil 3ds kepada {{nicepay}} {{nicepay}} menerima hasil pemeriksaan {{nicepay}} mengajukan {{pembayaran}} kepada {{bank}} {{bank}} melakukan {{proses}} {{pembayaran}} {{bank}} mengirimkan {{notifikasi}} {{pembayaran}} kepada {{nicepay}} {{nicepay}} melakukan redirect callbackurl kepada {{merchant}} {{merchant}} menampilkan hasil callbackurl kepada {{pelanggan}} {{nicepay}} mengirim {{notifikasi}} {{pembayaran}} kepada {{merchant}} {{merchant}} menerima {{notifikasi}} {{merchant}} melakukan pengajuan {{status}} inquiry ke {{nicepay}} {{nicepay}} menerima pengajuan {{nicepay}} secara otomatis mengirimkan response {{status}} inquiry kepada {{merchant}} {{merchant}} menerima {{status}} terakhir {{merchant}} mengirim {{halaman}} hasil {{transaksi}} kepada {{pelanggan}} non 3ds deskripsi langkah alur {{pembayaran}} {{kartukredit}} redirect dengan non 3ds {{pelanggan}} melakukan checkout {{pelanggan}} mengajukan checkout kepada {{merchant}} {{merchant}} mendaftarkan data checkout {{merchant}} mengirimkan response berupa formulir data kartu {{pelanggan}} mengajukan checkout kepada {{merchant}} {{merchant}} mendaftarkan pesanan dengan menggunakan {{api}} registration kepada {{nicepay}} {{nicepay}} menyimpan order registration {{nicepay}} mengalihkan {{merchant}} kepada {{halaman}} {{nicepay}} {{merchant}} mengirim {{halaman}} {{nicepay}} kepada {{pelanggan}} {{pelanggan}} memilih {{metodebayar}} {{pelanggan}} memasukkan rincian kartu {{pelanggan}} mengajukan {{pembayaran}} menggunakan {{api}} {{paymentproduct}} kepada {{nicepay}} {{nicepay}} melakukan kalkulasi fds {{nicepay}} mengajukan {{pembayaran}} kepada {{bank}} {{bank}} melakukan verifikasi pengajuan {{bank}} mengirimkan pengajuan konfirmasi {{pembayaran}} kepada {{pelanggan}} {{pelanggan}} mengajukan {{pembayaran}} / charge kepada {{bank}} {{bank}} melakukan {{proses}} {{pembayaran}} {{bank}} mengirim response {{pembayaran}} kepada {{nicepay}} {{nicepay}} mengirim {{notifikasi}} {{pembayaran}} menggunakan callbackurl dan dbprocessurl kepada {{merchant}} {{merchant}} menerima {{notifikasi}} {{merchant}} mengajukan pemeriksaan {{status}} kepada {{nicepay}} {{nicepay}} mengirimkan response pemeriksaan {{status}} {{merchant}} menerima {{status}} terakhir {{merchant}} mengirimkan hasil pesanan kepada {{pelanggan}} nicepay secure payment page {{silakan}} membuka {{halaman}} panduan bayar kartu kredit docid\ pf0yyjehae07p65seirft untuk dapat memberikan panduan {{pembayaran}} kepada {{pelanggan}} {{anda}} dalam metode {{kartukredit}} gambar di atas adalah contoh {{pembayaran}} dengan metode {{kartukredit}} menggunakan {{nicepay}} secure {{paymentproduct}} page setelah {{pelanggan}} memilih metode dengan {{kartukredit}} , {{pelanggan}} akan diminta untuk memasukan data kartunya sistem {{nicepay}} akan secara otomatis mengenali jenis kartu bin {{pelanggan}} seperti gambar di bawah ini, misalnya visa atau mastercard, american express, dan lain lain {{yang}} nantinya kartunya pun akan berbeda sesuai dengan tipe jenis kartu {{yang}} digunakan setelah selesai memasukkan data kartu, {{pelanggan}} {{anda}} dapat melanjutkan {{proses}} {{pembayaran}} kemudian, {{proses}} {{transaksi}} akan berjalan apabila {{transaksi}} berhasil maka tampilan {{halaman}} {{pembayaran}} {{nicepay}} akan muncul seperti gambar berikut {{silakan}} kunjungi {{halaman}} payment api checkout untuk mengetahui langkah selanjutnya perihal payment handling full payment credit card pada full {{paymentproduct}} {{kartukredit}} , {{pelanggan}} membayar secara penuh nominal {{yang}} ditagihkan dalam sekali bayar berikut adalah rincian {{api}} {{yang}} digunakan pada {{pembayaran}} {{kartukredit}} request parameter full payment credit card parameter tipe ukuran deskripsi contoh / catatan paymenturl required required ans 14 {{paymentproduct}} url https //dev nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id ionpaytest00202203211640309389 untuk {{api}} {{paymentproduct}} {{checkoutproduct}} , {{metodebayar}} {{kartukredit}} dengan full {{paymentproduct}} dan installment mendapatkan response {{yang}} sama response parameters full payment credit card (callbackurl) payment parameter tipe ukuran deskripsi contoh / catatan status n 1 payment status code 0 txid an 30 transaction id ionpaytest00202212201540174369 when success referenceno an 40 {{merchant}} order number ordno20221220151243 when success paymethod n 2 payment method code 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 bank code bmri when success acqubankcd a 4 bank code bmri when success issubanknm a 255 issuing {{bank}} name mandiri when success acqubanknm a 255 acquiring {{bank}} name mandiri when success cctranstype an 2 credit card 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 installment type code 1 when success instmntmon n 2 installment month 1 1 month/full {{paymentproduct}} , jika 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 notification match amount indicator 1 when success merchanttoken an 255 {{merchant}} token 8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a when success sample parameter for callbackurl api checkout payment url request https //dev nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202203211640309389 url callback 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 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 catatan response {{parameter}} akan dikirimkan melalui callbackurl dengan content type application/json dan metode post parameter untuk {{proses}} {{integrasi}} {{paymentproduct}} pada {{checkoutproduct}} {{api}} , response dari request {{yang}} didapat setelah melakukan {{api}} call request adalah callback url api checkout transaction payment api url /nicepay/redirect/v2/payment request method redirect get header content type application/form urlencoded endpoint di atas dapat digunakan untuk {{metodebayar}} {{kartukredit}} dengan tipe full {{paymentproduct}} , recurring, dan pac (pre auth capture) recurring token setelah {{merchant}} menyelesaikan registration api checkout docid\ fqje 48 bzdt4uimqbfcx dan payment api checkout docid\ iewj7vv ejtgaa2m7o5p2 , maka selanjutnya {{nicepay}} akan memberikan recurringtoken pada response payment api checkout docid\ iewj7vv ejtgaa2m7o5p2 {{yang}} didapatkan pada {{transaksi}} selanjutnya dengan {{pelanggan}} {{yang}} sama, {{merchant}} dapat menggunakan recurringtoken tersebut dengan menggunakan {{api}} pada recurring payment api credit card docid\ usdsc5jkc1ezifs5c6w9l request parameter recurring token parameter tipe ukuran deskripsi contoh / catatan paymenturl required required ans 14 {{paymentproduct}} url https //dev nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id recurrtest00202212221422115631 response parameter recurring token parameter tipe ukuran deskripsi contoh / catatan status n 1 payment status code 0 txid an 30 transaction id recurrtest00202212221422115631 when success referenceno an 40 {{merchant}} order number ordno20221222141245 when success paymethod n 2 payment method code 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+recurring+token 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 ) 142211 when success authno n 10 approval number 115631 when success (additional) issubankcd a 4 bank code othr when success acqubankcd a 4 bank code bmri when success issubanknm a 255 issuing {{bank}} name (empty) when success acqubanknm a 255 acquiring {{bank}} name mandiri when success cctranstype an 2 credit card transaction type 1 normal 2 recurring 3 pre auth 4 capture 1 when success cardno ans 20 card number with masking 45321111 1111 when success cardexpyymm n 4 card expiry ( yymm ) 2712 when success instmnttype n 2 installment type code 1 when success instmntmon n 2 installment month 1 1 month/full {{paymentproduct}} , jika instmnttype null/1 3 3 months 6 6 months 12 12 months 1 when success recurringtoken an 255 recurring token 083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745 when success preauthtoken an 255 pre auth token null when success matchcl n 1 {{paymentproduct}} amount match flag notification match amount indicator 1 when success merchanttoken an 255 {{merchant}} token f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745 sample parameter recurring token payment url request https //dev nicepay co id/nicepay/redirect/v2/payment?txid=recurrtest00202212221422115631 url callback https //www merchant com/callbackurl?cctranstype=1\&fee=0\&txid=recurrtest00202212221422115631\&amt=1000\&notaxamt=0\&cardno=45321111 1111\&issubankcd=othr\&matchcl=1\&preauthtoken=null\&cardexpyymm=2712\&acqubanknm=mandiri\&paymethod=01\&currency=idr\&instmntmon=1\&cc trans type=1\&issubanknm=\&merchanttoken=ebc5fa0c3739fa45d386a005458bd6d81027a729d3c43e77b43adab609244069\&goodsnm=goods+for+testing+recurring+token\&referenceno=ordno20221222141245\&authno=115631\&transtm=142211\&cpguaranteeablestatus=null\&recurringtoken=f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745\&vat=0\&instmnttype=1\&billingnm=john+doe\&acqubankcd=bmri\&transdt=20221222\&status=0 response callback status=0 txid=recurrtest00202212221422115631 referenceno=ordno20221222141245 paymethod=01 amt=1000 notaxamt=0 vat=0 fee=0 currency=idr goodsnm=goods+for+testing+recurring+token billingnm=john+doe transdt=20221220 transtm=142211 authno=115631 issubankcd=othr acqubankcd=bmri issubanknm=(empty) acqubanknm=mandiri cctranstype=1 cardno=45321111 1111 cardexpyymm=2712 instmnttype=1 instmntmon=1 recurringtoken=083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745 preauthtoken=null matchcl=1 merchanttoken=f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745 setelah melakukan registrasi {{api}} ( registration api checkout docid\ fqje 48 bzdt4uimqbfcx ) dan integrasi {{paymentproduct}} {{api}} ( payment api checkout docid\ iewj7vv ejtgaa2m7o5p2 ) menggunakan {{checkoutproduct}} {{api}} , jika {{anda}} ingin melakukan {{paymentproduct}} {{cc}} recurring menggunakan recurring token {{yang}} sama, silakan melakukan registrasi kembali pada registration api checkout docid\ fqje 48 bzdt4uimqbfcx kemudian melakukan {{pembayaran}} dengan menambahkan recurring token pada {{parameter}} recurringtoken dan juga cvv pre auth token ketika {{merchant}} menandatangani kontrak sebagai {{merchant}} pac (pre auth/capture), {{nicepay}} memberikan sebuah preauthtoken kepada response payment api checkout token tersebut akan digunakan pada {{proses}} capture amount untuk menyelesaikan {{transaksi}} pada pre auth & capture payment api credit card request parameter pre auth token berikut ini adalah daftar {{parameter}} untuk melakukan request pre auth token {{cc}} parameter ini digunakan melalui platform pengujian {{api}} sebagai salah satu tahapan supaya {{sistem}} milik {{merchant}} dapat terhubung dengan {{layanan}} dari {{nicepay}} parameter tipe ukuran deskripsi contoh / catatan paymenturl required required ans 14 {{paymentproduct}} url https //dev nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id pactest00100202212221548525731 response parameter pre auth token parameter tipe ukuran deskripsi contoh / catatan status n 1 payment status code 5 txid an 30 transaction id pactest00100202212221548525731 when success referenceno an 40 {{merchant}} order number ordno20221222151220 when success paymethod n 2 payment method code 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+pre+ +auth+token when success billingnm a 100 billing name john+doe when success transdt n 8 transaction date ( yyyymmdd ) 20221222 when success transtm n 6 transaction time ( hh24miss ) 154852 when success authno n 10 approval number 525731 when success (additional) issubankcd a 4 bank code cena when success acqubankcd a 44 bank code bmri when success issubanknm a 255 issuing {{bank}} name bca when success acqubanknm a 255 acquiring {{bank}} name mandiri when success cctranstype an 2 credit card transaction type 1 normal 2 recurring 3 pre auth 4 capture 1 when success cardno ans 20 card number with masking 53079511 1111 when success cardexpyymm n 4 card expiry ( yymm ) 2712 when success instmnttype n 2 installment type code 1 when success instmntmon n 2 installment month 1 1 month/full {{paymentproduct}} , jika 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 edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb when success matchcl n 1 {{paymentproduct}} amount match flag notification match amount indicator 1 when success merchanttoken an 255 {{merchant}} token 1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524 sample parameter for pre auth token payment url request https //dev nicepay co id/nicepay/redirect/v2/payment?txid= url callback https //www merchant com/callbackurl?cctranstype=3\&fee=0\&txid=pactest00100202212221548525731\&amt=1000\&notaxamt=0\&cardno=53079511 1111\&issubankcd=cena\&matchcl=1\&preauthtoken=edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb\&cardexpyymm=2712\&acqubanknm=mandiri\&paymethod=01\&currency=idr\&instmntmon=1\&cc trans type=3\&issubanknm=bca\&merchanttoken=1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524\&goodsnm=goods+for+testing+pre+ +auth+token\&referenceno=ordno20221222151220\&authno=525731\&transtm=154852\&cpguaranteeablestatus=null\&recurringtoken=null\&vat=0\&instmnttype=1\&billingnm=john+doe\&acqubankcd=bmri\&transdt=20221222\&status=5 response callback status=5 txid=pactest00100202212221548525731 referenceno=ordno20221222151220 paymethod=01 amt=1000 notaxamt=0 vat=0 fee=0 currency=idr goodsnm=goods+for+testing+pre+ +auth+token billingnm=john+doe transdt=20221222 transtm=154852 authno=525731 issubankcd=cena acqubankcd=bmri issubanknm=bca acqubanknm=mandiri cctranstype=1 cardno=53079511 1111 cardexpyymm=2712 instmnttype=1 instmntmon=1 recurringtoken=null preauthtoken=edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb matchcl=1 merchanttoken=1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524 setelah melakukan registrasi dan {{pembayaran}} menggunakan {{checkoutproduct}} {{api}} , jika ingin melakukan multiple capture dengan menggunakan pre auth token {{yang}} sama, silakan melakukan registrasi kembali kemudian melakukan capture pada payment v2 credit card dengan menambahkan pre auth token pada {{parameter}} preauthtoken beserta memasukkan cvv callback handling api checkout 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 diterima callbackurl anda, kami merekomendasikan {{merchant}} untuk melakukan verifikasi status dengan menggunakan status inquiry api checkout docid\ tsmzvn ulka6hnmbkk5wl callback handling sangat penting untuk membantu meminimalisir tindakan fraud kami sangat merekomendasikan {{merchant}} untuk melakukan verifikasi menggunakan 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" }