Entrar

External Event: Crear reward

POST https://{organization}.myguper.com/api/loyalty/external-event

Emite reward cards impulsados por campañas del tipo external-events — usado cuando un sistema externo (CRM, app, e-mail) decide cuándo y cuánto recompensar, y Guper sólo crea los cards siguiendo la identidad de la campaña (vigencia, tags, sequence, mensajería).

La campaña aporta la estructura; el body aporta el valor. Internamente el aliquot de la campaña se sobrescribe con el value enviado, así cada entrada en campaigns[] produce exactamente un reward card por el monto pedido. startsAt / expiresAt opcionales por entrada sobrescriben la ventana de vigencia por defecto del card resultante.

Acepta un objeto único { id, value } o un array de objetos — un objeto único se envuelve automáticamente.

Try-it values populated from environment ACME (Demo)


Autenticación

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.

Encabezados

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.

Cuerpo de la petición

Content-Type: application/json

{
    "interface": "generic",
    "client": {
        "id": "123123",                                         // optional
        "countryCallingCode": 55,                               // optional
        "cellphone": "19954264546",                             // optional
        "email": "tintim@guper.co",                             // optional
        "document": "<document>",                               // optional
        "name": "Tintim"                                        // optional
    },
    "campaigns": [
        {
            "id": 7,
            "value": 5000,                                      // cents
            "startsAt": "2026-05-08",                           // optional
            "expiresAt": "2027-05-08"                           // optional
        }
    ],
    "storeId": "<storeId>"                                      // optional
}

Respuestas

{
    "reward": [
        { "TID": "54eb6281…", "campaign": 7,  "rewardValue": 5000 },
        { "TID": "54eb6281…", "campaign": 12, "rewardValue": 1000 }
    ],
    "total": 6000
}

Relacionados

Copied to clipboard