NICEPAY API
...
Checkout API
Registration - API Checkout

Convenience Store - API Checkout

14min

About Convenience Store - API Checkout



This uses by to request to for using .



Checkout Convenience Store Flow Process


CVS Payment Flow
CVS Payment Flow


Description of registration steps on CVS:

  1. The does .
  2. The sends data to .
  3. The registers via Registration with .
  4.  validates and generates number.
  5.  sends number that needs to be paid to .
  6. The sends number that needs to be paid to .
  7. The receives CVS number.
  8. The sends CVS number to CVS.
  9. CVS sends inquiry data to .
  10.  with inquiry request.
  11.  sends inquiry to CVS.
  12. The makes a .
  13. The s with a at CVS.
  14. CVS with proof of .
  15. CVS sends proof to .
  16. CVS sends a to .
  17.  updated .
  18.  sends s to s.
  19. The submits a check to .
  20.  accepts applications.
  21.  sends a response to .
  22. The receives final .
  23. The sends results of to .



NICEPAY Secure Payment Page Convenience Store


Secure Payment Page
Secure Payment Page


The image above is a sample with method using Secure Page.

CVS - Secure Payment Page
CVS - Secure Payment Page


After choosing method, you will provide with (Indomaret & Alfamart) lists that can choose whether to continue .

Success - Secure Payment Page
Success - Secure Payment Page


The of registration request completes, you can continue until settlement by following guidelines on CVS Payment Guide.



API Checkout Transaction Payment



API URL

/nicepay/redirect/v2/payment

Request Method

Redirect-GET

Header

Content-Type: application/Form-UrlEncoded



Request Parameters for Payment



Parameter

Type

Size

Description

Remark

paymentURL

Required

ANS

14

 URL

Required

https://dev.nicepay.co.id/nicepay/redirect/v2/payment

tXid

Required

AN

30

Transaction ID



IONPAYTEST00202212231106386098



Response Parameters (CallbackUrl) - Payment



Parameter

Type

Size

Description

Remark

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

CVS

N

20

 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

Note: Response will be sent through callBackurl with Content-type: application/json and method: POST Parameter.

Sample Parameter for CallbackUrl API Checkout Payment



On when , response from request that got hit is Callback URL.

URL Request
URL Callback
Response Callback




CallBack Handling API Checkout



When Callback received to your callbackUrl, we strongly recommend to verify Status by using Status Inquiry - API Checkout.

CallBack Handling is necessary to minimize Fraud actions. We strongly recommend to verify using callBack parameter.

Callback Handling Flow
Callback Handling Flow

URL CallBack
Response CallBack