Skip to main content
Providers may differ in supported capabilities, field requirements, and redemption behaviour. The supported providers can be discovered programmatically using the redemption types endpoint. The endpoint returns each redemption type, its capabilities, display metadata, and required source attributes, allowing clients to dynamically present available providers and collect the information required to redeem them.
Use the discovery endpoint as the source of truth to automatically stay up to date as providers and capabilities evolve.

Voucher

Vouchers are redeemed through three providers today: 1Voucher, OTT Mobile, and Blu Telecom (Blu Voucher).
ProviderTypeIdentifierPartial RedemptionBalance LookupChange Voucher ReturnedSMS Delivery
1Vouchervouchers.one_voucherpin (16 digit)YesNoYes, change_voucher field is returned in API ResponseYes, delivered by provider when phone_number is supplied
Blu Vouchervouchers.blupin
phone_number
YesYesYes, change_voucher field is returned in API ResponseNo
OTT Mobilevouchers.otttoken
serial_number (for lookup)
YesYesNoYes, delivered by provider when phone_number is supplied
1Voucher Redemption Behaviour Supports:
  • Full redemption
  • Partial redemption
Remaining Value
  • Where value remains after redemption, a replacement voucher is returned through the change_voucher field (PIN, serial number, barcode, instructions).
  • Where value remains after redemption, a replacement voucher is delivered directly to the customer by SMS using the supplied phone number.
The replacement PIN is the customer’s only way to spend the residual balance, so it must be preserved and surfaced to the customer.

Blu Voucher
Redemption Behaviour Supports:
  • Full redemption
  • Partial redemption
Remaining Value
  • Where value remains after redemption, a replacement voucher is returned through the change_voucher field.
    The replacement PIN is the customer’s only way to spend the residual balance, so it must be preserved and surfaced to the customer.
OTT Mobile Redemption Behaviour Supports:
  • Full redemption
  • Partial redemption
Remaining Value
  • Where value remains after redemption, a replacement voucher is delivered directly to the customer by SMS using the supplied phone number.
The replacement token is the customer’s only way to spend the residual balance, so it must be preserved and surfaced to the customer.

Gift Cards

Coming soon.Gift cards will be supported as a stored value type in future.

Loyalty Points

Coming soon.Gift cards will be supported as a stored value type in future.