Payment
Convenience Store (CVS)

CVS Integration & Testing

13min

Integration Steps and API Used


  1. Perform Call Transaction Registration API .
  2. Receive callbacks and push notifications from .
  3. Perform API Status Inquiry .
  4. Optional: do API Cancel  to cancel a .



CVS Testing Guide



Test Steps

Rules and Condition

  1. Using MID  or MID sandbox ( IONPAYTEST) AutoPaid.
  2. Make a  (CVS) registration.
  3. Write down or print payment code.
  4. Bring  payment code to Indomaret or Alfamart / Alfamidi / Dan+Dan / Lawson.
  5. Check your  inquiry.
  6. Pay according to  nominal listed.
  7. Take your  receipt.
  8. Transaction success.
  9. Check your (dbProcessUrl) .
  1. Notify  cashier that a  has been made using +'s name.
  2. CVS can be cancelled and returned after , but can only be done manually or after  validity period of  payNo number has expired. Cannot be installed via .
  3.  number (payNo) can expire by default in  7th day but also depending on  's preferences, settings can be adjusted ( most common are 24 hours, 3 days, etc).
  4. Terms based on CVS:
    • Alfamart & Alfamidi: transactions cannot be made after 10 p.m. and can be used again after 1 a.m. on  next day.
    • Indomaret: transactions cannot be made after 11 p.m. and can be used again after 1 a.m. on  next day.



Failed Transaction Possible Reason


  1. Entered incorrectly payNo.
  2. payNo expired or not valid.
  3. Rejected from .



Integration Checklist & Test Case



Implement Inquiry  after receiving  callback.

Implement Inquiry  after receiving   inside dbProcessUrl.

Review  logs.

Review firewall settings (eg. cloudflare for the dbprocessUrl).

Check  merchantToken implementation.

Execute scenario tests in Development Environment.

Execute test scenarios in Production Environment. Get Sample Scenario

Review Error Handling (Timeout, Failed, Negative Case).



Best Practice


  • payValidDt and payValidTm are used to set   deadline for Merchants who use these parameters.
  • When your dbProcessUrl  is received,  strongly recommends  to verify notifications using  Inquiry .
  • Notification Handling is useful to minimalize Fraud action.  strongly recommends  to verify Notification Handling.



See also

  CVS Payment Flow  to find out    during  with  .

  CVS Feature  to find out   features on  .

  CVS Glossary  to find out  particular term used on .

  CVS FAQ  if you want to find out frequently asked questions related to .

Updated 15 Mar 2024
Did this page help you?
PREVIOUS
CVS Feature
NEXT
CVS Transaction Settlement
Docs powered by Archbee