Sign in

Reward Direct: Create

POST https://{organization}.myguper.com/api/loyalty/reward

Manually issues a reward card to a customer, bypassing the order/engine flow. Common use cases: support credits, marketing one-offs, manual reconciliation.

Linked to a policy so the card inherits the policy's expiration rules and aggregation mode.

Try-it values populated from environment ACME (Demo)


Authentication

Token

Send your user token in the x-guper-authorization header. Endpoints that support a Public mode (e.g. acúmulo and resgate previews) accept the same request without the header — Private mode adds customer data and a confirmation token to the response.

Headers

Name Type Description
x-guper-authorization * string User token issued by Guper. Omit only on endpoints that explicitly support a Public mode.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Request body

Content-Type: application/json

{
    "policy": 1,
    "client": 47,
    "value": 5000,                                              // cents
    "expiresAt": "2026-12-31",
    "startsAt": "2026-05-04"                                    // optional
}

Responses

{ "cardId": 9182, "policy": 1, "client": 47, "value": 5000, "expiresAt": "2026-12-31T23:59:59-03:00" }
Copied to clipboard