Convenience Store - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran Convenience Store menggunakan Checkout API.
![Alur Pembayaran CVS Alur Pembayaran CVS](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/UfP4TEy_tZh3bHthmsF8v_nicepay-archbee-payment-cvs-1-1.png?format=webp)
Deskripsi langkah pendaftaran pada CVS:
- Pelanggan melakukan request checkout.
- Pelanggan mengirimkan data kepada Merchant.
- Merchant mendaftarkan checkout melalui API Registration kepada NICEPAY.
- NICEPAY melakukan validasi dan generate nomor pembayaran.
- NICEPAY mengirim nomor yang harus dibayarkan kepada Merchant.
- Merchant mengirim nomor yang harus dibayarkan kepada Pelanggan.
- Pelanggan memberikan nomor CVS.
- Pelanggan mengirim data CVS number kepada CVS.
- CVS mengirim data inquiry ke NICEPAY.
- NICEPAY memproses request inquiry.
- NICEPAY mengirim informasi inquiry ke CVS.
- Pelanggan melakukan pembayaran.
- Pelanggan melakukan proses pembayaran pada CVS.
- CVS memproses bukti pembayaran.
- CVS mengirim bukti pembayaran ke Pelanggan.
- CVS mengirimkan notifikasi kepada NICEPAY.
- NICEPAY memperbarui status transaksi.
- NICEPAY mengirim notifikasi kepada Merchant.
- Merchant request pemeriksaan status kepada NICEPAY.
- NICEPAY menerima request cek status dari Merchant.
- NICEPAY mengirimkan response kepada Merchant.
- Merchant menerima status terakhir.
- Merchant mengirimkan hasil pesanan 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 Convenience Store menggunakan NICEPAY Secure Payment Page.
![CVS - Secure Payment Page CVS - Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/MeTO5Xn0ZyF6c-xpgf2Nd_id-new-secure-payment-cvs-2.png?format=webp)
Setelah memilih metode Convenience Store, Anda akan disediakan daftar Convenience Store (Indomaret & Alfamart) yang dapat dipilih untuk melanjutkan proses pembayaran.
![Success - Secure Payment Page Success - Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/0KavFt1llPt8JAQ_VV-Bf_nicepay-secure-payment-page-11.png?format=webp)
Proses pengajuan pendaftaran pembayaran telah selesai, Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti panduan Panduan Bayar CVS.
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 Required | https://dev.nicepay.co.id/nicepay/redirect/v2/payment |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST00202212231106386098 |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | SUCCESS |
tXid | AN | 30 | Transaction ID | IONPAYTEST00202212231106386098 When Success |
referenceNo | ANS | 40 | Order Number | ordNo20221223111252 When Success |
amt | N | 12 | Transaction Amount | 10000 When Success |
payNo | N | 20 | Payment Number | 9041231106386098 When Success |
mitraCd | AN | 4 | Mitra Code | ALMA When Success |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221223 When Success |
transTm | N | 6 | Transaction Time (HH24MISS) | 110638 When Success |
Catatan: Response parameter akan dikirimkan melalui callBackurl dengan Content-type: application/jsondan 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/JJ84170Irn8FzuQoufY8W_nicepay-api-checkout-api-callback-handling-flow-1.png?format=webp)