POST
/
v1
/
service
/
voucher
/
{voucherId}
/
redeem

Path Parameters

voucherId
string
required

The unique identifier of the voucher to redeem.

Body

application/json
target_account_id
string
required

The ID of the account that will receive the redeemed value of the voucher.

metadata
object

Optional metadata to be associated with the redemption transaction.

redemption_value
object

The value to be redeemed from the voucher. If not specified, the entire remaining value of the voucher will be redeemed. For partial redemption, specify a value less than the voucher's current value.

Response

200 - application/json
expires_at
string
required

The expiration date of the voucher in ISO 8601 format.

funding_source_account
string
required

The account ID from which funds were sourced to back the voucher.

provider_name
string
required

The name of the voucher provider or issuing system.

redeemed_at
string
required

The timestamp when the voucher was last redeemed, in ISO 8601 format.

redeemed_to_account_id
string
required

The ID of the account that received the redeemed voucher value.

redeemed_value
object
required

The value that was redeemed in this transaction.

redemption_transaction_id
string
required

The ID of the transaction created for this redemption.

remaining_value
object
required

The remaining value on the voucher after this redemption.

status
enum<string>
required

The current status of the voucher.

Available options:
ACTIVE,
PARTIALLY_REDEEMED,
FULLY_REDEEMED,
EXPIRED,
CANCELLED
value
object
required

The value of the voucher.

voucher_id
string
required

Unique identifier for the voucher.