Upgrade to Codapay API v2 and Unlock Saved Card Support

Codapay API v2 makes your integration simpler and more powerful — and it’s the only version that supports saved card functionality for returning users.

Here’s how to upgrade to v2 + enable saved cards in just a few easy steps.

Why Upgrade?

• One Global API Key per merchant — no more country-title key management

• Project ID support for easier transaction tracking across games or services

• Card Saving Support for faster checkout and higher conversion

• Fully compatible with your existing v1 setup

📘 See API v2 Overview | 💳 See Saved Card Integration Guide

Migration + Enablement Steps

1. Request v2 Access

Contact your Codapay integration support or account manager to:

• Get your v2.0 API key and project ID

• Ask to enable saved card functionality (optional, but recommended)

2. Update Your Integration

• Change the base endpoint from /v1.0/Payment to /v2.0/Payment

• Add projectId in the initRequest payload Example:

  "projectId": "YOUR_PROJECT_ID"

• Keep everything else the same: country, payType, items, profile, etc.

3. Enable Saved Cards

If you opted to enable saved card functionality:

• Pass these extra fields in your request:

  "enableSavePaymentMethod": true,
  "displaySavedPaymentMethodList": true,
  "userInitiated": true

• Include a unique partnerShopperId in the shopper object to link cards to users.

📘 Full Field List + Shopper Mapping

4. Test in Sandbox

Use your v2 key and projectId in the sandbox URL:

https://sandbox.codapayments.com/airtime/api/restful/v2.0/Payment

Try:

• A first-time card payment with saving enabled

• A returning user selecting a saved card

📘 View Request + Response Examples

5. Go Live

Once confirmed, update your production integration using the v2.0 key and projectId:

https://airtime.codapayments.com/airtime/api/restful/v2.0/Payment

You're now live on v2 — with saved cards enabled 🎉