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 .