---
title: Convenience Store - API Checkout
slug: nicepay-api-convenience-store-payment-api-checkout
description: Informasi tentang API Checkout - Payment untuk metode pembayaran Convenience Store yang disediakan oleh NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WIH2egACHe_De_uS8WKKY_rdrx9d8diazpgm07xfz2test-1.png
icon: {"faIcon":"fa-solid fa-credit-card"}
docTags:
createdAt: 2022-12-19T10:12:10.000Z
---
# 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:
1. Pelanggan melakukan *request* checkout.
2. Pelanggan mengirimkan data kepada Merchant.
3. Merchant mendaftarkan *checkout* melalui API Registration kepada NICEPAY.
4. NICEPAY melakukan validasi dan *generate *nomor pembayaran.
5. NICEPAY mengirim nomor yang harus dibayarkan kepada Merchant.
6. Merchant mengirim nomor yang harus dibayarkan kepada Pelanggan.
7. Pelanggan memberikan nomor CVS.
8. Pelanggan mengirim data CVS number kepada CVS.
9. CVS mengirim data inquiry ke NICEPAY.
10. NICEPAY memproses *request* inquiry.
11. NICEPAY mengirim informasi *inquiry* ke CVS.
12. Pelanggan melakukan pembayaran.
13. Pelanggan melakukan proses pembayaran pada CVS.
14. CVS memproses bukti pembayaran .
15. CVS mengirim bukti pembayaran ke Pelanggan.
16. CVS mengirimkan notifikasi kepada NICEPAY.
17. NICEPAY memperbarui status transaksi.
18. NICEPAY mengirim notifikasi kepada Merchant.
19. Merchant *request* pemeriksaan status kepada NICEPAY.
20. NICEPAY menerima *request* cek status dari Merchant.
21. NICEPAY mengirimkan *response *kepada Merchant.
22. Merchant menerima status terakhir.
23. 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](docId:_dY8vW1ygeXkx0NQ0J4GB).
# 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 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 |
| `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | 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](docId\:DwzaQDD7DXZMECz80A6o8) | ALMA
When Success |
| `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221223
When Success |
| `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 110638
When Success |
:::hint{type="info"}
Catatan: *Response* parameter akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json`dan metode: `POST Parameter`.
:::
## Sample Parameter for Convenience Store - API Checkout (CallbackUrl)
***
:::hint{type="success"}
Pada pembayaran saat *Checkout*, *response *dari *request *yang di-*hit *adalah Callback URL.
:::
### Request Parameter
:::CodeblockTabs
cURL
```curl
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
:::CodeblockTabs
Response Callback
```curl
tXid=IONPAYTEST00202212231106386098
referenceNo=ordNo20221223111252
amount=10000
transDt=20221223
transTm=110638
payNo=9041231106386098
mitraCd=ALMA
resultCd=0000
resultMsg=SUCCESS
```
:::
## Callback Handling API Checkout Payment
***
:::hint{type="success"}
Saat *Callback* diterima `callbackUrl` Anda, kami merekomendasikan Merchant untuk melakukan verifikasi status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3).
:::
:::hint{type="warning"}
`Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan `Callback parameter`.
:::
::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/JJ84170Irn8FzuQoufY8W_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" showCaption="true"}
:::CodeblockTabs
URL Callback
```json
"callbackUrl" : "https://www.merchant.com/callbackUrl/"
```
Response Callback
```json
tXid:CVSNORMAL000202212211000494698
referenceNo:OrdNo-20221221101233
amount:10000
transDt:20221221
transTm:100049
payNo:504100002557
mitraCd:ALMA
resultCd:0000
resultMsg:SUCCESS
```
:::