Hands On API

nikmati produk dan layanan nicepay dengan single integrated api dari kami yang aman serta mudah untuk integrasi dengan bisnis anda mulai dengan proses integrasi yang cepat hanya dalam 15 menit! prasyarat mid/imid (merchant id) api key (merchant key) nicepay sdk optional silakan periksa prasyarat pada halaman docid\ n1tlg7zlqifvslrhqcibg terlebih dahulu alur pembayaran deskripsi langkah alur pembayaran kartu kredit 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 kepada halaman milik nicepay kepada merchant merchant mengirimkan halaman pembayaran nicepay kepada pelanggan pelanggan memilih metode pembayaran pelanggan memasukkan data kartu pelanggan mengirimkan informasi data kartu kepada nicepay nicepay memproses 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 inquiry ke nicepay nicepay menerima pengajuan nicepay secara otomatis mengirimkan response inquiry kepada merchant merchant menerima status terakhir merchant mengirim halaman hasil transaksi kepada pelanggan integrasi pembayaran dalam proses ini, anda akan menggunakan produk docid\ yxig kkwrukcb ltm 1bc kami seluruh transaksi pada docid\ ij7v8nqcgstvouzugsfc7 akan melakukan redirect ke nicepay secure payment page sebagai proses pembayaran ikuti lima langkah mudah di bawah ini untuk melakukan integrasi pembayaran dengan nicepay melakukan panggilan api transaction registration redirect ke nicepay secure payment page proses pembayaran di nicepay secure payment page nicepay akan melakukan redirect end user ke callbackurl merchant merchant melakukan panggilan api status inquiry api transaction registration api end point https //dev nicepay co id/nicepay/redirect/v2/registration https //dev nicepay co id/nicepay/redirect/v2/registration request method post post header content type application/json description perform transaction registration merchant token sha256(timestamp+imid+referenceno+amt+merchantkey) request { "timestamp" "20221012080918", "imid" "ionpaytest", "paymethod" "00", "currency" "idr", "amt" "10000", "referenceno" "order20221012080918", "callbackurl" "https //dev nicepay co id/ionpay client/paymentresult jsp", "goodsnm" "test transaction nicepay", "billingnm" "john doe", "billingphone" "081288998899", "billingemail" "john doe\@example com", "billingaddr" "jln raya kasablanka kav 88", "billingcity" "south jakarta", "billingstate" "dki jakarta", "billingpostcd" "12800", "billingcountry" "indonesia", "deliverynm" "delivery\@example com", "deliveryphone" "081288998899", "deliveryaddr" "jln raya kasablanka kav 88", "deliverycity" "south jakarta", "deliverystate" "dki jakarta", "deliverypostcd" "12800", "deliverycountry" "indonesia", "dbprocessurl" "https //merchant com/api/dbprocessurl/notif", "merchanttoken" "d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed", "userip" "127 0 0 1", "cartdata" "{\\"count\\" 3,\\"item\\" \[{\\"goods id\\" 30,\\"goods name\\" \\"beanie\\",\\"goods type\\" \\"accessories\\",\\"goods amt\\" 1000,\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" 1,\\"goods url\\" \\"http //www nicestore com/product/beanie/\\"},{\\"goods id\\" 31,\\"goods name\\" \\"belt\\",\\"goods type\\" \\"accessories\\",\\"goods amt\\" 5000,\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" 1,\\"goods url\\" \\"http //www nicestore store/product/belt/\\"},{\\"img url\\" \\"http //www jamgora com/media/avatar/noimage png\\",\\"goods name\\" \\"shipping fee\\",\\"goods id\\" \\"shipping for ref no 278\\",\\"goods detail\\" \\"flat rate\\",\\"goods type\\" \\"shipping with flat rate\\",\\"goods amt\\" \\"4000\\",\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" \\"1\\",\\"goods url\\" \\"https //wwww nicestore store\\"}]}", "sellers" "\[{\\"sellersid\\" \\"nicepay namamerchant\\",\\"sellersnm\\" \\"nicepayshop\\",\\"sellersurl\\" \\"http //nicestore store/product/beanie/\\",\\"sellersemail\\" \\"nicepay\@nicepay co id\\",\\"sellersaddress\\" {\\"sellernm\\" \\"nicepayshop\\",\\"sellerlastnm\\" \\"nicepayshop\\",\\"selleraddr\\" \\"jln kasablanka kav 88\\",\\"sellercity\\" \\"jakarta\\",\\"sellerpostcd\\" \\"14350\\",\\"sellerphone\\" \\"082111111111\\",\\"sellercountry\\" \\"id\\"}}]", "instmnttype" "2", "instmntmon" "1", "recurropt" "0", "bankcd" "", "mitracd" "", "merfixacctid" "", "vacctvaliddt" "", "vacctvalidtm" "" } response { "resultcd" "0000", "resultmsg" "success", "txid" "ionpaytest00202212191025073439", "referenceno" "order20221012080918", "paymethod" "00", "amt" "10000", "transdt" "20221219", "transtm" "102508", "description" null, "currency" "idr", "goodsnm" "test transaction nicepay", "billingnm" "john doe", "payvaliddt" null, "payvalidtm" null, "paymenturl" "https //dev nicepay co id/nicepay/redirect/v2/payment" } akses spesifikasi api lebih lengkap di docid\ fqje 48 bzdt4uimqbfcx transaction payment api end point https //dev nicepay co id/nicepay/redirect/v2/payment https //dev nicepay co id/nicepay/redirect/v2/payment request method get get header content type application/form urlencoded description perform transaction registration merchant token sha256(timestamp+imid+referenceno+amt+merchantkey) setelah mendapatkan response , anda dapat mengalihkan pelanggan menuju halaman pembayaran nicepay tautan tersebut merupakan penggabungan response parameter paymenturl + txid https //dev nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202212191025073439 contoh di atas merupakan transaction payment menggunakan metode pembayaran kartu kredit temukan spesifikasi api lebih lengkap di docid\ z66faaruepdb5elqcr5rm callback handling setelah user memilih metode pembayaran kartu kredit, user akan dikembalikan ke halaman merchant callbackurl dengan metode post dan pengiriman parameter saat callback diterima callbackurl anda, kami merekomendasikan merchant untuk melakukan verifikasi status dengan menggunakan docid 9ivqi i4yka9s1oz6s ha callback handling sangat penting untuk membantu meminimalisir tindakan fraud kami sangat merekomendasikan merchant untuk melakukan verifikasi menggunakan callback parameter callbackurl "callbackurl" "https //www merchant com/callbackurl/" callback parameter { "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" } selamat! anda telah berhasil melakukan percobaan integrasi! jelajahi lebih jauh melalui tautan di bawah ini see also temukan penjelasan terkait metode pembayaran dan produk kustomisasi pada halaman docid\ cn5a57nq9rzmuje9fdnwm temukan penjelasan terkait produk yang sudah disediakan nicepay pada halaman docid\ yxig kkwrukcb ltm 1bc kunjungi halaman docid tboqgqs t6sk zixql55 untuk mempelajari produk terbaru nicepay kunjungi halaman docid\ tur 6cb3iekrga0l6oo46 untuk mempelajari layanan mengirim pesan yang dimiliki nicepay