​
Testing

Use the sandbox Payment Gateway environment before going to production.

​
Sandbox base URL

{sandboxBaseUrl}
Contact your Vpay account manager for sandbox 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 (ONVO)

When your terminal uses the ONVO processor, use cards from the ONVO test documentation:
ScenarioCard number
Successful payment4242424242424242
3DS challenge4000000000003220
Use any future expiry date and any 3-digit CVC unless ONVO docs specify otherwise.

​
Swagger

Interactive API exploration is available at: 
{sandboxBaseUrl}/swagger
Swagger complements this documentation; the MDX reference and Conventions reflect the supported public integration surface.

​
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