Sign in

v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB
Programs

Add or subtract card points

<Warning>

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

</Warning>

Manually adjusts the points balance of the member's card. A positive points value creates an ADMIN_CREDIT card transaction (points addition - the added points get an expiration date calculated from the card definition's points expiration settings); a negative value creates an ADMIN_DEBIT card transaction (points subtraction). When points is 0, no transaction is created and the result status is NO_CHANGE.

The transaction is created with status PENDING and processed asynchronously. Both the program and the member must be in ACTIVE status (423 otherwise). Returns 404 when the program, member or card does not exist.

post/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/points

Path parameters

programIdstring required

Loyalty program ID (format lprg_[a-f0-9]+).

memberIdstring required

Program member ID (format lmbr_[a-f0-9]+).

cardIdstring required

Loyalty card ID (format lcrd_[a-f0-9]+).

Request body

pointsinteger required

Number of points to adjust. Positive values add points (ADMIN_CREDIT transaction), negative values subtract points (ADMIN_DEBIT transaction), zero results in no transaction (NO_CHANGE). Required.

reasonstring

Optional reason for the adjustment, stored in the transaction details.

Response

Result of the points adjustment.

status'TRANSACTION_CREATED' | 'NO_CHANGE' required

TRANSACTION_CREATED when a transaction was created, NO_CHANGE when the requested points amount was zero.

messagestring required

Human-readable result message - "Points addition transaction created", "Points subtraction transaction created" or "Provided amount is zero, transaction was not created".