POS Integration Service APIAPIV1LoyaltyUse Points

Redeem loyalty points (proxy)

View as MarkdownOpen in Claude

Proxy to loyalty-service POST /v1/h2h/use-points. Resolves the tenant’s loyalty credential from per-tenant configuration and forwards the request. Idempotent via refCode.

Authentication

X-Api-Keystring
API Key authentication via header

Request

This endpoint expects an object.
customerUuidstringRequiredformat: "uuid"
pointsintegerRequired
refCodestringRequired

Response

OK
codeinteger
isSuccessboolean
messagestring

Errors

400
Bad Request Error
401
Unauthorized Error
502
Bad Gateway Error
503
Service Unavailable Error
504
Gateway Timeout Error