Redeem a voucher into the customer vault

Accepts a rewards voucher and books its value into the voucher vault for a customer who has no active MVNO account yet. The vault row drains automatically when the account becomes ACTIVE (DMA + RICA complete). Idempotent for retries: replaying the same voucher after a successful vault redemption returns the existing redemption (no double deposit). A voucher already redeemed directly to an account returns 400.

Access: Auth methods: JWT bearer or API key. Allowed user types: MVNO. Requires permissions: voucher:create.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Voucher redemption code

string
required

Customer national ID or passport number (min 6 characters). Used as the drain key when the account later activates.

string
enum
required
Allowed:
string
required

MSISDN that initiated the redemption (audit only).

Responses
201

Voucher redeemed into vault

400

Invalid input or voucher not CONFIRMED

404

Voucher not found

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!