Direct Debit - API Checkout
Tentang Direct Debit - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran Direct Debit menggunakan Checkout API.
Alur Proses
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.
NICEPAY Secure Payment Page
Gambar di atas adalah contoh pembayaran dengan metode Direct Debit menggunakan NICEPAY Secure Payment Page.
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.
Proses request registrasi pembayaran telah selesai. Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti panduan Panduan Bayar Direct Debit.
API Checkout Transaction Payment
API URL | /nicepay/redirect/v2/payment |
|---|---|
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
Request Parameter for Direct Debit - API Checkout (CallbackUrl)
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 |
Response Parameter for Direct Debit - API Checkout (CallbackUrl)
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.
Sample Parameter for Direct Debit - API Checkout (CallbackUrl)
Pada pembayaran saat Checkout, response dari request yang di-hit adalah Callback URL.
Request Parameter
curl -X GET "https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=Please+do+payment+on+jenius+pay+apps&tXid=TNICECP04100202305250918306465&referenceNo=ORD20230525090536&amt=&transDt=20230525&transTm=091830"Callback Parameter
merchantToken=46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa
goodsNm=Jhon+Doe
referenceNo=ORD20230525090536
mitraCd=JENC
tXid=TNICECP04100202305250918306465
amt=5000
receiptCode=951527524097
instmntType=2
billingNm=Jhon+Doe
matchCl=0
mRefNo=202305250918303
payMethod=04
currency=IDR
instmntMon=1
status=0
Callback Handling API Checkout Payment
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.
merchantToken=46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa
goodsNm=Jhon+Doe
referenceNo=ORD20230525090536
mitraCd=JENC
tXid=TNICECP04100202305250918306465
amt=5000
receiptCode=951527524097
instmntType=2
billingNm=Jhon+Doe
matchCl=0
mRefNo=202305250918303
payMethod=04
currency=IDR
instmntMon=1
status=0