NICEPAY API
...
Checkout API
Payment - 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