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-api)
• Versioning — API version policy + deprecation timeline

Operational reference

• API keys — key formats (vp_sk_test_*, vp_sk_live_*, rk_*), rotation, scoping
• Security — webhook signatures, TLS, IP allowlists
• 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