Convenience Store - API Checkout
Tentang Convenience Store - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran Convenience Store menggunakan Checkout API.
Alur Proses
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.
NICEPAY Secure Payment Page
Gambar di atas adalah contoh pembayaran dengan metode Convenience Store menggunakan NICEPAY Secure Payment Page.
Setelah memilih metode Convenience Store, Anda akan disediakan daftar Convenience Store (Indomaret & Alfamart) yang dapat dipilih untuk melanjutkan proses pembayaran.
Proses pengajuan pendaftaran pembayaran telah selesai, Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti Panduan Bayar CVS.
API Checkout Transaction Payment
API URL | /nicepay/redirect/v2/payment |
|---|---|
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
Request Parameters for Convenience Store - API Checkout (CallbackUrl)
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 |
Response Parameter for Convenience Store - API Checkout (CallbackUrl)
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.
Sample Parameter for Convenience Store - 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?tXid=IONPAYTEST00202212231106386098&referenceNo=ordNo20221223111252&amount=10000&transDt=20221223&transTm=110638&payNo=9041231106386098&mitraCd=ALMA&resultCd=0000&resultMsg=SUCCESS"Callback Parameter
tXid=IONPAYTEST00202212231106386098
referenceNo=ordNo20221223111252
amount=10000
transDt=20221223
transTm=110638
payNo=9041231106386098
mitraCd=ALMA
resultCd=0000
resultMsg=SUCCESS
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.
tXid:CVSNORMAL000202212211000494698
referenceNo:OrdNo-20221221101233
amount:10000
transDt:20221221
transTm:100049
payNo:504100002557
mitraCd:ALMA
resultCd:0000
resultMsg:SUCCESS