API Changes for Version 20260101

01 Jan 2026

Add Zepto APIVersion Header

✨
Added
Affected component: API

Add Zepto-API-Version header parameter to all API documentation

Mandatory Idempotency

❗️
Breaking
Affected component: API

A unique Idempotency-Key header is now mandatory when initiating payments.

This ensures requests can be safely retried without accidentally performing the same operation twice.

Affected endpoints:

Request Payment
Make a Payment
Issue a Refund
Add a Transfer

See Idempotent Requests for more detail.

Example

curl -X POST https://api.zeptopayments.com/payments \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: unique-key-123" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000}'

Migration Guide

Generate a unique key for each request (UUID recommended)
Add the Idempotency-Key header to all state-changing requests
Store keys to enable safe retries

Remove Payment Request History

🗑️
Removed
Affected component: API

Remove deprecated GET /payment_requests/:ref/history endpoint