Reference

Specs, lookup tables, and behavioral references for the Von Payments API.

API surface

• API reference — complete endpoint catalog (OpenAPI 3.1)
• Session object — full schema, fields, lifecycle states
• Discovery endpoint — runtime API discovery (GET /.well-known/vonpay.json)
• Versioning — API version policy + deprecation timeline

Operational reference

• API keys — key formats (vp_sk_* secret, vp_pk_* publishable, ss_* session-signing, whsec_* webhook-signing), rotation, scoping
• Security — webhook signatures, TLS, encryption at rest, key rotation
• Rate limits — per-key limits, backoff guidance
• Error codes — every error code, what triggers it, how to recover

Testing

• Test cards — sandbox card numbers + decline-trigger PANs