Postman

The Postman collection mirrors the partner and merchant API flows documented in this guide.

Collection access is provided during integration onboarding.

Download

Download Postman Collection

Import Steps

1. Open Postman and select Import.
2. Choose the downloaded odm-postman-collection.json file.
3. Set collection/environment variables before sending requests.

Collection Scope

• Partner catalog browsing
• Partner airtime topup
• Partner data package activation
• Partner voucher issuance
• Merchant-redeem login
• Merchant-redeem voucher detail lookup
• Merchant-redeem claim initiation
• Merchant-redeem OTP submission
• Merchant-redeem callback

Usage Notes

• API_BASE_URL is the partner API base URL and typically ends in /api/v1.
• MERCHANT_API_BASE_URL is the merchant-redeem API base URL shared during onboarding.
• Set SIGNING_PRIVATE_KEY to the PKCS#8 Ed25519 private key PEM issued for partner API access.
• Set PARTNER_API_KEY to match the partner API access record that owns the Ed25519 signing key.
• The collection pre-request script auto-generates a fresh X-Timestamp and X-Signature for partner requests when SIGNING_PRIVATE_KEY is configured.
• Set MERCHANT_API_KEY for the merchant-redeem login request.
• For merchant-redeem signed POST requests, set MERCHANT_SIGNATURE to a base64 ECDSA P-256 SHA-256 signature over JSON.stringify(request body).
• After merchant-redeem login, set MERCHANT_API_TOKEN to the returned accessToken.
• Set Idempotency-Key for required partner write endpoints. Merchant-redeem uses body idempotencyKey and callback callbackId.
• Treat the collection as a test and troubleshooting tool, not as a production integration runtime.