Payloan - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran Payloan menggunakan Checkout API.
![Alur Pembayaran Paylate Alur Pembayaran Paylate](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/QSl2WkqoA9COLHuA0v_75_nicepay-archbee-payment-payloan-join.png?format=webp)
Deskripsi langkah pembayaran dengan Payloan:
- Pelanggan request checkout kepada Merchant.
- Merchant mengirimkan API Registration kepada NICEPAY.
- Pada bagian Registration;
- Jika menggunakan Akulaku:
- NICEPAY akan request pesanan kepada Akulaku selaku Payloan Partner.
- Akulaku akan generate pesanan.
- Akulaku mengirimkan response data kepada NICEPAY.
- NICEPAY akan mengirimkan capture response API Regist kepada Merchant.
- Jika menggunakan Kredivo/Indodana:
- NICEPAY akan menyimpan order regist.
- NICEPAY akan mengirimkan response order regist.
- Merchant mengirimkan API Payment kepada NICEPAY.
- Kemudian pada bagian Payment;
- Jika menggunakan Akulaku:
- NICEPAY mengarahkan Pelanggan kepada halaman Akulaku.
- Pelanggan melakukan login akun.
- Pelanggan melakukan konfirmasi pembayaran kepada Akulaku selaku Payloan Partner.
- Akulaku melakukan validasi pembayaran.
- Akulaku mengalihkan Pelanggan dengan callbackUrl.
- Jika menggunakan Kredivo/Indodana:
- NICEPAY request checkout kepada Payloan Partner.
- Payloan Partner melakukan proses checkout.
- Payloan Partner mengirim response dan mengalihkan ke halaman milik Payloan Partner.
- Pelanggan melakukan konfirmasi pembayaran kepada Payloan Partner.
- Payloan Partner mengirimkan OTP kepada Pelanggan.
- Pelanggan memasukkan OTP kepada Payloan Partner.
- Payloan Partner melakukan validasi OTP.
- Payloan Partner melakukan konfirmasi hasil pesanan kepada Pelanggan.
- Pada bagian Notification;
- Jika menggunakan Akulaku:
- Akulaku selaku Payloan Partner mengirimkan push capture notif kepada NICEPAY.
- NICEPAY menyimpan notifikasi.
- NICEPAY mengirimkan capture update notification kepada Merchant.
- Merchant menampilkan response kepada Pelanggan.
- Jika menggunakan Kredivo/Indodana:
- Payloan Partner mengirimkan push notification kepada NICEPAY.
- NICEPAY melakukan validasi terhadap notifikasi yang diterima.
- NICEPAY mengajukan konfirmasi pesanan.
- Payloan Partner melakukan konfirmasi proses pesanan.
- Payloan Partner mengirim data konfirmasi pesanan kepada NICEPAY.
- NICEPAY mengirimkan hasil konfirmasi pesanan.
- Jika Payloan Partner yang digunakan adalah Akulaku, Pelanggan dapat melakukan konfirmasi bukti pembayaran:
- Pelanggan mengirimkan konfirmasi bukti pembayaran kepada Merchant.
- Merchant mengajukan konfirmasi bukti pembayaran kepada NICEPAY.
- NICEPAY mengajukan proses konfirmasi bukti pembayaran kepada Akulaku.
- Akulaku melakukan proses konfirmasi bukti pembayaran.
- Akulaku mengirim response data kepada NICEPAY.
- NICEPAY mengirim response data kepada Merchant.
- Merchant menampilkan hasil data kepada Pelanggan.
- Merchant mengajukan pemeriksaan status menggunakan API Status kepada NICEPAY.
- NICEPAY mengirimkan response pemeriksaan status.
- Merchant menerima status terakhir.
- Merchant mengirimkan status konfirmasi 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 Checkout pembayaran dengan metode Payloan menggunakan NICEPAY Secure Payment Page.
![Success - Secure Payment Page Success - Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/qRcpEzhxJymcn-WztW6Nz_id-new-secure-payment-page-payloan-3.png?format=webp)
Setelah Proses request registrasi pembayaran selesai, Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti panduan pada halaman Panduan Bayar Payloan.
API URL | /nicepay/redirect/v2/payment |
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
Berikut adalah daftar Request Parameter untuk API Payment Payloan pada Checkout API.
Catatan untuk Payloan, silakan berikan pesan peringatan kepada Pelanggan untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada Pelanggan.
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 | PAYLOANTES00202212201645434449 |
Catatan: Response parameter akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | SUCCESS |
tXid | AN | 30 | Transaction ID | PAYLOANTES00202212201645434449 When Success |
referenceNo | ANS | 40 | Order Number | ORD20221220161200 When Success |
payMethod E-Wallet, Payloan | N | 2 | 06 When Success | |
amt | N | 12 | Transaction Amount | 10000 When Success |
currency E-Wallet, Payloan | A | 3 | Currency | IDR When Success |
goodsNm E-Wallet, Payloan | AN | 100 | Goods Name | John+Doe When Success |
billingNm E-Wallet, Payloan | A | 100 | Billing Name | John+Doe When Success |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221220 When Success |
transTm | N | 6 | Transaction Time (HH24MISS) | 164543 When Success |
description | AN | 100 | Transaction Description | Test+Transaction+Nicepay When Success |
authNo Only CC | N | 10 | Approval Number | When Success |
issuBankCd Only CC | A | 4 | When Success | |
acquBankCd Only CC | A | 4 | When Success | |
issuBankNm Only CC | A | 255 | Issuing Bank Name | When Success |
acquBankNm Only CC | A | 255 | Acquiring Bank Name | When Success |
cardNo Only CC | ANS | 20 | Card Number with Masking | When Success |
recurringToken Only CC (Additional) | AN | 255 | Recurring Token | When Success |
preauthToken | AN | 255 | Pre-Auth Token | null When Success |
ccTransType | AN | 2 | When Success | |
mitraCd Direct Debit, E-Wallet, Payloan | A | 4 | KDVI When Success | |
receiptCode | ANS | 20 | Authorization Number | When Success |
mRefNo | AN | 18 | Reference Number | When Success |
cardExpYymm | N | 4 | Card Expiry (YYMM) | When Success |
instmntType | N | 2 | When Success | |
instmntMon | N | 2 | Installment Month 1: 1 Month/Full Payment, if instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months | When Success |
timeStamp | N | 14 | API Request Timestamp | When Success |
merchantToken | AN | 255 | Merchant Token | When Success |
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/hB3AyDaMVCRKhlIgcs-V4_nicepay-api-checkout-api-callback-handling-flow-1.png?format=webp)