Payment - API Checkout
10 min
menampilkan payment page dari paymenturl ketika berhasil mendaftarkan request pada registration api checkout docid\ fqje 48 bzdt4uimqbfcx , akan mendapatkan response berupa paymenturl untuk menampilkan payment page di sisi front end, diperlukan untuk melakukan mapping paymenturl tersebut terlebih dahulu dengan tambahan pada url nya, yaitu ?txid= dan dilengkapi dengan txid 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 ajukan sudah bisa dibayarkan oleh hanya perlu menampilkan tautan atau embedded link tersebut pada website miliki untuk shopeepay dan ovo, kami sarankan agar membuka melalui perangkat ponsel dimiliki parameter format payment page parameter tipe ukuran deskripsi contoh / catatan paymenturl \<font color="#2166ae">required\</font> ans 14 url https //nicepay co id/nicepay/redirect/v2/payment txid \<font color="#2166ae">required\</font> an 30 transaction id ionpaytest00202203211640309389 after payment handling setelah sudah berhasil dilakukan oleh , mengenai tersebut, berhasil maupun gagal, akan terkirim secara otomatis ke melalui callbackurl dan dbprocessurl masukkan pada saat request melalui registration api checkout docid 1ivcsjrorn0g44yyx dpb kunjungi notification api checkout docid\ ol624niuwcpldwm3ojtj2 untuk mendapatkan 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 \<font color="#2166ae">e wallet, payloan\</font> n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 01 when success amt n 12 transaction amount 10000 when success currency \<font color="#2166ae">e wallet, payloan\</font> a 3 currency idr when success payno \<font color="#2166ae">cvs\</font> n 20 number goodsnm \<font color="#2166ae">e wallet, payloan\</font> an 100 goods name testing transaction when success billingnm \<font color="#2166ae">e wallet, payloan\</font> 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 transaction when success authno \<font color="#2166ae">only cc (additional)\</font> n 10 approval number 080623 when success issubankcd \<font color="#2166ae">only cc\</font> a 4 issuing bank code docid\ ky4ppujot06atnie easf othr when success acqubankcd \<font color="#2166ae">only cc\</font> a 4 acquiring bank code docid\ ky4ppujot06atnie easf bmri when success cardno \<font color="#2166ae">only cc\</font> ans 20 card number with masking 453211 1111 when success timestamp n 14 request timestamp 20221212121212 when success merchanttoken \<font color="#2166ae">cc\</font> an 255 token 2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6 when success cardexpyymm \<font color="#2166ae">cc\</font> n 4 card expiration ( yymm ) 2712 when success instmntmon \<font color="#2166ae">cc\</font> n 2 installment month 1 1 month/full , jika instmnttype null/1 3 3 months 6 6 months 12 12 months 1 when success instmnttype \<font color="#2166ae">cc\</font> n 2 installment type code docid\ rt2c32s9hfl aohyoebv5 1 when success cctranstype \<font color="#2166ae">cc\</font> an 2 credit card transaction type docid 5kylpx5mpjsl96c8mhoik 1 normal 2 recurring 3 pre auth 4 capture 1 when success recurringtoken \<font color="#2166ae">only cc (additional)\</font> an 255 recurring token vat \<font color="#2166ae">cc\</font> n 12 value added tax ( ) fee \<font color="#2166ae">cc\</font> n 12 service fee notaxamt \<font color="#2166ae">cc\</font> n 12 tax fee amount mitracd \<font color="#2166ae">direct debit\</font> \<font color="#2166ae">, e wallet, payloan\</font> a 4 mitra code docid\ tm257gq3dxgzf98uz0l33 bankvacctno \<font color="#2166ae">va\</font> n 20 va number response 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 di capture tidak melebihi dana dimiliki saat callback diterima callbackurl , kami sangat menganjurkan untuk melakukan verifikasi status menggunakan status inquiry api checkout docid\ tsmzvn ulka6hnmbkk5wl callback handling dapat sangat membantu untuk meminimalisir terjadinya fraud , kami sangat merekomendasikan untuk melakukan verifikasi callback handling