​
Testing

Use the sandbox Payment Gateway environment before going to production.

​
Testing environment

Base URL: 
https://vpay.didi.cr
Contact your Vpay account manager for test client_id and client_secret.

​
Test flow checklist

  1. POST /api/public/security/auth — obtain token
  2. POST /pay/api/start-payment or generate-payment-link
  3. Open checkout URL in browser
  4. Pay with a test card
  5. GET /pay/api/payment/{checkoutSessionId} — verify state

​
Test cards

Use the test card numbers provided by your Vpay account manager for your sandbox terminal:
ScenarioCard number
Successful payment4242424242424242
3DS challenge4000000000003220
Use any future expiry date and any 3-digit CVC unless Vpay support specifies otherwise.

​
Swagger

Interactive API exploration is available at https://vpay.didi.cr/swagger.

​
Tips

  • Use unique transactionReferenceNumber values per test run to avoid VPAY_001.
  • Send X-idoperacion with a UUID per test for easier log correlation.
  • Do not use production credentials in sandbox or vice versa.

Getting started