🚀 Convenient Checkout v2 API
Date: June 30, 2026
Audience: Merchants & Developers
Status: ✅ Available Now
Convenient Checkout v2 is available. The v2 API introduces significant enhancements over v1 — improved payment flows, richer response models, and expanded webhook support. A full migration guide is available to help you transition from v1 to v2.
What's in v2?
The v2 API brings meaningful improvements to the checkout integration experience:
| Area | What Changed |
|---|---|
| Checkout Sessions | Streamlined session creation with a single endpoint |
| Payment Methods | Expanded support — cards, bank accounts, and more |
| Webhooks | Richer event payloads with full resource snapshots |
| Error Responses | Structured error codes with machine-readable categories |
| API Versioning | Explicit versioning via URL path (/v2/) for predictable compatibility |
How to Migrate
The migration process is designed to be incremental. You do not need to switch everything at once.
Step 1 — Review the Migration Guide
Start with the Migration Guide for a full overview of what changes between v1 and v2.
Step 2 — Compare V1 and V2 API
Refer Comparison Guide
Step 3 — Update your integration
Follow the per-endpoint migration steps in the guide. Update your base URL from /v1/ to /v2/ and adopt the new request/response models.
Step 4 — Test in Stage
Validate all flows in the Stage before promoting to production.
API References
| Version | Reference | Status |
|---|---|---|
| v2 | API Reference v2 | ✅ Current |
| v1 | API Reference v1 | ⚠️ Legacy |
📚 Resources
| Resource | Link |
|---|---|
| Migration Guide | Migrate to CCG |
| API Reference v2 | /api-reference-v2/ |
| API Diff (v1 vs v2) | /api-diff/ |
| Webhooks v2 | /webhooks-v2/ |
| Getting Started | Getting Started |
🏁 Bottom Line
Use v2 for all new integrations. If you are on v1, the Migration Guide walks you through each step. v1 remains supported but will not receive new features.
Questions about migration? Contact your Convenient Checkout integration representative.