Migration Guide
How to migrate from 2026-01-01 to 2026-01-25
Migration from 2026-01-01 to 2026-01-25
This guide will help you migrate your integration from API version 2026-01-01 to 2026-01-25.
Breaking Changes
- Response Structure: Responses now use structured objects with explicit types
- Amount Format: Money values changed from scalar to
{value, currency}objects - Settlement Info: Fees grouped into
{gross, fees, net}structure - Webhook Format: Events now use envelope structure with
datawrapper
Step-by-Step Migration
Step 1: Update Amount Parsing
// Before (2026-01-01)
const amount = response.amount; // 50000
const currency = response.currency; // "TZS"
// After (2026-01-25)
const amount = response.amount.value; // 50000
const currency = response.amount.currency; // "TZS"Step 2: Update Fee Handling
// Before (2026-01-01)
const fee = response.fee_amount;
const net = response.net_amount;
// After (2026-01-25)
const fee = response.settlement.fees.value;
const net = response.settlement.net.value;Step 3: Update Webhook Handlers
// Before (2026-01-01)
const event = req.body.event;
const reference = req.body.reference;
// After (2026-01-25)
const eventType = req.body.type;
const eventId = req.body.id;
const data = req.body.data;