curl --request POST \
--url https://{cluster}.voucherify.io/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/points \
--header 'Content-Type: application/json' \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>' \
--data '{
"points": 100
}'{
"transaction": {
"id": "lctx_12cfcfd67c8725bb92",
"card_id": "lcrd_128f962dbd8c4ba5df",
"program_id": "lprg_128f58429f4c4bf7b2",
"member_id": "lmbr_128f962dbc8c4ba5dc",
"card_definition_id": "lcdef_128f495f720c4bec8c",
"card_type": "INDIVIDUAL",
"type": "ADMIN_CREDIT",
"details": {
"reason": null,
"rejection": null,
"metadata": {},
"points": {
"total": 100,
"expiration_date": "2026-08-31"
}
},
"status": "PENDING",
"created_at": "2026-07-31T13:14:23.602Z",
"updated_at": null,
"object": "card_transaction"
},
"status": "TRANSACTION_CREATED",
"message": "Points addition transaction created"
}Adjust card points
Manually adjusts the points balance of the member’s card.
A positive points value creates an ADMIN_CREDIT card transaction. The expiration date comes from the member tier when that tier defines its own points expiration. Otherwise the date comes from the card definition. expiration_date is null when points don’t expire.
A negative points value creates an ADMIN_DEBIT card transaction.
When points is 0, no transaction is created and status is NO_CHANGE.
The transaction is created with status PENDING and processed asynchronously. The program and the member must be ACTIVE. The program must also be inside its validity window. Otherwise the response is 423. The response is 404 when the program or the member doesn’t exist, or when the card isn’t assigned to that member.
A successful call records no activity.
curl --request POST \
--url https://{cluster}.voucherify.io/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/points \
--header 'Content-Type: application/json' \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>' \
--data '{
"points": 100
}'{
"transaction": {
"id": "lctx_12cfcfd67c8725bb92",
"card_id": "lcrd_128f962dbd8c4ba5df",
"program_id": "lprg_128f58429f4c4bf7b2",
"member_id": "lmbr_128f962dbc8c4ba5dc",
"card_definition_id": "lcdef_128f495f720c4bec8c",
"card_type": "INDIVIDUAL",
"type": "ADMIN_CREDIT",
"details": {
"reason": null,
"rejection": null,
"metadata": {},
"points": {
"total": 100,
"expiration_date": "2026-08-31"
}
},
"status": "PENDING",
"created_at": "2026-07-31T13:14:23.602Z",
"updated_at": null,
"object": "card_transaction"
},
"status": "TRANSACTION_CREATED",
"message": "Points addition transaction created"
}Authorizations
Path Parameters
Body
Request body schema for POST /v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/points.
Response
Result of the points adjustment.
Response body schema for POST /v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/points.
Human-readable result message:
- "Points addition transaction created",
- "Points subtraction transaction created",
- "Provided amount is zero, transaction was not created".
Points addition transaction created, Points subtraction transaction created, Provided amount is zero, transaction was not created 
