Discard Voucher

Discard an unused voucher — releases it from the reserved state.

POST /api/v1/vouchers/:voucherId/discard-voucher

Discards a voucher that is no longer needed. The voucher must be in RESERVED or REDEEMED status. Once discarded, the voucher cannot be used.

This endpoint accepts both API key and registered user tokens.

Parameters

Path

Name	Type	Required	Description
voucherId	string	Yes	The voucher ID to discard

Body

No body parameters required.

Request example

curl --request POST 'https://payments.bleepay.com/api/v1/vouchers/vch_482916/discard-voucher' \
  --header 'Authorization: Bearer <payee_token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

Response

Response schema

Returns the updated voucher object with a discarded status.

Error responses

Status	Code	Description
400	already_resolved	A resolved voucher cannot be discarded
401	unauthorized	Missing or invalid bearer token
404	not_found	Voucher not found