NICEPAY API
...
API Versi 2
Checkout API

Payment - API Checkout

10min
menampilkan payment page dari paymenturl ketika {{anda}} berhasil mendaftarkan request {{transaksi}} pada registration api checkout docid\ fqje 48 bzdt4uimqbfcx , {{anda}} akan mendapatkan response berupa paymenturl untuk menampilkan payment page di sisi front end, {{anda}} diperlukan untuk melakukan mapping paymenturl tersebut terlebih dahulu dengan tambahan {{parameter}} pada url nya, yaitu ?txid= dan dilengkapi dengan txid {{yang}} didapat pada response registration api checkout docid\ fqje 48 bzdt4uimqbfcx perhatikan contoh berikut ini paymenturl https //www nicepay co id/nicepay/redirect/v2/payment txid ionpaytest00202203211640309389 nicepay payment page https //www nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202203211640309389 ketika payment page tersebut sudah sesuai, maka {{transaksi}} {{yang}} {{anda}} ajukan sudah bisa dibayarkan oleh {{pelanggan}} {{anda}} hanya perlu menampilkan tautan atau embedded link tersebut pada website {{yang}} {{anda}} miliki untuk {{metodebayar}} {{ewallet}} shopeepay dan ovo, kami sarankan agar {{pelanggan}} {{anda}} membuka {{halaman}} {{pembayaran}} melalui perangkat ponsel {{yang}} dimiliki parameter format payment page parameter tipe ukuran deskripsi contoh / catatan paymenturl required required ans 14 {{paymentproduct}} url https //nicepay co id/nicepay/redirect/v2/payment txid required required an 30 transaction id ionpaytest00202203211640309389 after payment handling setelah {{transaksi}} sudah berhasil dilakukan oleh {{pelanggan}} {{anda}} , {{notifikasi}} mengenai {{status}} {{transaksi}} tersebut, berhasil maupun gagal, akan terkirim secara otomatis ke {{sistem}} {{anda}} melalui {{parameter}} callbackurl dan dbprocessurl {{yang}} {{anda}} masukkan pada saat request melalui registration api checkout docid 1ivcsjrorn0g44yyx dpb {{silakan}} kunjungi {{halaman}} notification api checkout docid\ ol624niuwcpldwm3ojtj2 untuk mendapatkan {{informasi}} lebih detail mengenai dbprocessurl response parameters (callbackurl) 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 ionpaytest01202212141112221428 when success referenceno ans 40 order number (empty) when success paymethod e wallet, payloan e wallet, payloan n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 01 when success amt n 12 transaction amount 10000 when success currency e wallet, payloan e wallet, payloan a 3 currency idr when success payno cvs cvs n 20 {{paymentproduct}} number goodsnm e wallet, payloan e wallet, payloan an 100 goods name testing transaction {{nicepay}} when success billingnm e wallet, payloan e wallet, payloan a 100 billing name john doe when success transdt n 8 transaction date ( yyyymmdd ) 20221212 when success transtm n 6 transaction time ( hh24miss ) 121212 when success description an 100 transaction description testing {{cc}} transaction when success authno only cc (additional) only cc (additional) n 10 approval number 080623 when success issubankcd only cc only cc a 4 bank code docid\ ky4ppujot06atnie easf othr when success acqubankcd only cc only cc a 4 bank code docid\ ky4ppujot06atnie easf bmri when success cardno only cc only cc ans 20 card number with masking 453211 1111 when success timestamp n 14 {{api}} request timestamp 20221212121212 when success merchanttoken cc cc an 255 {{merchant}} token 2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6 when success cardexpyymm cc cc n 4 card expiration ( yymm ) 2712 when success instmntmon cc cc 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 instmnttype cc cc n 2 installment type code docid\ rt2c32s9hfl aohyoebv5 1 when success cctranstype cc cc an 2 payment status code docid 5kylpx5mpjsl96c8mhoik 1 normal 2 recurring 3 pre auth 4 capture 1 when success recurringtoken only cc (additional) only cc (additional) an 255 recurring token vat cc cc n 12 value added tax ( {{vat}} ) fee cc cc n 12 service fee notaxamt cc cc n 12 tax fee amount mitracd direct debit direct debit , e wallet, payloan , e wallet, payloan a 4 mitra code docid\ tm257gq3dxgzf98uz0l33 bankvacctno va va n 20 va number response {{parameter}} akan dikirimkan melalui callbackurl dengan content type application/json dan metode post parameter sample json for callbackurl url payment https //nicepay co id/nicepay/redirect/v2/payment?txid=ionpaytest00202203211640309389 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" } callback handling api checkout 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 sangat menganjurkan {{merchant}} untuk melakukan verifikasi status menggunakan status inquiry api checkout docid\ tsmzvn ulka6hnmbkk5wl callback handling dapat sangat membantu untuk meminimalisir terjadinya fraud , kami sangat merekomendasikan {{merchant}} untuk melakukan verifikasi callback handling