Merchant Redemption

Merchant redemption is the process for validating vouchers, creating redemption claims, and completing OTP verification.

Scope

Gift vouchers represent prepaid digital value that can be redeemed at eligible merchants. The merchant portal manages voucher lookup, balance and restriction checks, claim creation, and final verification.

Key Capabilities

• Validate voucher code, balance, status, and expiry.
• Confirm whether a voucher is restricted to the current merchant.
• Create a redemption claim for the selected amount.
• Verify the claim with the OTP provided by the voucher owner.
• Review completed and failed redemption outcomes for support and reconciliation.

Redemption Flow

Operator Guidance

The portal handles session authentication and authorization. Operators confirm voucher details, enter the redemption amount, and complete OTP verification.

Merchant API Authentication

For server-to-server redemption, merchant API requests must include:

• X-API-Key
• X-Timestamp
• X-Signature

Idempotency-Key and X-Correlation-Id remain optional tracing headers for the merchant API flow.

Next Steps

• Getting Started
• Voucher Redemption
• OTP Verification