Support

For integration or production issues, contact your Vpay technical account team with the details below.

Include these identifiers

IDWhere to find it
checkoutSessionIdResponse from start-payment or generate-payment-link
transactionReferenceNumberYour merchant reference in the request
internalTransactionReferenceNumberVpay internal reference in start/link response
X-idoperacionHeader you sent on the API request (if used)
client_idOAuth2 client ID (never send client_secret)
TimestampUTC time of the failed request
HTTP status and typeFrom ProblemDetails response body

Environment

Specify whether the issue occurs in sandbox or production, and the base URL used ({sandboxBaseUrl} or {productionBaseUrl}).

Security

Never share client_secret, full card numbers, or JWT tokens in support tickets. Redact Bearer tokens in logs.

Escalation checklist

  1. Reproduce in sandbox if possible.
  2. Capture the failing cURL (without secrets).
  3. Note the endpoint, request body (redacted), and full error response.
  4. Confirm terminal is active (VPAY_005 indicates provisioning issues).

Error codes

FAQ