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