Refund reward purchase

Refunds an APPROVED reward purchase made by a program member. The purchase transaction is marked REFUNDED, a new REFUND reward transaction is created with status APPROVED, and the points spent on the purchase are returned to the member’s card.

The request body is optional and an empty payload is allowed. Policies default to refund: DEFAULT and stock: DEFAULT.

The endpoint responds with 202 before the card balance changes. A POINTS_RETURNED card transaction is created for the member’s card and processed shortly after the response. When the member’s tier or the card definition expires points, returned points receive a new expiration date from that setting. They don’t inherit the expiration of the originally spent points. A NO_EXPIRATION setting leaves the returned points without an expiration date. Card earning limits don’t block the refund.

For a LOYALTY_CARD_POINTS reward, the points credited to the target card are also reversed, with a POINTS_PURCHASE_REVERSED card transaction on that card. That transaction is processed shortly after the response. Its expiration is copied from the original points-purchased transaction.

A DISCOUNT_COUPONS refund deletes the issued vouchers. details.result.digital.discount_coupons[].result is DELETED, or SKIPPED when the voucher isn’t deleted. A GIFT_VOUCHERS refund subtracts the credited amount. details.result.digital.gift_vouchers[].result is CREDITS_SUBTRACTED, or SKIPPED when the balance update is rejected.

The refund reverses that purchase in the reward’s purchase limits for the project-local day of the original purchase. A day whose purchases are all refunded no longer counts as the member’s last purchase.

Only rewards whose refunds.type is REFUNDABLE can be refunded. Any other reward is rejected with 423 and key reward_refund_policy_does_not_allow_refunds. policies.refund set to ALLOW refunds it anyway.

The program must exist, and the reward transaction must belong to that program. Otherwise the request fails with 404. The program is checked first. The request is rejected with 423 when:

• The program isn’t ACTIVE (non_active_program) or is outside its validity window (program_outside_validity_window),
• The transaction isn’t a purchase (non_purchase_reward_transaction) or isn’t APPROVED (non_approved_reward_transaction); refunding the same purchase twice fails here,
• The reward no longer exists (reward_not_found), isn’t assigned to the program (refund_reward_not_assigned_to_program), the member’s card is gone (refund_card_not_found), or the card definition is gone (refund_card_definition_not_found),
• The reward type isn’t supported (reward_type_not_supported_for_refunds),
• For a LOYALTY_CARD_POINTS reward, the purchase result is missing (loyalty_card_points_purchase_result_not_found), the target card is gone (loyalty_card_points_target_card_not_found), the points-purchased card transaction is missing (loyalty_card_points_purchase_not_found), the target card’s available balance is lower than the purchased points (loyalty_card_points_insufficient_balance), or the target card definition is gone (loyalty_card_points_target_card_definition_not_found).

POST /v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund

Refund reward purchase

cURL

curl --request POST \
  --url https://{cluster}.voucherify.io/v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund \
  --header 'Content-Type: application/json' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>' \
  --data '{
  "policies": {}
}'

202

Refund accepted

{
  "transaction": {
    "id": "lrtx_12fa3c01696025a386",
    "card_id": "lcrd_128f962dbd8c4ba5e1",
    "card_transaction_id": "lctx_12fa3c0169a025a387",
    "program_id": "lprg_128f58429f4c4bf7b2",
    "member_id": "lmbr_128f962dbc8c4ba5dc",
    "reward_id": "lrew_1294cebb458e4904a0",
    "status": "APPROVED",
    "type": "REFUND",
    "details": {
      "reason": "Manual reward refund",
      "rejection": null,
      "metadata": {},
      "points": {
        "total": 500
      },
      "result": {
        "reward": {
          "id": "lrew_1294cebb458e4904a0",
          "type": "MATERIAL"
        },
        "quantity": 1,
        "material": {
          "type": "PRODUCT",
          "product": {
            "id": "prod_1294ce96f66d469498"
          }
        },
        "digital": null
      },
      "purchase": {
        "card_transaction": {
          "id": "lctx_12cad1abefa2311e02"
        },
        "reward_transaction": {
          "id": "lrtx_12cad1abefa2311e03"
        }
      }
    },
    "created_at": "2026-09-02T12:03:11.401Z",
    "updated_at": null,
    "object": "reward_transaction"
  },
  "status": "APPROVED",
  "message": "Reward refund transaction created. Points will be returned to the member's card shortly."
}

Authorizations

X-App-Id & X-App-TokenbearerAuth

X-App-Id · string · header · required

X-App-Token · string · header · required

Path Parameters

programId · string · required

Unique loyalty program identifier (format: lprg_ followed by hexadecimal characters).

Pattern: ^lprg_[a-f0-9]+$

rewardTransactionId · string · required

Unique reward transaction identifier of the purchase to refund (format: lrtx_ followed by hexadecimal characters).

Pattern: ^lrtx_[a-f0-9]+$

Body

application/json

Optional refund policies. An empty payload is allowed.

Request body schema for POST /v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund.

policies · object | null

Refund policies. When omitted or null, defaults are applied.

Show child attributes

Response

202

application/json

Refund accepted. The refund reward transaction has been created with status APPROVED and points will be returned to the member's card asynchronously.

Response body schema for POST /v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund.

transaction · object · required

The created REFUND-type reward transaction.

Show child attributes

status · enum<string> · required

Result status. Always APPROVED on success.

Available options: APPROVED

message · string · required

Returns the result message: "Reward refund transaction created. Points will be returned to the member's card shortly.".