NICEPAY API
...
API Credit Card
Registration - API Credit Card
Pre-Auth & Capture - Registration API Credit Card
9min
tentang pre auth & capture pre auth & capture merupakan fitur lainnya dari {{kartukredit}} di mana {{merchant}} dapat menahan ( hold ) atau melakukan {{proses}} pre auth terlebih dahulu dari dana {{yang}} sudah dibayarkan oleh {{pelanggan}} {{anda}} kemudian, {{anda}} perlu melakukan validasi atas jumlah dana {{transaksi}} tersebut atau {{yang}} disebut dengan capture agar dana tersebut masuk ke dalam rekening {{bank}} {{anda}} jika {{anda}} melakukan {{proses}} capture setelah masa kedaluwarsa pre auth berakhir maka {{transaksi}} tersebut akan dianggap void dan dana {{transaksi}} tersebut akan dikembalikan kepada {{pelanggan}} {{anda}} maka, kami sarankan untuk segera melakukan {{proses}} capture sebelum masa kedaluwarsa {{transaksi}} pre auth tersebut habis pelajari mengenai fitur {{cc}} {{paymentproduct}} dengan pre auth & capture di fitur kartu kredit/debit docid\ o3geuxqpbrqbtckpuzf6b pre auth & capture registration credit card api api endpoint /nicepay/direct/v2/registration request method post post description pre auth & capture merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/json request parameter pre auth & capture registration langkah pertama {{yang}} perlu lakukan untuk mengaktifkan fitur pre auth & capture adalah melakukan registrasi {{transaksi}} {{kartukredit}} terlebih dahulu pada {{api}} registrasi ini proses ini dilakukan agar {{anda}} mendapatkan txid {{yang}} dapat dipakai untuk melakukan {{proses}} pre auth nantinya parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221202141217 imid required required an 10 {{merchant}} id ionpaytest paymethod required required n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 01 currency required required a 3 currency idr amt required required n 12 amount (number not in float format) 10000 (jumlah total amount goods dari cartdata ) referenceno required required ans 40 {{merchant}} 's reference number ordno20221202141217 goodsnm required required an 100 goods name testing transaction billingnm required required a 100 buyer name john doe billingphone required required n 15 buyer phone number 2112345678 billingemail required required ans 40 buyer e mail buyer\@merchant com billingaddr required required an 100 buyer address jln raya kasablanka kav 88 billingcity required required a 50 buyer city south jakarta billingstate required required a 50 billing state dki jakarta billingpostcd required required n 10 billing post number 14350 billingcountry required required a 10 billing country {{indonesia}} cartdata required required jsonstring 4000 cart data {} instmnttype required required n 2 installment type code docid\ rt2c32s9hfl aohyoebv5 1 (untuk preauth & recurring default 1) instmntmon required required n 2 installment month 1 1 month/full {{paymentproduct}} , jika instmnttype null/1 1 (untuk preauth & recurring default 1) recurropt required required n 2 0 automatic cancel 1 do not cancel 2 do not make token 2 dbprocessurl required required ans 255 notification url https //merchant com/dbprocessurl userip required for cc, e wallet, payloan, qris required for cc, e wallet, payloan, qris an 15 user ip 127 0 0 1 merchanttoken required required an 255 {{merchant}} token c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae description an 100 transaction description test transaction usersessionid an 100 user session id usersessionid useragent ans 100 user agent mozilla userlanguage a 2 user language en us response parameter pre auth token registration berikut ini adalah response {{parameter}} dari hasil request registrasi {{transaksi}} tipe pre auth & capture {{yang}} sebelumnya sudah dilakukan pada {{pembayaran}} {{kartukredit}} hasil {{parameter}} {{yang}} diperlukan untuk dapat melanjutkan ke {{proses}} berikutnya dari hasil response ini adalah txid untuk melanjutkan ke langkah berikutnya, silakan mengunjungi {{halaman}} pre auth & capture payment api credit card docid\ u02tzmaqg6u5l7zaesbe5 parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 result code docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message error code docid\ wpcemazro xvnxz 1zaib success txid an 30 transaction id pactest00101202206241007570327 referenceno ans 40 {{merchant}} reference number ordno20221215101254 paymethod n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 01 amt n 12 {{paymentproduct}} amount 10000 transdt n 8 transaction date ( yyyymmdd ) 20221212 transtm n 6 transction time ( hh24miss ) 121212 description an 100 transaction description testing transaction {{cc}} bankcd a 4 bank code docid\ ky4ppujot06atnie easf null vacctno n 20 virtual account null mitracd a 4 mitra code docid\ tm257gq3dxgzf98uz0l33 null payno n 12 cvs {{paymentproduct}} number null currency a 3 currency idr goodsnm an 100 goods name goods for testing transaction billingnm a 100 buyer name john doe vacctvaliddt n 8 va expiry date ( yyyymmdd ) null vacctvalidtm n 6 va expiry time ( hh24miss ) null payvaliddt n 8 expiry date ( yyyymmdd ) null payvalidtm n 6 expiry time ( hh24miss ) null requesturl ans 360 request url null paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) null paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) null qrcontent ans 360 qr string in plain text null qrurl ans 360 url for qr image, valid for 5 minutes null {{silakan}} memeriksa nicepay code docid dbbwgg3gtf 4wjx63nx6 untuk mengetahui kode umum beserta kode response dalam {{metodebayar}} {{kartukredit}} ataupun {{metodebayar}} lainnya di {{nicepay}} sample json credit card pre auth & capture registration form urlencoded { "timestamp" "20221214111261", "imid" "pactest001", "paymethod" "01", "currency" "idr", "amt" "5000", "merchanttoken" "b40cb019e938d0118b77cb6f564a7facf12472e5bbb598dde0cd43b2df46b2aa", "referenceno" "ordno20221214111261", "goodsnm" "goods for testing pre auth", "billingnm" "john doe", "billingphone" "081288998899", "billingemail" "john doe\@example com", "billingaddr" "jln raya kasablanka kav 88", "billingcity" "south jakarta", "billingstate" "dki jakarta", "billingcountry" "indonesia", "billingpostcd" "12800", "dbprocessurl" "http //ptsv2 com/t/merchant/post", "userip" "127 0 0 1", "instmnttype" "1", 	"instmntmon" "1", "cartdata" "{}}", "recurropt" "", "userlanguage" "en", "useragent" "mozilla/5 0 (windows nt 6 1; win64; x64; rv 47 0) gecko/20100101 firefox/47 0" json response { "resultcd" "0000", "resultmsg" "success", "txid" "pactest00101202212141139161454", "referenceno" "ordno20221214111261", "paymethod" "01", "amt" "5000", "transdt" "20221214", "transtm" "113918", "description" null, "bankcd" null, "vacctno" null, "mitracd" null, "payno" null, "currency" null, "goodsnm" null, "billingnm" null, "vacctvaliddt" null, "vacctvalidtm" null, "payvaliddt" null, "payvalidtm" null, "requesturl" null, "paymentexpdt" null, "paymentexptm" null, "qrcontent" null, "qrurl" null } java request //credit card pre auth registration// nicepay settimestamp("20221214111261"); nicepay setimid("pactest001"); nicepay setpaymethod("01"); nicepay setcurrency("idr"); nicepay setamt("5000"); nicepay setdesciption("testing registration credit card pre auth") nicepay setreferenceno("ordno20221214111261"); nicepay setinstmnttype("1"); nicepay setinstmntmon("1"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay setgoodsnm("goods for testing pre auth"); nicepay setbillingnm("john doe"); nicepay setbillingphone("081288998899"); nicepay setbillingemail("john doe\@example com"); nicepay setbillingaddr("jln raya kasablanka kav 88"); nicepay setbillingcity("south jakarta"); nicepay setbillingstate("dki jakarta"); nicepay setbillingcountry("indonesia"); nicepay setbillingpostcd("12800"); nicepay setdbprocessurl("http //ptsv2 com/t/merchant/post"); // request credit card registration nicepay ccpacregist(); // response string // system out println("final response string " + nicepay getresponsestring()); string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string txid = nicepay get("txid"); string referenceno = nicepay get("referenceno"); string paymethod = nicepay get("paymethod"); string amt = nicepay get("amt"); string transdt = nicepay get("transdt"); string transtm = nicepay get("transtm");