Direct Debit - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran Direct Debit menggunakan Checkout API.
![Alur Pembayaran Direct Debit (Click Pay) Alur Pembayaran Direct Debit (Click Pay)](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/8KMCainQ7lgYtOEZKbwlh_nicepay-archbee-payment-clickpay-new-clickpay-redirect.png?format=webp)
Deskripsi langkah:
- Pelanggan mengajukan checkout kepada Merchant.
- Merchant akan melakukan pendaftaran checkout menggunakan API Registration kepada NICEPAY.
- NICEPAY menyimpan order regist.
- NICEPAY mengarahkan Merchant menuju halaman pembayaran NICEPAY.
- Merchant menampilkan halaman pembayaran NICEPAY kepada Pelanggan.
- Pelanggan memilih metode pembayaran.
- Pelanggan memasukkan data pembayaran (Jenius: Cashtag).
- Pelanggan mengirimkan metode pembayaran yang dipilih kepada NICEPAY.
- NICEPAY mengajukan pembayaran kepada Bank.
- Bank melakukan proses authentication.
- Bank mengirimkan notifikasi authentication kepada Pelanggan.
- Pelanggan melakukan authentication.
- Pelanggan mengajukan charge kepada Bank.
- Bank melakukan proses pembayaran.
- Bank mengirimkan hasil pembayaran kepada Pelanggan.
- Bank mengirimkan push notification kepada NICEPAY.
- NICEPAY melakukan validasi notifikasi.
- NICEPAY melakukan perubahan status.
- NICEPAY mengirimkan notifikasi kepada Merchant.
- Merchant mengajukan pemeriksaan status menggunakan API Status kepada NICEPAY.
- NICEPAY mengirimkan response status kepada Merchant.
- Merchant menerima status akhir
- Merchant mengirim konfirmasi perubahan status kepada Pelanggan
![Secure Payment Page Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/ht4_JU7NuZ_HpXokoi-Sl_id-new-secure-payment-page-gpn.png?format=webp)
Gambar di atas adalah contoh pembayaran dengan metode Direct Debit menggunakan NICEPAY Secure Payment Page.
![Direct Debit - Secure Payment Page Direct Debit - Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/FrEEjZVXdvNnEp5VuW23e_id-new-secure-payment-page-clickpay-2.png?format=webp)
Setelah memilih metode dengan Direct Debit, Anda akan dialihkan ke halaman untuk memilih layanan Direct Debit yang diinginkan. Selanjutnya, Anda akan dialihkan ke halaman form untuk memasukan identitas Anda. Pada contoh di atas, bila Anda memilih layanan Jenius, Anda akan diminta untuk memasukan data Cashtag Anda pada form yang telah disediakan. Setelah melengkapi form, Anda dapat melanjutkan proses pembayaran. Kemudian, Anda dapat melanjutkan sampai order payment sukses.
![Success - Secure Payment Page Success - Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/VzXj6ZNc98bNGPXio3u2x_id-new-secure-payment-page-clickpay-3.png?format=webp)
Proses request registrasi pembayaran telah selesai. Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti panduan Panduan Bayar Direct Debit.
API URL | /nicepay/redirect/v2/payment |
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
paymentURL Required | ANS | 14 | Payment URL | https://dev.nicepay.co.id/nicepay/redirect/v2/payment |
tXid Required | AN | 30 | Transaction ID | TNICECP04100202305250918306465 |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
status | N | 1 | 0 | |
merchantToken | AN | 255 | Merchant Token | 46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa When Success |
goodsNm Direct Debit, E-Wallet, Payloan | AN | 100 | Goods Name | Jhon+Doe When Success |
billingNm Direct Debit, E-Wallet, Payloan | A | 100 | Billing Name | Jhon+Doe When Success |
referenceNo | ANS | 40 | Order Number | ORD20230525090536 When Success |
mitraCd Direct Debit, E-Wallet, Payloan | A | 4 | Mitra Code | JENC When Success |
tXid | AN | 30 | Transaction ID | TNICECP04100202305250918306465 When Success |
amt | N | 12 | Transaction Amount | 5000 When Success |
receiptCode | ANS | 20 | Authorization Number | 951527524097 When Success |
instmntType | N | 2 | 2 When Success | |
instmntMon | N | 2 | Installment Month 1: 1 Month/Full Payment, jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months | 1 When Success |
matchCl | N | 1 | 0 When Success | |
mRefNo | AN | 18 | Reference Number | 202305250918303 When Success |
payMethod | N | 2 | 04 When Success | |
currency | A | 3 | Currency | IDR When Success |
Catatan: Response parameter akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.
Pada pembayaran saat Checkout, response dari request yang di-hit adalah Callback URL.
Saat Callback diterima callbackUrl Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan CallBack parameter.
![Alur Callback Handling Alur Callback Handling](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/fzdlOKawzyYatnepwv43z_nicepay-api-checkout-api-callback-handling-flow-1.png?format=webp)