{
    "info": {
        "_postman_id": "09c550c5-eeaf-4491-b99e-d485e1d70e42",
        "name": "Guper · Loyalty",
        "description": "Guper Loyalty API reference. Generated from the documentation portal.",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "item": [
        {
            "name": "Campaigns",
            "item": [
                {
                    "name": "Campaign rules",
                    "item": [
                        {
                            "name": "Create",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign",
                                        "rule"
                                    ]
                                },
                                "description": "Adds a rule to a campaign. A rule NARROWS what the campaign matches — the order, the\nitems or the audience — so the campaign only rewards when every rule passes.\n\nA rule is a `code` (which rule) plus `params` (the values it checks). **The three things\nthat trip people up:**\n\n1. **Each `code` expects a DIFFERENT `params` format** — cents for amounts, arrays of IDs\n   for categories/brands, an object for tier level. Using the wrong shape silently makes\n   the rule never match. The per-code format is listed under `params` below.\n2. **Monetary params are in CENTS.** `[\"250001\"]` on code 1 means R$ 2.500,01 — not 250k.\n3. **The rule's SCOPE must match the campaign's `trigger`.** Codes 1–16 are `campaign`\n   scope (normal campaigns). Codes 17–18 are `member-event` scope and only work on a\n   campaign whose `trigger` is `member-event`. Mixing them makes the rule dead weight.\n\nThe authoritative list comes from `GET /api/loyalty/rule`; the table below is a snapshot.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"campaign\": 1,\n    \"code\": 1,\n    \"params\": [\n        \"250001\"\n    ],\n    \"reverse\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Success — returns the created rule (id assigned by the database).",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "campaign",
                                                "rule"
                                            ]
                                        },
                                        "description": "Adds a rule to a campaign. A rule NARROWS what the campaign matches — the order, the\nitems or the audience — so the campaign only rewards when every rule passes.\n\nA rule is a `code` (which rule) plus `params` (the values it checks). **The three things\nthat trip people up:**\n\n1. **Each `code` expects a DIFFERENT `params` format** — cents for amounts, arrays of IDs\n   for categories/brands, an object for tier level. Using the wrong shape silently makes\n   the rule never match. The per-code format is listed under `params` below.\n2. **Monetary params are in CENTS.** `[\"250001\"]` on code 1 means R$ 2.500,01 — not 250k.\n3. **The rule's SCOPE must match the campaign's `trigger`.** Codes 1–16 are `campaign`\n   scope (normal campaigns). Codes 17–18 are `member-event` scope and only work on a\n   campaign whose `trigger` is `member-event`. Mixing them makes the rule dead weight.\n\nThe authoritative list comes from `GET /api/loyalty/rule`; the table below is a snapshot.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"campaign\": 1,\n    \"code\": 1,\n    \"params\": [\n        \"250001\"\n    ],\n    \"reverse\": false\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Delete",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign",
                                        "rule"
                                    ]
                                },
                                "description": "Removes a campaign rule by ID.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Success.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "campaign",
                                                "rule"
                                            ]
                                        },
                                        "description": "Removes a campaign rule by ID.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "`id` missing in body.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "campaign",
                                                "rule"
                                            ]
                                        },
                                        "description": "Removes a campaign rule by ID.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign",
                                        "rule"
                                    ]
                                },
                                "description": "Returns the paginated list of campaign rules."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "campaign",
                                                "rule"
                                            ]
                                        },
                                        "description": "Returns the paginated list of campaign rules."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"list\": [\n        {\n            \"id\": 1,\n            \"name\": \"My Wallet\"\n        }\n    ],\n    \"total\": 1,\n    \"pagination\": {\n        \"entries\": 20,\n        \"totalPages\": 1,\n        \"currentPage\": 1,\n        \"isInitial\": true,\n        \"isEnd\": true,\n        \"totalPrevPages\": 0,\n        \"totalNextPages\": 0\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Update",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign",
                                        "rule"
                                    ]
                                },
                                "description": "Updates an existing campaign rule. Only `id` is strictly required — every other field\naccepted by [Create rule](../create) can also appear here and is partially merged into\nthe record.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1,\n    \"campaign\": 0,\n    \"code\": 2,\n    \"params\": [\n        \"45\"\n    ],\n    \"reverse\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Success — returns the updated record.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/rule",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "campaign",
                                                "rule"
                                            ]
                                        },
                                        "description": "Updates an existing campaign rule. Only `id` is strictly required — every other field\naccepted by [Create rule](../create) can also appear here and is partially merged into\nthe record.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1,\n    \"campaign\": 0,\n    \"code\": 2,\n    \"params\": [\n        \"45\"\n    ],\n    \"reverse\": false\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Create",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "campaign"
                            ]
                        },
                        "description": "Creates a new loyalty campaign — how cashback (or points) is generated for orders: the\nrate (`aliquot`/`aliquotType`), the trigger, the validity window and the reward type.\n\n**This is a financial, hard-to-reverse write. Get the enum values EXACTLY right.** This\ndatabase has no STRICT mode: an invalid ENUM value is stored as an empty string **in\nsilence** (no error), and the campaign then behaves in ways nobody asked for. Every field\nbelow whose type says `enum(...)` lists its only accepted values — do not invent others\n(`client`, `points`, `delay` are NOT valid).\n\n**Required for a successful insert** (NOT NULL in the schema — the controller only checks\n`name`, but the database rejects the row without these): `name`, `aliquot`, `initAt`,\n`finishAt`, `storeGroups`, `segmentations`. Sending only `name` returns a 500.\n\nA campaign created with `trigger: audience-list` is automatically paired with a\n`CampaignAudience` record that drives audience-based scheduling.\n\n**HOW TO CREATE ONE — guided flow. Do NOT dump the whole form, and do NOT guess.**\nWalk the user through it one group at a time. For anything they already told you, restate\nyour understanding and ask them to confirm — do not ask again. Ask only for what is still\nmissing, in this order:\n\n  1. **Basics** — `name`; what fires it (`trigger`); and the reward: `rewardType`\n     (`monetary`/`point`) with the rate (`aliquot` + `aliquotType`; amounts in cents).\n  2. **Window** — `initAt` and `finishAt` (when the campaign evaluates orders).\n  3. **Redeemability** — `availabilityMode`: `consecutiveDays` (`delayTime`/`expiryTime`,\n     in SECONDS) or `dateRange` (`dateRangeStart`/`dateRangeEnd`).\n  4. **Reach** — `storeGroups` (empty = all stores) and any `segmentations`.\n  5. **Narrowing rules (optional)** — ask whether to limit by minimum/maximum value,\n     category, brand, tier, etc. Each is a SEPARATE call to the campaign-rule endpoint\n     after the campaign exists; see its docs for the per-rule `params` format.\n\nThen show a FULL preview — every field, in plain language, amounts formatted back from\ncents — and execute ONLY after the user explicitly confirms. This operation is financial\nand requires `confirmar=true`, so it will not run without that confirmation regardless.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"Aniversário — 10% cashback\",\n    \"displayName\": \"Feliz aniversário!\",\n    \"beneficiaryType\": \"buyer\",\n    \"trigger\": \"purchase\",\n    \"eventType\": \"tier_achieved\",\n    \"type\": \"monetary\",\n    \"isActive\": true,\n    \"isDraft\": false,\n    \"rewardType\": \"monetary\",\n    \"pointsDividend\": 1,\n    \"pointsDivisor\": 1,\n    \"aliquot\": 1000,\n    \"aliquotType\": 0,\n    \"coupon\": 0,\n    \"recurrentByOrder\": false,\n    \"availabilityMode\": \"consecutiveDays\",\n    \"delayTime\": 86400,\n    \"expiryTime\": 1296000,\n    \"expiryPeriod\": \"<expiryPeriod>\",\n    \"dateRangeStart\": \"2026-03-01T00:00:00-03:00\",\n    \"dateRangeEnd\": \"2026-12-31T23:59:59-03:00\",\n    \"initAt\": \"2026-03-01T00:00:00-03:00\",\n    \"finishAt\": \"2026-03-31T23:59:59-03:00\",\n    \"storeGroups\": \"\",\n    \"segmentations\": \"[]\",\n    \"redemptionPolicy\": 0,\n    \"messageSequence\": \"<messageSequence>\",\n    \"campaignTag\": 0,\n    \"rewardSegmentAdd\": \"<rewardSegmentAdd>\",\n    \"rewardSegmentDel\": \"<rewardSegmentDel>\",\n    \"list\": 0,\n    \"reactivateWithActiveCards\": false,\n    \"skipWithActiveCards\": true,\n    \"reactivationDateStart\": \"<reactivationDateStart>\",\n    \"reactivationDateEnd\": \"<reactivationDateEnd>\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success — returns the persisted record (id assigned by the database).",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign"
                                    ]
                                },
                                "description": "Creates a new loyalty campaign — how cashback (or points) is generated for orders: the\nrate (`aliquot`/`aliquotType`), the trigger, the validity window and the reward type.\n\n**This is a financial, hard-to-reverse write. Get the enum values EXACTLY right.** This\ndatabase has no STRICT mode: an invalid ENUM value is stored as an empty string **in\nsilence** (no error), and the campaign then behaves in ways nobody asked for. Every field\nbelow whose type says `enum(...)` lists its only accepted values — do not invent others\n(`client`, `points`, `delay` are NOT valid).\n\n**Required for a successful insert** (NOT NULL in the schema — the controller only checks\n`name`, but the database rejects the row without these): `name`, `aliquot`, `initAt`,\n`finishAt`, `storeGroups`, `segmentations`. Sending only `name` returns a 500.\n\nA campaign created with `trigger: audience-list` is automatically paired with a\n`CampaignAudience` record that drives audience-based scheduling.\n\n**HOW TO CREATE ONE — guided flow. Do NOT dump the whole form, and do NOT guess.**\nWalk the user through it one group at a time. For anything they already told you, restate\nyour understanding and ask them to confirm — do not ask again. Ask only for what is still\nmissing, in this order:\n\n  1. **Basics** — `name`; what fires it (`trigger`); and the reward: `rewardType`\n     (`monetary`/`point`) with the rate (`aliquot` + `aliquotType`; amounts in cents).\n  2. **Window** — `initAt` and `finishAt` (when the campaign evaluates orders).\n  3. **Redeemability** — `availabilityMode`: `consecutiveDays` (`delayTime`/`expiryTime`,\n     in SECONDS) or `dateRange` (`dateRangeStart`/`dateRangeEnd`).\n  4. **Reach** — `storeGroups` (empty = all stores) and any `segmentations`.\n  5. **Narrowing rules (optional)** — ask whether to limit by minimum/maximum value,\n     category, brand, tier, etc. Each is a SEPARATE call to the campaign-rule endpoint\n     after the campaign exists; see its docs for the per-rule `params` format.\n\nThen show a FULL preview — every field, in plain language, amounts formatted back from\ncents — and execute ONLY after the user explicitly confirms. This operation is financial\nand requires `confirmar=true`, so it will not run without that confirmation regardless.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Aniversário — 10% cashback\",\n    \"displayName\": \"Feliz aniversário!\",\n    \"beneficiaryType\": \"buyer\",\n    \"trigger\": \"purchase\",\n    \"eventType\": \"tier_achieved\",\n    \"type\": \"monetary\",\n    \"isActive\": true,\n    \"isDraft\": false,\n    \"rewardType\": \"monetary\",\n    \"pointsDividend\": 1,\n    \"pointsDivisor\": 1,\n    \"aliquot\": 1000,\n    \"aliquotType\": 0,\n    \"coupon\": 0,\n    \"recurrentByOrder\": false,\n    \"availabilityMode\": \"consecutiveDays\",\n    \"delayTime\": 86400,\n    \"expiryTime\": 1296000,\n    \"expiryPeriod\": \"<expiryPeriod>\",\n    \"dateRangeStart\": \"2026-03-01T00:00:00-03:00\",\n    \"dateRangeEnd\": \"2026-12-31T23:59:59-03:00\",\n    \"initAt\": \"2026-03-01T00:00:00-03:00\",\n    \"finishAt\": \"2026-03-31T23:59:59-03:00\",\n    \"storeGroups\": \"\",\n    \"segmentations\": \"[]\",\n    \"redemptionPolicy\": 0,\n    \"messageSequence\": \"<messageSequence>\",\n    \"campaignTag\": 0,\n    \"rewardSegmentAdd\": \"<rewardSegmentAdd>\",\n    \"rewardSegmentDel\": \"<rewardSegmentDel>\",\n    \"list\": 0,\n    \"reactivateWithActiveCards\": false,\n    \"skipWithActiveCards\": true,\n    \"reactivationDateStart\": \"<reactivationDateStart>\",\n    \"reactivationDateEnd\": \"<reactivationDateEnd>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Delete",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "campaign"
                            ]
                        },
                        "description": "Removes a campaign by ID. Cards already issued by the campaign are kept — only the campaign\ndefinition is deleted. Existing rules attached to the campaign (`campaign_rule`) are\ncascaded by the database.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": 1\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success.",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign"
                                    ]
                                },
                                "description": "Removes a campaign by ID. Cards already issued by the campaign are kept — only the campaign\ndefinition is deleted. Existing rules attached to the campaign (`campaign_rule`) are\ncascaded by the database.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "`id` missing in body.",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign"
                                    ]
                                },
                                "description": "Removes a campaign by ID. Cards already issued by the campaign are kept — only the campaign\ndefinition is deleted. Existing rules attached to the campaign (`campaign_rule`) are\ncascaded by the database.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "List Campaigns",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "campaign"
                            ]
                        },
                        "description": "Paginated list of loyalty/cashback campaigns. Filter by name, trigger or type\nthrough the shared listing grammar. Returns the campaign setup, not its\nresults — for cards generated, value distributed and redeemed, see the\ncampaign report.\n\nEvery row carries a derived `status`: `active`, `draft`, `paused` or `finished`.\n`draft` is a campaign saved but not published yet (`isDraft`): it never runs\nand wins over every other status.\n`finished` is not a column: for `audience-list` campaigns it means the send\nis over (`audience-status` = `finished`); for every other trigger it means the\ncampaign period (`finishAt`) has ended. `finished` wins over `isActive` — a\ncampaign whose period ended but is still switched on comes back as\n`finished`. The status is read-only: it never changes `isActive`."
                    },
                    "response": [
                        {
                            "name": "Success. Each item in `list` has `status`; `statusCounts` only when requested.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign"
                                    ]
                                },
                                "description": "Paginated list of loyalty/cashback campaigns. Filter by name, trigger or type\nthrough the shared listing grammar. Returns the campaign setup, not its\nresults — for cards generated, value distributed and redeemed, see the\ncampaign report.\n\nEvery row carries a derived `status`: `active`, `draft`, `paused` or `finished`.\n`draft` is a campaign saved but not published yet (`isDraft`): it never runs\nand wins over every other status.\n`finished` is not a column: for `audience-list` campaigns it means the send\nis over (`audience-status` = `finished`); for every other trigger it means the\ncampaign period (`finishAt`) has ended. `finished` wins over `isActive` — a\ncampaign whose period ended but is still switched on comes back as\n`finished`. The status is read-only: it never changes `isActive`."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "List Campaign and Rules",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaigns",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "campaigns"
                            ]
                        },
                        "description": "Returns the paginated list of campaigns including their rules."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaigns",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaigns"
                                    ]
                                },
                                "description": "Returns the paginated list of campaigns including their rules."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Get Campaign",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "campaign",
                                "{{id}}"
                            ]
                        },
                        "description": "Returns a single the campaign matching the given identifier."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single the campaign matching the given identifier."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 1,\n    \"name\": \"My Campaign\",\n    \"aliquot\": 5,\n    \"aliquotType\": 1,\n    \"recurrentByOrder\": 0,\n    \"expiryTime\": 5184000,\n    \"initAt\": {\n        \"date\": \"2023-07-01 06:00:00.000000\",\n        \"timezone_type\": 3,\n        \"timezone\": \"America/Sao_Paulo\"\n    },\n    \"finishAt\": {\n        \"date\": \"2023-12-31 18:00:00.000000\",\n        \"timezone_type\": 3,\n        \"timezone\": \"America/Sao_Paulo\"\n    }\n}"
                        }
                    ]
                },
                {
                    "name": "Update",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "campaign"
                            ]
                        },
                        "description": "Updates an existing campaign. Only `id` is strictly required — every other field present\nin [Create campaign](../create) can also appear here and is partially merged into the\nrecord (only the keys you send are updated).\n\nWhen the campaign trigger is `audience-list`, the paired `CampaignAudience` record is\nre-synchronized: toggling `isActive` flips its status between `running` and `standby`.\n\nFor `member-event` campaigns, `eventType` is the field that decides which lifecycle\nevent fires the campaign (`membership_joined` or `tier_achieved`). To filter by\na specific tier level on `tier_achieved`, attach a `campaign_rule` with code `17`\n(see [Campaign rules](../campaign-rules/create)).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": 1,\n    \"name\": \"My Campaign\",\n    \"displayName\": \"<displayName>\",\n    \"isActive\": false,\n    \"isDraft\": false,\n    \"aliquot\": 0,\n    \"aliquotType\": 0,\n    \"dateRangeStart\": \"<dateRangeStart>\",\n    \"dateRangeEnd\": \"<dateRangeEnd>\",\n    \"initAt\": \"<initAt>\",\n    \"finishAt\": \"<finishAt>\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success — returns the updated record.",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/campaign",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "campaign"
                                    ]
                                },
                                "description": "Updates an existing campaign. Only `id` is strictly required — every other field present\nin [Create campaign](../create) can also appear here and is partially merged into the\nrecord (only the keys you send are updated).\n\nWhen the campaign trigger is `audience-list`, the paired `CampaignAudience` record is\nre-synchronized: toggling `isActive` flips its status between `running` and `standby`.\n\nFor `member-event` campaigns, `eventType` is the field that decides which lifecycle\nevent fires the campaign (`membership_joined` or `tier_achieved`). To filter by\na specific tier level on `tier_achieved`, attach a `campaign_rule` with code `17`\n(see [Campaign rules](../campaign-rules/create)).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1,\n    \"name\": \"My Campaign\",\n    \"displayName\": \"<displayName>\",\n    \"isActive\": false,\n    \"isDraft\": false,\n    \"aliquot\": 0,\n    \"aliquotType\": 0,\n    \"dateRangeStart\": \"<dateRangeStart>\",\n    \"dateRangeEnd\": \"<dateRangeEnd>\",\n    \"initAt\": \"<initAt>\",\n    \"finishAt\": \"<finishAt>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Cards",
            "item": [
                {
                    "name": "Card: By Order",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/card/byOrder",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "card",
                                "byOrder"
                            ]
                        },
                        "description": "Generates reward cards directly from an order payload — admin / manual\nissuance bypassing the standard reward flow. Same shape as\n[Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)\nplus an optional `amountToRedeem` override.\n\nBypasses the checkout flow entirely: no reservation and no confirm step.\n\nThis is the same route documented at\n[Reward · Create by Order](/docs/{lang}/api-reference/loyalty/reward/create-by-order)\n— kept here under `card/` as well because legacy integrations reference\nthat path.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": {\n        \"id\": 47,\n        \"refId\": \"3143c4fb\",\n        \"name\": \"Trifólio Girassol\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"trifolio@girassol.com\",\n        \"document\": \"<document>\"\n    },\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"quantity\": 1,\n            \"price\": 96390,\n            \"listPrice\": 100000,\n            \"categoryId\": \"<categoryId>\",\n            \"brandId\": \"<brandId>\",\n            \"tax\": 0\n        }\n    ],\n    \"total_order\": 97390,\n    \"total_item\": 96390,\n    \"total_shipping\": 2000,\n    \"total_discounts\": 1000,\n    \"amountToRedeem\": 0\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Cards generated",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/card/byOrder",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "card",
                                        "byOrder"
                                    ]
                                },
                                "description": "Generates reward cards directly from an order payload — admin / manual\nissuance bypassing the standard reward flow. Same shape as\n[Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)\nplus an optional `amountToRedeem` override.\n\nBypasses the checkout flow entirely: no reservation and no confirm step.\n\nThis is the same route documented at\n[Reward · Create by Order](/docs/{lang}/api-reference/loyalty/reward/create-by-order)\n— kept here under `card/` as well because legacy integrations reference\nthat path.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": {\n        \"id\": 47,\n        \"refId\": \"3143c4fb\",\n        \"name\": \"Trifólio Girassol\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"trifolio@girassol.com\",\n        \"document\": \"<document>\"\n    },\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"quantity\": 1,\n            \"price\": 96390,\n            \"listPrice\": 100000,\n            \"categoryId\": \"<categoryId>\",\n            \"brandId\": \"<brandId>\",\n            \"tax\": 0\n        }\n    ],\n    \"total_order\": 97390,\n    \"total_item\": 96390,\n    \"total_shipping\": 2000,\n    \"total_discounts\": 1000,\n    \"amountToRedeem\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Cancel Card",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/cancel",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "cards",
                                "{{id}}",
                                "cancel"
                            ]
                        },
                        "description": "Cancels a single card. The card leaves circulation immediately: it stops counting as\nbalance, stops being redeemable and reads as `canceled` everywhere.\n\nA card carries no status column - `canceled` is derived from the cancellation timestamp,\nso this endpoint **is** what \"set the card status to canceled\" means.\n\nCanceling a card is a change of **state**, not a movement of money: the balance is neither\ndebited nor returned, and no line is written to the card flow ledger. The card simply drops\nout of every balance query. Pick the operation by intent:\n\n- the whole card should stop existing for the customer - **this endpoint**;\n- value should leave a card that stays alive - [Adjust Card Balance](/docs/{lang}/api-reference/loyalty/card/adjust) (`manual_debit`, recorded in the ledger);\n- a purchase was reverted and its cashback must go with it - cancel the transaction, not the card.\n\nReversible through [Reactivate Card](/docs/{lang}/api-reference/loyalty/card/reactivate).\n\nA card holding an **open redemption reservation** is refused with `409`: the reserved value\nwas already debited and is waiting to be settled or returned, so canceling the card would\nstrand it. Settle or cancel that redemption first."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/cancel",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "{{id}}",
                                        "cancel"
                                    ]
                                },
                                "description": "Cancels a single card. The card leaves circulation immediately: it stops counting as\nbalance, stops being redeemable and reads as `canceled` everywhere.\n\nA card carries no status column - `canceled` is derived from the cancellation timestamp,\nso this endpoint **is** what \"set the card status to canceled\" means.\n\nCanceling a card is a change of **state**, not a movement of money: the balance is neither\ndebited nor returned, and no line is written to the card flow ledger. The card simply drops\nout of every balance query. Pick the operation by intent:\n\n- the whole card should stop existing for the customer - **this endpoint**;\n- value should leave a card that stays alive - [Adjust Card Balance](/docs/{lang}/api-reference/loyalty/card/adjust) (`manual_debit`, recorded in the ledger);\n- a purchase was reverted and its cashback must go with it - cancel the transaction, not the card.\n\nReversible through [Reactivate Card](/docs/{lang}/api-reference/loyalty/card/reactivate).\n\nA card holding an **open redemption reservation** is refused with `409`: the reserved value\nwas already debited and is waiting to be settled or returned, so canceling the card would\nstrand it. Settle or cancel that redemption first."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"cardId\": 95980,\n    \"canceledAt\": \"2026-11-09T14:32:05-03:00\",\n    \"cardStatus\": \"canceled\",\n    \"amount\": 1250\n}"
                        },
                        {
                            "name": "No card with this id in the organization.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/cancel",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "{{id}}",
                                        "cancel"
                                    ]
                                },
                                "description": "Cancels a single card. The card leaves circulation immediately: it stops counting as\nbalance, stops being redeemable and reads as `canceled` everywhere.\n\nA card carries no status column - `canceled` is derived from the cancellation timestamp,\nso this endpoint **is** what \"set the card status to canceled\" means.\n\nCanceling a card is a change of **state**, not a movement of money: the balance is neither\ndebited nor returned, and no line is written to the card flow ledger. The card simply drops\nout of every balance query. Pick the operation by intent:\n\n- the whole card should stop existing for the customer - **this endpoint**;\n- value should leave a card that stays alive - [Adjust Card Balance](/docs/{lang}/api-reference/loyalty/card/adjust) (`manual_debit`, recorded in the ledger);\n- a purchase was reverted and its cashback must go with it - cancel the transaction, not the card.\n\nReversible through [Reactivate Card](/docs/{lang}/api-reference/loyalty/card/reactivate).\n\nA card holding an **open redemption reservation** is refused with `409`: the reserved value\nwas already debited and is waiting to be settled or returned, so canceling the card would\nstrand it. Settle or cancel that redemption first."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Card was canceled previously, or it holds an open redemption reservation - the response carries `reservedTotal` in cents.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/cancel",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "{{id}}",
                                        "cancel"
                                    ]
                                },
                                "description": "Cancels a single card. The card leaves circulation immediately: it stops counting as\nbalance, stops being redeemable and reads as `canceled` everywhere.\n\nA card carries no status column - `canceled` is derived from the cancellation timestamp,\nso this endpoint **is** what \"set the card status to canceled\" means.\n\nCanceling a card is a change of **state**, not a movement of money: the balance is neither\ndebited nor returned, and no line is written to the card flow ledger. The card simply drops\nout of every balance query. Pick the operation by intent:\n\n- the whole card should stop existing for the customer - **this endpoint**;\n- value should leave a card that stays alive - [Adjust Card Balance](/docs/{lang}/api-reference/loyalty/card/adjust) (`manual_debit`, recorded in the ledger);\n- a purchase was reverted and its cashback must go with it - cancel the transaction, not the card.\n\nReversible through [Reactivate Card](/docs/{lang}/api-reference/loyalty/card/reactivate).\n\nA card holding an **open redemption reservation** is refused with `409`: the reserved value\nwas already debited and is waiting to be settled or returned, so canceling the card would\nstrand it. Settle or cancel that redemption first."
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Cancel Cards in Batch",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/cancel",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "cards",
                                "cancel"
                            ]
                        },
                        "description": "Cancels up to 100 cards in one call. Same rules as\n[Cancel Card](/docs/{lang}/api-reference/loyalty/card/cancel) - a card leaves circulation,\nstops counting as balance and reads as `canceled`, with no money moved and no line written\nto the card flow ledger.\n\n**Partial failure is normal, not an error.** In a batch of 100 it is expected that a few\ncards are already canceled, one does not exist and another holds an open redemption\nreservation. The call answers `200` with the outcome of **each** item; `400` is reserved\nfor a malformed request (no `ids`, above the limit, or a non-numeric id).\n\nPossible outcomes per item:\n\n| `outcome` | Meaning |\n|---|---|\n| `canceled` | The card was canceled by this call |\n| `already_canceled` | It was already canceled - nothing was done, `canceledAt` is returned |\n| `has_open_reservation` | Refused: reserved value is waiting to be settled or returned (`reservedTotal`, in cents) |\n| `not_found` | No card with this id in the organization |\n\n**Run it with `dryRun` first.** It returns exactly what would happen per item plus\n`amountRemoved` - how much balance would leave circulation - and writes nothing.\n\nIds repeated in the same call are processed once. **A range never crosses organizations**: an\nid that belongs to another account comes back `not_found` and is left untouched - every query\nhere is scoped by organization, and `not_found` is also the right answer so the call cannot\nbe used to probe whether a card exists somewhere else.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ids\": \"1512200:1512299;1512305;1512310\",\n    \"dryRun\": false\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Processed - read `results` for the outcome of each id.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/cancel",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "cancel"
                                    ]
                                },
                                "description": "Cancels up to 100 cards in one call. Same rules as\n[Cancel Card](/docs/{lang}/api-reference/loyalty/card/cancel) - a card leaves circulation,\nstops counting as balance and reads as `canceled`, with no money moved and no line written\nto the card flow ledger.\n\n**Partial failure is normal, not an error.** In a batch of 100 it is expected that a few\ncards are already canceled, one does not exist and another holds an open redemption\nreservation. The call answers `200` with the outcome of **each** item; `400` is reserved\nfor a malformed request (no `ids`, above the limit, or a non-numeric id).\n\nPossible outcomes per item:\n\n| `outcome` | Meaning |\n|---|---|\n| `canceled` | The card was canceled by this call |\n| `already_canceled` | It was already canceled - nothing was done, `canceledAt` is returned |\n| `has_open_reservation` | Refused: reserved value is waiting to be settled or returned (`reservedTotal`, in cents) |\n| `not_found` | No card with this id in the organization |\n\n**Run it with `dryRun` first.** It returns exactly what would happen per item plus\n`amountRemoved` - how much balance would leave circulation - and writes nothing.\n\nIds repeated in the same call are processed once. **A range never crosses organizations**: an\nid that belongs to another account comes back `not_found` and is left untouched - every query\nhere is scoped by organization, and `not_found` is also the right answer so the call cannot\nbe used to probe whether a card exists somewhere else.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ids\": \"1512200:1512299;1512305;1512310\",\n    \"dryRun\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"batchId\": \"cb_6f2e91a4c3d1\",\n    \"dryRun\": false,\n    \"summary\": {\n        \"requested\": 4,\n        \"canceled\": 1,\n        \"reactivated\": 0,\n        \"already_canceled\": 1,\n        \"not_canceled\": 0,\n        \"has_open_reservation\": 1,\n        \"not_found\": 1,\n        \"amountRemoved\": 31200\n    },\n    \"results\": [\n        { \"id\": 1512200, \"outcome\": \"canceled\", \"amount\": 31200 },\n        { \"id\": 1512201, \"outcome\": \"already_canceled\", \"canceledAt\": \"2026-11-09T18:02:11-03:00\" },\n        { \"id\": 1512207, \"outcome\": \"has_open_reservation\", \"reservedTotal\": 5000 },\n        { \"id\": 9999999, \"outcome\": \"not_found\" }\n    ]\n}"
                        },
                        {
                            "name": "Malformed request: `ids` missing or empty, more than 100 ids, or a non-numeric id.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/cancel",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "cancel"
                                    ]
                                },
                                "description": "Cancels up to 100 cards in one call. Same rules as\n[Cancel Card](/docs/{lang}/api-reference/loyalty/card/cancel) - a card leaves circulation,\nstops counting as balance and reads as `canceled`, with no money moved and no line written\nto the card flow ledger.\n\n**Partial failure is normal, not an error.** In a batch of 100 it is expected that a few\ncards are already canceled, one does not exist and another holds an open redemption\nreservation. The call answers `200` with the outcome of **each** item; `400` is reserved\nfor a malformed request (no `ids`, above the limit, or a non-numeric id).\n\nPossible outcomes per item:\n\n| `outcome` | Meaning |\n|---|---|\n| `canceled` | The card was canceled by this call |\n| `already_canceled` | It was already canceled - nothing was done, `canceledAt` is returned |\n| `has_open_reservation` | Refused: reserved value is waiting to be settled or returned (`reservedTotal`, in cents) |\n| `not_found` | No card with this id in the organization |\n\n**Run it with `dryRun` first.** It returns exactly what would happen per item plus\n`amountRemoved` - how much balance would leave circulation - and writes nothing.\n\nIds repeated in the same call are processed once. **A range never crosses organizations**: an\nid that belongs to another account comes back `not_found` and is left untouched - every query\nhere is scoped by organization, and `not_found` is also the right answer so the call cannot\nbe used to probe whether a card exists somewhere else.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ids\": \"1512200:1512299;1512305;1512310\",\n    \"dryRun\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Card Full Data",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/full",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "cards",
                                "full"
                            ]
                        },
                        "description": "Returns the paginated list of cashback cards with their full data."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/full",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "full"
                                    ]
                                },
                                "description": "Returns the paginated list of cashback cards with their full data."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        {\n            \"id\": 1231231,\n            \"assetId\": \"CD6DFF867546665D83BE82BC10E81FE020C0234524t4494AD8C15D87759BFB4\",\n            \"wallet\": 123,\n            \"order\": 121212,\n            \"store\": 100,\n            \"campaign\": 123,\n            \"client\": 123123,\n            \"rewardType\": \"monetary\",\n            \"pointsDividend\": 1,\n            \"pointsDivisor\": 1,\n            \"aggregation_mode\": \"aggregate\",\n            \"totalCredit\": 15670,\n            \"amount\": 15670,\n            \"canceledAt\": null,\n            \"startsAt\": \"2026-04-24T00:00:00-06:00\",\n            \"expiresAt\": \"2026-05-24T23:59:59-06:00\",\n            \"createAt\": \"2026-04-23T13:52:43-06:00\",\n            \"updateAt\": \"2026-04-23T13:52:43-06:00\",\n            \"flow\": [\n                {\n                    \"tid\": \"10e3c61360e3db6a4f6b48ce8e586346e3rted24b656fe1e8a9a259d255f833\",\n                    \"cashBackCard\": 1233245,\n                    \"operation\": \"credit\",\n                    \"type\": \"reward\",\n                    \"value\": 15670,\n                    \"amount\": 15670,\n                    \"order\": 121212,\n                    \"coupon\": null,\n                    \"createAt\": \"2026-04-23T13:52:43-06:00\"\n                }\n            ],\n            \"cardId\": 1233245,\n            \"storeId\": 100,\n            \"operate\": \"credit\",\n            \"status\": \"standby\",\n            \"walletId\": 123,\n            \"orderId\": 121212,\n            \"campaignId\": 445,\n            \"campaignName\": \"Cashback Silver - Outlet\",\n            \"customerId\": 12332,\n            \"initialBalance\": 15670,\n            \"availableBalance\": 15670,\n            \"availableAt\": \"2026-04-24T00:00:00-06:00\",\n            \"updatedAt\": \"2026-04-23T13:52:43-06:00\",\n            \"redeemed_by_orderId\": null,\n            \"redeemed_by_couponId\": null,\n            \"redeemed_value\": null,\n            \"redeemedAt\": null,\n            \"redeemed_storeId\": null\n        }\n    ],\n    \"total\": 1,\n    \"pagination\": {\n        \"entries\": 50,\n        \"order\": [],\n        \"totalPages\": 1,\n        \"currentPage\": 1,\n        \"isInitial\": true,\n        \"isEnd\": true,\n        \"totalPrevPages\": 0,\n        \"totalNextPages\": 0\n    }\n}"
                        }
                    ]
                },
                {
                    "name": "Reactivate Card",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/reactivate",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "cards",
                                "{{id}}",
                                "reactivate"
                            ]
                        },
                        "description": "Reverts a cancellation: clears the card's cancellation timestamp and puts it back in\ncirculation. This is the way back from [Cancel Card](/docs/{lang}/api-reference/loyalty/card/cancel).\n\nValidity is **not** touched. A card reactivated after its `expiresAt` comes back expired,\nwith the original `expiresAt` - reactivating is not extending. The response carries the\nresulting `cardStatus`, so the caller sees whether the card is actually usable again.\n\nA card that is not canceled is refused with `409`."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/reactivate",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "{{id}}",
                                        "reactivate"
                                    ]
                                },
                                "description": "Reverts a cancellation: clears the card's cancellation timestamp and puts it back in\ncirculation. This is the way back from [Cancel Card](/docs/{lang}/api-reference/loyalty/card/cancel).\n\nValidity is **not** touched. A card reactivated after its `expiresAt` comes back expired,\nwith the original `expiresAt` - reactivating is not extending. The response carries the\nresulting `cardStatus`, so the caller sees whether the card is actually usable again.\n\nA card that is not canceled is refused with `409`."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"cardId\": 95980,\n    \"canceledAt\": null,\n    \"cardStatus\": \"active\",\n    \"amount\": 1250\n}"
                        },
                        {
                            "name": "No card with this id in the organization.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/reactivate",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "{{id}}",
                                        "reactivate"
                                    ]
                                },
                                "description": "Reverts a cancellation: clears the card's cancellation timestamp and puts it back in\ncirculation. This is the way back from [Cancel Card](/docs/{lang}/api-reference/loyalty/card/cancel).\n\nValidity is **not** touched. A card reactivated after its `expiresAt` comes back expired,\nwith the original `expiresAt` - reactivating is not extending. The response carries the\nresulting `cardStatus`, so the caller sees whether the card is actually usable again.\n\nA card that is not canceled is refused with `409`."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Card is not canceled.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/{{id}}/reactivate",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "{{id}}",
                                        "reactivate"
                                    ]
                                },
                                "description": "Reverts a cancellation: clears the card's cancellation timestamp and puts it back in\ncirculation. This is the way back from [Cancel Card](/docs/{lang}/api-reference/loyalty/card/cancel).\n\nValidity is **not** touched. A card reactivated after its `expiresAt` comes back expired,\nwith the original `expiresAt` - reactivating is not extending. The response carries the\nresulting `cardStatus`, so the caller sees whether the card is actually usable again.\n\nA card that is not canceled is refused with `409`."
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Reactivate Cards in Batch",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/reactivate",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "cards",
                                "reactivate"
                            ]
                        },
                        "description": "Reverts the cancellation of up to 100 cards in one call - the way back from\n[Cancel Cards in Batch](/docs/{lang}/api-reference/loyalty/card/cancel-batch). Without it,\nundoing a batch of 100 would be 100 calls.\n\nSame shape as the batch cancel: `200` with the outcome of each item, and `400` only for a\nmalformed request. Outcomes here are `reactivated`, `not_canceled` (the card was not\ncanceled, nothing done) and `not_found`. The summary carries `amountRestored` - how much\nbalance returns to circulation.\n\nValidity is **not** touched: a card reactivated after its `expiresAt` comes back expired,\nwith the original `expiresAt`. Reactivating is not extending.\n\n`dryRun` works the same way as in the batch cancel.\n\nA range never crosses organizations: an id that belongs to another account comes back\n`not_found` and is left untouched - every query here is scoped by organization.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ids\": \"1512200:1512299;1512305;1512310\",\n    \"dryRun\": false\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Processed - read `results` for the outcome of each id.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/reactivate",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "reactivate"
                                    ]
                                },
                                "description": "Reverts the cancellation of up to 100 cards in one call - the way back from\n[Cancel Cards in Batch](/docs/{lang}/api-reference/loyalty/card/cancel-batch). Without it,\nundoing a batch of 100 would be 100 calls.\n\nSame shape as the batch cancel: `200` with the outcome of each item, and `400` only for a\nmalformed request. Outcomes here are `reactivated`, `not_canceled` (the card was not\ncanceled, nothing done) and `not_found`. The summary carries `amountRestored` - how much\nbalance returns to circulation.\n\nValidity is **not** touched: a card reactivated after its `expiresAt` comes back expired,\nwith the original `expiresAt`. Reactivating is not extending.\n\n`dryRun` works the same way as in the batch cancel.\n\nA range never crosses organizations: an id that belongs to another account comes back\n`not_found` and is left untouched - every query here is scoped by organization.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ids\": \"1512200:1512299;1512305;1512310\",\n    \"dryRun\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"batchId\": \"cb_a17c40e9b882\",\n    \"dryRun\": false,\n    \"summary\": {\n        \"requested\": 3,\n        \"canceled\": 0,\n        \"reactivated\": 2,\n        \"already_canceled\": 0,\n        \"not_canceled\": 1,\n        \"has_open_reservation\": 0,\n        \"not_found\": 0,\n        \"amountRestored\": 62400\n    },\n    \"results\": [\n        { \"id\": 1512200, \"outcome\": \"reactivated\", \"amount\": 31200 },\n        { \"id\": 1512201, \"outcome\": \"reactivated\", \"amount\": 31200 },\n        { \"id\": 1512202, \"outcome\": \"not_canceled\" }\n    ]\n}"
                        },
                        {
                            "name": "Malformed request: `ids` missing or empty, more than 100 ids, or a non-numeric id.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cards/reactivate",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cards",
                                        "reactivate"
                                    ]
                                },
                                "description": "Reverts the cancellation of up to 100 cards in one call - the way back from\n[Cancel Cards in Batch](/docs/{lang}/api-reference/loyalty/card/cancel-batch). Without it,\nundoing a batch of 100 would be 100 calls.\n\nSame shape as the batch cancel: `200` with the outcome of each item, and `400` only for a\nmalformed request. Outcomes here are `reactivated`, `not_canceled` (the card was not\ncanceled, nothing done) and `not_found`. The summary carries `amountRestored` - how much\nbalance returns to circulation.\n\nValidity is **not** touched: a card reactivated after its `expiresAt` comes back expired,\nwith the original `expiresAt`. Reactivating is not extending.\n\n`dryRun` works the same way as in the batch cancel.\n\nA range never crosses organizations: an id that belongs to another account comes back\n`not_found` and is left untouched - every query here is scoped by organization.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ids\": \"1512200:1512299;1512305;1512310\",\n    \"dryRun\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Checkout",
            "item": [
                {
                    "name": "Cancel Transaction and Order",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelOrderByTransaction/{{TID}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "cancelOrderByTransaction",
                                "{{TID}}"
                            ]
                        },
                        "description": "Cancels both the loyalty transaction and its order — refunds cashback that was earned and rolls back any redeemed reward. Use when the entire purchase is being reverted."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelOrderByTransaction/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelOrderByTransaction",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels both the loyalty transaction and its order — refunds cashback that was earned and rolls back any redeemed reward. Use when the entire purchase is being reverted."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"TID\": \"dcf33b4448d604033d12ce176253ee54851531212b29bde1468d359e82005b92\",\n    \"order\": 2467383,\n    \"reward\": [\n        {\n            \"cardId\": 185840,\n            \"value\": 0\n        }\n    ],\n    \"redemption\": [\n        {\n            \"cardId\": 185839,\n            \"value\": 1099\n        }\n    ]\n}"
                        },
                        {
                            "name": "Was canceled",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelOrderByTransaction/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelOrderByTransaction",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels both the loyalty transaction and its order — refunds cashback that was earned and rolls back any redeemed reward. Use when the entire purchase is being reverted."
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"status_code\": 409,\n    \"reason_phrase\": \"Transaction was canceled\",\n    \"message\": \"This transaction was canceled previously\"\n}"
                        }
                    ]
                },
                {
                    "name": "Confirm Order by confirmToken",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/confirmOrder/{{confirmToken}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "confirmOrder",
                                "{{confirmToken}}"
                            ]
                        },
                        "description": "Confirms a pending transaction using the `confirmToken` returned by Reward by Order.\nApplies the rewards permanently and records the final sale.\n\nMonetary fields (`amountToRedeem`, payment `value`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values) for the convention.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": \"order-12345\",\n    \"amountToRedeem\": null,\n    \"waitSettlement\": false,\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"name\": \"Tintim\"\n    },\n    \"payments\": [\n        {\n            \"paymentSystem\": \"4\",\n            \"paymentSystemName\": \"Mastercard\",\n            \"type\": \"creditCard\",\n            \"value\": 5447,\n            \"installments\": 3,\n            \"firstDigits\": \"550209\",\n            \"lastDigits\": \"2569\"\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success — customer identified",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/confirmOrder/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "confirmOrder",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Confirms a pending transaction using the `confirmToken` returned by Reward by Order.\nApplies the rewards permanently and records the final sale.\n\nMonetary fields (`amountToRedeem`, payment `value`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values) for the convention.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": \"order-12345\",\n    \"amountToRedeem\": null,\n    \"waitSettlement\": false,\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"name\": \"Tintim\"\n    },\n    \"payments\": [\n        {\n            \"paymentSystem\": \"4\",\n            \"paymentSystemName\": \"Mastercard\",\n            \"type\": \"creditCard\",\n            \"value\": 5447,\n            \"installments\": 3,\n            \"firstDigits\": \"550209\",\n            \"lastDigits\": \"2569\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"organization\": \"acme\",\n    \"orderId\": \"456\",\n    \"TID\": \"54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49\",\n    \"customerId\": 570971,\n    \"person\": 570971,\n    \"cashback\": {\n        \"redeemedOrder\": 12500,\n        \"accumulatedOrder\": 96390\n    },\n    \"confirmedAt\": \"2025-01-15T16:21:39-03:00\",\n    \"dateTime\": \"2025-01-15T16:21:44-03:00\"\n}"
                        },
                        {
                            "name": "Success — anonymous sale (no customer identified).\n\nWith no customer there is no one to credit, so no reward card is created.\nThe response reflects that: `customerId` and `person` are **omitted**, and\nboth `cashback` values come back `0`. Do not read the accumulation from\nthis response as a credited amount — for what the customer actually\naccumulated, use the reward card endpoints.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/confirmOrder/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "confirmOrder",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Confirms a pending transaction using the `confirmToken` returned by Reward by Order.\nApplies the rewards permanently and records the final sale.\n\nMonetary fields (`amountToRedeem`, payment `value`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values) for the convention.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": \"order-12345\",\n    \"amountToRedeem\": null,\n    \"waitSettlement\": false,\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"name\": \"Tintim\"\n    },\n    \"payments\": [\n        {\n            \"paymentSystem\": \"4\",\n            \"paymentSystemName\": \"Mastercard\",\n            \"type\": \"creditCard\",\n            \"value\": 5447,\n            \"installments\": 3,\n            \"firstDigits\": \"550209\",\n            \"lastDigits\": \"2569\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"organization\": \"acme\",\n    \"orderId\": \"456\",\n    \"TID\": \"54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49\",\n    \"cashback\": {\n        \"redeemedOrder\": 0,\n        \"accumulatedOrder\": 0\n    },\n    \"confirmedAt\": \"2025-01-15T16:21:39-03:00\",\n    \"dateTime\": \"2025-01-15T16:21:44-03:00\"\n}"
                        },
                        {
                            "name": "Missing `confirmToken` in URL or `id` in body.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/confirmOrder/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "confirmOrder",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Confirms a pending transaction using the `confirmToken` returned by Reward by Order.\nApplies the rewards permanently and records the final sale.\n\nMonetary fields (`amountToRedeem`, payment `value`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values) for the convention.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": \"order-12345\",\n    \"amountToRedeem\": null,\n    \"waitSettlement\": false,\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"name\": \"Tintim\"\n    },\n    \"payments\": [\n        {\n            \"paymentSystem\": \"4\",\n            \"paymentSystemName\": \"Mastercard\",\n            \"type\": \"creditCard\",\n            \"value\": 5447,\n            \"installments\": 3,\n            \"firstDigits\": \"550209\",\n            \"lastDigits\": \"2569\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "The provided `confirmToken` does not belong to an existing prediction.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/confirmOrder/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "confirmOrder",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Confirms a pending transaction using the `confirmToken` returned by Reward by Order.\nApplies the rewards permanently and records the final sale.\n\nMonetary fields (`amountToRedeem`, payment `value`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values) for the convention.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": \"order-12345\",\n    \"amountToRedeem\": null,\n    \"waitSettlement\": false,\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"name\": \"Tintim\"\n    },\n    \"payments\": [\n        {\n            \"paymentSystem\": \"4\",\n            \"paymentSystemName\": \"Mastercard\",\n            \"type\": \"creditCard\",\n            \"value\": 5447,\n            \"installments\": 3,\n            \"firstDigits\": \"550209\",\n            \"lastDigits\": \"2569\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "The order has already been confirmed or the confirmation period has expired.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/confirmOrder/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "confirmOrder",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Confirms a pending transaction using the `confirmToken` returned by Reward by Order.\nApplies the rewards permanently and records the final sale.\n\nMonetary fields (`amountToRedeem`, payment `value`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values) for the convention.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": \"order-12345\",\n    \"amountToRedeem\": null,\n    \"waitSettlement\": false,\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"name\": \"Tintim\"\n    },\n    \"payments\": [\n        {\n            \"paymentSystem\": \"4\",\n            \"paymentSystemName\": \"Mastercard\",\n            \"type\": \"creditCard\",\n            \"value\": 5447,\n            \"installments\": 3,\n            \"firstDigits\": \"550209\",\n            \"lastDigits\": \"2569\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Partial cancellation",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelPartial/{{TID}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "cancelPartial",
                                "{{TID}}"
                            ]
                        },
                        "description": "Cancels specific items from a confirmed transaction. Returns the redemption (cashback)\nthat should be refunded to the customer and reverts the reward (cashback) generated for\nthose items.\n\nItems are matched by `id` (SKU) and, when needed, by `price` — never by the position of the\nitem inside the request. When the same `id` appears in more than one line of the order:\n\n- **All lines share the same unit price** — `price` is optional. Lines are consumed in the\n  order they were sent in `rewardByOrder`, so cancelling one unit takes the first line that\n  still has an uncancelled quantity. The lines are interchangeable, so the refund is the same\n  whichever one is picked.\n- **The lines have different unit prices** — `price` becomes **required**. Without it the\n  request fails with `409` instead of guessing a line, since cancelling the wrong line would\n  refund the wrong amount.\n\nRe-sending every item of the original purchase remains the safest approach.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelPartial/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelPartial",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels specific items from a confirmed transaction. Returns the redemption (cashback)\nthat should be refunded to the customer and reverts the reward (cashback) generated for\nthose items.\n\nItems are matched by `id` (SKU) and, when needed, by `price` — never by the position of the\nitem inside the request. When the same `id` appears in more than one line of the order:\n\n- **All lines share the same unit price** — `price` is optional. Lines are consumed in the\n  order they were sent in `rewardByOrder`, so cancelling one unit takes the first line that\n  still has an uncancelled quantity. The lines are interchangeable, so the refund is the same\n  whichever one is picked.\n- **The lines have different unit prices** — `price` becomes **required**. Without it the\n  request fails with `409` instead of guessing a line, since cancelling the wrong line would\n  refund the wrong amount.\n\nRe-sending every item of the original purchase remains the safest approach.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"TID\": \"6ea795c61088f27baa304d3dce8e4e7a85b99f78378d1101dbfc82864759e798\",\n    \"redemption\": [\n        { \"cardId\": 331467, \"value\": \"949\" },\n        { \"cardId\": 331471, \"value\": \"1748\" },\n        { \"cardId\": 331486, \"value\": \"3432\" }\n    ],\n    \"reward\": [\n        { \"cardId\": 331532, \"value\": 1601 },\n        { \"cardId\": 331533, \"value\": 6574 }\n    ]\n}"
                        },
                        {
                            "name": "Missing `items` in body or missing `hash`/`TID` in URL.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelPartial/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelPartial",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels specific items from a confirmed transaction. Returns the redemption (cashback)\nthat should be refunded to the customer and reverts the reward (cashback) generated for\nthose items.\n\nItems are matched by `id` (SKU) and, when needed, by `price` — never by the position of the\nitem inside the request. When the same `id` appears in more than one line of the order:\n\n- **All lines share the same unit price** — `price` is optional. Lines are consumed in the\n  order they were sent in `rewardByOrder`, so cancelling one unit takes the first line that\n  still has an uncancelled quantity. The lines are interchangeable, so the refund is the same\n  whichever one is picked.\n- **The lines have different unit prices** — `price` becomes **required**. Without it the\n  request fails with `409` instead of guessing a line, since cancelling the wrong line would\n  refund the wrong amount.\n\nRe-sending every item of the original purchase remains the safest approach.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Transaction not found for the given `TID`, or the order behind it no longer exists.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelPartial/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelPartial",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels specific items from a confirmed transaction. Returns the redemption (cashback)\nthat should be refunded to the customer and reverts the reward (cashback) generated for\nthose items.\n\nItems are matched by `id` (SKU) and, when needed, by `price` — never by the position of the\nitem inside the request. When the same `id` appears in more than one line of the order:\n\n- **All lines share the same unit price** — `price` is optional. Lines are consumed in the\n  order they were sent in `rewardByOrder`, so cancelling one unit takes the first line that\n  still has an uncancelled quantity. The lines are interchangeable, so the refund is the same\n  whichever one is picked.\n- **The lines have different unit prices** — `price` becomes **required**. Without it the\n  request fails with `409` instead of guessing a line, since cancelling the wrong line would\n  refund the wrong amount.\n\nRe-sending every item of the original purchase remains the safest approach.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "The same `id` appears in multiple lines with different unit prices and `price` was omitted, so the line to cancel is ambiguous. Re-send the item with `price`.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelPartial/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelPartial",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels specific items from a confirmed transaction. Returns the redemption (cashback)\nthat should be refunded to the customer and reverts the reward (cashback) generated for\nthose items.\n\nItems are matched by `id` (SKU) and, when needed, by `price` — never by the position of the\nitem inside the request. When the same `id` appears in more than one line of the order:\n\n- **All lines share the same unit price** — `price` is optional. Lines are consumed in the\n  order they were sent in `rewardByOrder`, so cancelling one unit takes the first line that\n  still has an uncancelled quantity. The lines are interchangeable, so the refund is the same\n  whichever one is picked.\n- **The lines have different unit prices** — `price` becomes **required**. Without it the\n  request fails with `409` instead of guessing a line, since cancelling the wrong line would\n  refund the wrong amount.\n\nRe-sending every item of the original purchase remains the safest approach.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"status_code\": 409,\n    \"reason_phrase\": \"Conflict\",\n    \"message\": \"Item (7702781260484) has multiple lines with different prices; inform 'price' to select which one\"\n}"
                        },
                        {
                            "name": "The requested quantity is larger than what is still uncancelled for that item.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelPartial/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelPartial",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels specific items from a confirmed transaction. Returns the redemption (cashback)\nthat should be refunded to the customer and reverts the reward (cashback) generated for\nthose items.\n\nItems are matched by `id` (SKU) and, when needed, by `price` — never by the position of the\nitem inside the request. When the same `id` appears in more than one line of the order:\n\n- **All lines share the same unit price** — `price` is optional. Lines are consumed in the\n  order they were sent in `rewardByOrder`, so cancelling one unit takes the first line that\n  still has an uncancelled quantity. The lines are interchangeable, so the refund is the same\n  whichever one is picked.\n- **The lines have different unit prices** — `price` becomes **required**. Without it the\n  request fails with `409` instead of guessing a line, since cancelling the wrong line would\n  refund the wrong amount.\n\nRe-sending every item of the original purchase remains the safest approach.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"status_code\": 409,\n    \"reason_phrase\": \"Conflict\",\n    \"message\": \"Item (7702781260484) has more items than available to cancel.\"\n}"
                        },
                        {
                            "name": "The `id` was not part of this transaction, or the `price` sent does not match any line of the order.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/cancelPartial/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "cancelPartial",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels specific items from a confirmed transaction. Returns the redemption (cashback)\nthat should be refunded to the customer and reverts the reward (cashback) generated for\nthose items.\n\nItems are matched by `id` (SKU) and, when needed, by `price` — never by the position of the\nitem inside the request. When the same `id` appears in more than one line of the order:\n\n- **All lines share the same unit price** — `price` is optional. Lines are consumed in the\n  order they were sent in `rewardByOrder`, so cancelling one unit takes the first line that\n  still has an uncancelled quantity. The lines are interchangeable, so the refund is the same\n  whichever one is picked.\n- **The lines have different unit prices** — `price` becomes **required**. Without it the\n  request fails with `409` instead of guessing a line, since cancelling the wrong line would\n  refund the wrong amount.\n\nRe-sending every item of the original purchase remains the safest approach.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"status_code\": 409,\n    \"reason_phrase\": \"Conflict\",\n    \"message\": \"Item (7702781260484) not found\"\n}"
                        }
                    ]
                },
                {
                    "name": "Promotion by Order",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/getPromotion",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "getPromotion"
                            ]
                        },
                        "description": "Calculates promotional discounts that apply to a given order. Each organization may have\none or more active campaigns evaluated in priority order — the response lists every\ndiscount that fired for the cart.\n\nThis endpoint accepts the same body shape as `rewardByOrder` (see [Reward by Order](../reward-by-order))\nand operates in two modes: **Public** (omit `x-guper-authorization`) and **Private**.\nMonetary fields (`price`, `listPrice`, `tax`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"sip\",\n    \"storeId\": \"1\",\n    \"client\": \"<client>\",\n    \"items\": [\n        {\n            \"id\": \"2\",\n            \"productId\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"categoryId\": \"20\",\n            \"brandId\": \"20\",\n            \"sellerId\": \"1\",\n            \"collection\": [\n                347,\n                336\n            ],\n            \"tax\": 1232,\n            \"quantity\": 2,\n            \"price\": 96390,\n            \"listPrice\": 100000\n        }\n    ],\n    \"shipping\": \"<shipping>\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success — returns every discount that applied. `discount` is empty when no campaign matched.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/getPromotion",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "getPromotion"
                                    ]
                                },
                                "description": "Calculates promotional discounts that apply to a given order. Each organization may have\none or more active campaigns evaluated in priority order — the response lists every\ndiscount that fired for the cart.\n\nThis endpoint accepts the same body shape as `rewardByOrder` (see [Reward by Order](../reward-by-order))\nand operates in two modes: **Public** (omit `x-guper-authorization`) and **Private**.\nMonetary fields (`price`, `listPrice`, `tax`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"sip\",\n    \"storeId\": \"1\",\n    \"client\": \"<client>\",\n    \"items\": [\n        {\n            \"id\": \"2\",\n            \"productId\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"categoryId\": \"20\",\n            \"brandId\": \"20\",\n            \"sellerId\": \"1\",\n            \"collection\": [\n                347,\n                336\n            ],\n            \"tax\": 1232,\n            \"quantity\": 2,\n            \"price\": 96390,\n            \"listPrice\": 100000\n        }\n    ],\n    \"shipping\": \"<shipping>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"discount\": [\n        {\n            \"campaign\": \"NEWPROGRESSIVE2025\",\n            \"description\": \"Desconto por quantidade de itens\",\n            \"total\": 38556,\n            \"item\": [\n                { \"id\": \"2\", \"position\": 0, \"value\": 19278, \"quantity\": 2 },\n                { \"id\": \"3\", \"position\": 1, \"value\": 19278, \"quantity\": 1 }\n            ]\n        }\n    ]\n}"
                        },
                        {
                            "name": "Invalid or malformed JSON body.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/getPromotion",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "getPromotion"
                                    ]
                                },
                                "description": "Calculates promotional discounts that apply to a given order. Each organization may have\none or more active campaigns evaluated in priority order — the response lists every\ndiscount that fired for the cart.\n\nThis endpoint accepts the same body shape as `rewardByOrder` (see [Reward by Order](../reward-by-order))\nand operates in two modes: **Public** (omit `x-guper-authorization`) and **Private**.\nMonetary fields (`price`, `listPrice`, `tax`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"sip\",\n    \"storeId\": \"1\",\n    \"client\": \"<client>\",\n    \"items\": [\n        {\n            \"id\": \"2\",\n            \"productId\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"categoryId\": \"20\",\n            \"brandId\": \"20\",\n            \"sellerId\": \"1\",\n            \"collection\": [\n                347,\n                336\n            ],\n            \"tax\": 1232,\n            \"quantity\": 2,\n            \"price\": 96390,\n            \"listPrice\": 100000\n        }\n    ],\n    \"shipping\": \"<shipping>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Reward by Order — Private",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/rewardByOrder",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "rewardByOrder"
                            ]
                        },
                        "description": "Returns customer data, redeemable reward information and a confirmation token\nyou can later send to `confirmOrder`. Requires a valid user token.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"checkoutId\": \"ck_demo_a1b2-c3d4\",\n    \"purchaseType\": \"delivery\",\n    \"client\": {\n        \"id\": \"123123\",\n        \"name\": \"Tintim\",\n        \"document\": \"32165987\",\n        \"email\": \"tintim@guper.co\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\"\n    },\n    \"attendants\": {\n        \"cashier\": {\n            \"id\": \"123\"\n        },\n        \"salesperson\": {\n            \"id\": \"342\"\n        }\n    },\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"productId\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"categoryId\": \"20\",\n            \"brandId\": \"20\",\n            \"sellerId\": \"1\",\n            \"tax\": 1232,\n            \"quantity\": 1,\n            \"price\": 96390,\n            \"listPrice\": 100000\n        }\n    ],\n    \"shipping\": [\n        {\n            \"id\": \"AA123456785BR\",\n            \"courierId\": \"correios-br\",\n            \"courierName\": \"Correios\",\n            \"price\": 2000,\n            \"listPrice\": 2000\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/rewardByOrder",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "rewardByOrder"
                                    ]
                                },
                                "description": "Returns customer data, redeemable reward information and a confirmation token\nyou can later send to `confirmOrder`. Requires a valid user token.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"checkoutId\": \"ck_demo_a1b2-c3d4\",\n    \"purchaseType\": \"delivery\",\n    \"client\": {\n        \"id\": \"123123\",\n        \"name\": \"Tintim\",\n        \"document\": \"32165987\",\n        \"email\": \"tintim@guper.co\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\"\n    },\n    \"attendants\": {\n        \"cashier\": {\n            \"id\": \"123\"\n        },\n        \"salesperson\": {\n            \"id\": \"342\"\n        }\n    },\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"productId\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"categoryId\": \"20\",\n            \"brandId\": \"20\",\n            \"sellerId\": \"1\",\n            \"tax\": 1232,\n            \"quantity\": 1,\n            \"price\": 96390,\n            \"listPrice\": 100000\n        }\n    ],\n    \"shipping\": [\n        {\n            \"id\": \"AA123456785BR\",\n            \"courierId\": \"correios-br\",\n            \"courierName\": \"Correios\",\n            \"price\": 2000,\n            \"listPrice\": 2000\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"organization\": \"acme\",\n    \"interface\": \"generic\",\n    \"customerId\": 708,\n    \"cashback\": {\n        \"thisOrder\": {\n            \"redeemable\": {\n                \"total\": 522,\n                \"item\": [{ \"id\": \"1\", \"value\": 522 }]\n            },\n            \"accumulating\": {\n                \"total\": 4819,\n                \"item\": [{ \"id\": \"1\", \"value\": 4819 }]\n            }\n        },\n        \"userBalance\": { \"total\": 0, \"availableAmount\": 0 }\n    },\n    \"confirmToken\": \"54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49\",\n    \"smartpos\": \"https://acme.myguper.com/smartpos/54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49\",\n    \"expiresAt\": \"2024-05-21T11:21:27-03:00\",\n    \"dateTime\": \"2024-05-21T10:51:27-03:00\"\n}"
                        }
                    ]
                },
                {
                    "name": "Reward by Order — Public",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/rewardByOrder",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "rewardByOrder"
                            ]
                        },
                        "description": "Returns only the cashback that *will* accumulate for this order — no\ncustomer data and no confirmation token. No authentication required.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/rewardByOrder",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "rewardByOrder"
                                    ]
                                },
                                "description": "Returns only the cashback that *will* accumulate for this order — no\ncustomer data and no confirmation token. No authentication required.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"quantity\": 1,\n            \"price\": 96390\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"organization\": \"acme\",\n    \"interface\": \"generic\",\n    \"cashback\": {\n        \"thisOrder\": {\n            \"accumulating\": { \"total\": 9639 }\n        }\n    },\n    \"expiresAt\": \"2024-05-21T11:30:37-03:00\",\n    \"dateTime\": \"2024-05-21T11:00:37-03:00\"\n}"
                        }
                    ]
                },
                {
                    "name": "Transaction Settlement",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/transactionSettlement/{{TID}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "transactionSettlement",
                                "{{TID}}"
                            ]
                        },
                        "description": "Settles a transaction by TID — finalises pending accumulation and redemption so balances\nbecome available to the customer.\n\nThis is the **explicit** way to finalize a transaction that was confirmed with\n`waitSettlement: true` (see [Confirm Order by confirmToken](/docs/{lang}/api-reference/loyalty/checkout/confirm-order-by-confirmtoken)):\nit credits the rewards and settles the reservation. A held transaction is also finalized\n**automatically** when its order reaches a final state — completed (rewards credited) or\ncanceled (reservation released and any pending reward rolled back) — so calling this\nendpoint is only required when you drive settlement yourself instead of relying on the\norder flow."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/transactionSettlement/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "transactionSettlement",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Settles a transaction by TID — finalises pending accumulation and redemption so balances\nbecome available to the customer.\n\nThis is the **explicit** way to finalize a transaction that was confirmed with\n`waitSettlement: true` (see [Confirm Order by confirmToken](/docs/{lang}/api-reference/loyalty/checkout/confirm-order-by-confirmtoken)):\nit credits the rewards and settles the reservation. A held transaction is also finalized\n**automatically** when its order reaches a final state — completed (rewards credited) or\ncanceled (reservation released and any pending reward rolled back) — so calling this\nendpoint is only required when you drive settlement yourself instead of relying on the\norder flow."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Update Transaction",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/updateTransaction/{{confirmToken}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "updateTransaction",
                                "{{confirmToken}}"
                            ]
                        },
                        "description": "Updates a pending transaction (items, totals, customer, payments) before confirmation.\nRecalculates redeemable and accumulating cashback so the next `confirmOrder` uses the new\nvalues.\n\nBoth `recalculateReward` and `recalculateRedemption` default to `true` — set them to `false`\nto keep the original calculation when sending only metadata changes (e.g. updating items\nwithout re-running the cashback rules). Monetary fields (`price`, `listPrice`, `tax`,\n`amountToRedeem`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"recalculateReward\": true,\n    \"recalculateRedemption\": true,\n    \"amountToRedeem\": null,\n    \"items\": [\n        {\n            \"skuId\": \"1\",\n            \"quantity\": 1,\n            \"price\": 90000,\n            \"listPrice\": 100000,\n            \"tax\": 1232\n        }\n    ],\n    \"payments\": \"<payments>\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success — returns the recalculated prediction (cashback, balance, confirmToken).",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/updateTransaction/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "updateTransaction",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Updates a pending transaction (items, totals, customer, payments) before confirmation.\nRecalculates redeemable and accumulating cashback so the next `confirmOrder` uses the new\nvalues.\n\nBoth `recalculateReward` and `recalculateRedemption` default to `true` — set them to `false`\nto keep the original calculation when sending only metadata changes (e.g. updating items\nwithout re-running the cashback rules). Monetary fields (`price`, `listPrice`, `tax`,\n`amountToRedeem`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"recalculateReward\": true,\n    \"recalculateRedemption\": true,\n    \"amountToRedeem\": null,\n    \"items\": [\n        {\n            \"skuId\": \"1\",\n            \"quantity\": 1,\n            \"price\": 90000,\n            \"listPrice\": 100000,\n            \"tax\": 1232\n        }\n    ],\n    \"payments\": \"<payments>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"organization\": \"xpto\",\n    \"interface\": \"generic\",\n    \"customerId\": 2157344,\n    \"cashback\": {\n        \"thisOrder\": {\n            \"redeemable\": {\n                \"total\": 55059,\n                \"item\": [\n                    { \"skuId\": \"2\",  \"value\": 18353 },\n                    { \"skuId\": \"10\", \"value\": 18353 },\n                    { \"skuId\": \"10\", \"value\": 18353 }\n                ]\n            },\n            \"accumulating\": {\n                \"total\": 54464,\n                \"item\": [\n                    { \"skuId\": \"2\",  \"value\": 18155 },\n                    { \"skuId\": \"10\", \"value\": 18155 },\n                    { \"skuId\": \"10\", \"value\": 18154 }\n                ]\n            }\n        },\n        \"userBalance\": { \"total\": 55059, \"availableAmount\": 54464 }\n    },\n    \"coupon\": [],\n    \"confirmToken\": \"ca93b522eb10c42dff16ce8d5b3ad86d962a610184db68643158eec9bb10747f\",\n    \"expiresAt\": \"2025-07-25T00:52:14-06:00\",\n    \"smartpos\": \"https://xpto.myguper.com/smartpos/ca93b522eb10c42dff16ce8d5b3ad86d962a610184db68643158eec9bb10747f\",\n    \"dateTime\": \"2025-07-24T12:52:14-06:00\"\n}"
                        },
                        {
                            "name": "`confirmToken` not found or missing in URL.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/updateTransaction/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "updateTransaction",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Updates a pending transaction (items, totals, customer, payments) before confirmation.\nRecalculates redeemable and accumulating cashback so the next `confirmOrder` uses the new\nvalues.\n\nBoth `recalculateReward` and `recalculateRedemption` default to `true` — set them to `false`\nto keep the original calculation when sending only metadata changes (e.g. updating items\nwithout re-running the cashback rules). Monetary fields (`price`, `listPrice`, `tax`,\n`amountToRedeem`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"recalculateReward\": true,\n    \"recalculateRedemption\": true,\n    \"amountToRedeem\": null,\n    \"items\": [\n        {\n            \"skuId\": \"1\",\n            \"quantity\": 1,\n            \"price\": 90000,\n            \"listPrice\": 100000,\n            \"tax\": 1232\n        }\n    ],\n    \"payments\": \"<payments>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "The order has already been confirmed or expired.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/updateTransaction/{{confirmToken}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "updateTransaction",
                                        "{{confirmToken}}"
                                    ]
                                },
                                "description": "Updates a pending transaction (items, totals, customer, payments) before confirmation.\nRecalculates redeemable and accumulating cashback so the next `confirmOrder` uses the new\nvalues.\n\nBoth `recalculateReward` and `recalculateRedemption` default to `true` — set them to `false`\nto keep the original calculation when sending only metadata changes (e.g. updating items\nwithout re-running the cashback rules). Monetary fields (`price`, `listPrice`, `tax`,\n`amountToRedeem`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"recalculateReward\": true,\n    \"recalculateRedemption\": true,\n    \"amountToRedeem\": null,\n    \"items\": [\n        {\n            \"skuId\": \"1\",\n            \"quantity\": 1,\n            \"price\": 90000,\n            \"listPrice\": 100000,\n            \"tax\": 1232\n        }\n    ],\n    \"payments\": \"<payments>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Coupons",
            "item": [
                {
                    "name": "Reserve",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{transactionId}}/reserve",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "coupon",
                                "{{transactionId}}",
                                "reserve"
                            ]
                        },
                        "description": "Reserves a coupon code from a coupon batch (`couponBatchId`) for a specific transaction.\nPicks an available code from the batch, computes the discount based on the batch\nconfiguration (fixed or percent over `total_item`), and reserves the redemption against\nthe transaction (`transactionId` is the `confirmToken`).\n\nUse [Coupon search](../search) first to find a compatible batch for the cart, then call\nthis endpoint with the chosen `couponBatchId`. Settle the coupon with [Coupon settlement](../settlement)\nafter the order is placed.\n\nMonetary fields (`total_item`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"couponBatchId\": 123,\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"clientId\": 123,\n    \"total_item\": 96390\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success — returns the reserved coupon code with its computed `couponValue`.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{transactionId}}/reserve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "{{transactionId}}",
                                        "reserve"
                                    ]
                                },
                                "description": "Reserves a coupon code from a coupon batch (`couponBatchId`) for a specific transaction.\nPicks an available code from the batch, computes the discount based on the batch\nconfiguration (fixed or percent over `total_item`), and reserves the redemption against\nthe transaction (`transactionId` is the `confirmToken`).\n\nUse [Coupon search](../search) first to find a compatible batch for the cart, then call\nthis endpoint with the chosen `couponBatchId`. Settle the coupon with [Coupon settlement](../settlement)\nafter the order is placed.\n\nMonetary fields (`total_item`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"couponBatchId\": 123,\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"clientId\": 123,\n    \"total_item\": 96390\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Required body fields missing or `transactionId` missing in URL.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{transactionId}}/reserve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "{{transactionId}}",
                                        "reserve"
                                    ]
                                },
                                "description": "Reserves a coupon code from a coupon batch (`couponBatchId`) for a specific transaction.\nPicks an available code from the batch, computes the discount based on the batch\nconfiguration (fixed or percent over `total_item`), and reserves the redemption against\nthe transaction (`transactionId` is the `confirmToken`).\n\nUse [Coupon search](../search) first to find a compatible batch for the cart, then call\nthis endpoint with the chosen `couponBatchId`. Settle the coupon with [Coupon settlement](../settlement)\nafter the order is placed.\n\nMonetary fields (`total_item`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"couponBatchId\": 123,\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"clientId\": 123,\n    \"total_item\": 96390\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Coupon batch not found.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{transactionId}}/reserve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "{{transactionId}}",
                                        "reserve"
                                    ]
                                },
                                "description": "Reserves a coupon code from a coupon batch (`couponBatchId`) for a specific transaction.\nPicks an available code from the batch, computes the discount based on the batch\nconfiguration (fixed or percent over `total_item`), and reserves the redemption against\nthe transaction (`transactionId` is the `confirmToken`).\n\nUse [Coupon search](../search) first to find a compatible batch for the cart, then call\nthis endpoint with the chosen `couponBatchId`. Settle the coupon with [Coupon settlement](../settlement)\nafter the order is placed.\n\nMonetary fields (`total_item`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"couponBatchId\": 123,\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"clientId\": 123,\n    \"total_item\": 96390\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "No codes available in the batch, or the transaction cannot be confirmed.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{transactionId}}/reserve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "{{transactionId}}",
                                        "reserve"
                                    ]
                                },
                                "description": "Reserves a coupon code from a coupon batch (`couponBatchId`) for a specific transaction.\nPicks an available code from the batch, computes the discount based on the batch\nconfiguration (fixed or percent over `total_item`), and reserves the redemption against\nthe transaction (`transactionId` is the `confirmToken`).\n\nUse [Coupon search](../search) first to find a compatible batch for the cart, then call\nthis endpoint with the chosen `couponBatchId`. Settle the coupon with [Coupon settlement](../settlement)\nafter the order is placed.\n\nMonetary fields (`total_item`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"couponBatchId\": 123,\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"clientId\": 123,\n    \"total_item\": 96390\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Search Coupon by code — find a discount / promo code",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/search",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "coupon",
                                "search"
                            ]
                        },
                        "description": "Returns the best coupon batch for the current cart based on the active redemption policy.\nThe service:\n\n1. Lists all coupon batches available for the store's policy.\n2. Computes the discount each batch would generate (`fixed` value or percent over `total_item`).\n3. Picks the highest-pass match (the lowest discount that still covers `redeemableTotal`).\n   If no batch covers it, falls back to the closest low-pass match (the highest discount under\n   `redeemableTotal`).\n\nUse the returned `couponBatchId` with [Coupon reserve](../reserve) to lock a code for the\ntransaction. Monetary fields (`total_item`, `redeemableTotal`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"total_item\": 25000,\n    \"redeemableTotal\": 25000\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/search",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "search"
                                    ]
                                },
                                "description": "Returns the best coupon batch for the current cart based on the active redemption policy.\nThe service:\n\n1. Lists all coupon batches available for the store's policy.\n2. Computes the discount each batch would generate (`fixed` value or percent over `total_item`).\n3. Picks the highest-pass match (the lowest discount that still covers `redeemableTotal`).\n   If no batch covers it, falls back to the closest low-pass match (the highest discount under\n   `redeemableTotal`).\n\nUse the returned `couponBatchId` with [Coupon reserve](../reserve) to lock a code for the\ntransaction. Monetary fields (`total_item`, `redeemableTotal`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"total_item\": 25000,\n    \"redeemableTotal\": 25000\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"couponBatchId\": 2,\n    \"policy\": 14,\n    \"description\": \"Test\",\n    \"type\": \"fixed\",\n    \"value\": 30000,\n    \"discount\": 30000\n}"
                        },
                        {
                            "name": "No coupon batch found for the policy or no compatible discount.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/search",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "search"
                                    ]
                                },
                                "description": "Returns the best coupon batch for the current cart based on the active redemption policy.\nThe service:\n\n1. Lists all coupon batches available for the store's policy.\n2. Computes the discount each batch would generate (`fixed` value or percent over `total_item`).\n3. Picks the highest-pass match (the lowest discount that still covers `redeemableTotal`).\n   If no batch covers it, falls back to the closest low-pass match (the highest discount under\n   `redeemableTotal`).\n\nUse the returned `couponBatchId` with [Coupon reserve](../reserve) to lock a code for the\ntransaction. Monetary fields (`total_item`, `redeemableTotal`) are sent as **integer cents** —\nsee [Monetary values](/docs/{lang}/guides/monetary-values).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"2\",\n    \"total_item\": 25000,\n    \"redeemableTotal\": 25000\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Coupon: Settlement",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{couponCode}}/settlement",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "coupon",
                                "{{couponCode}}",
                                "settlement"
                            ]
                        },
                        "description": "Settles a coupon by `couponCode` — marks it as redeemed and binds it\nto the originating `orderId`. The (organization, interface, code)\ntriple must match a non-redeemed `coupon_codes` row; re-submitting a\ncode that has already been redeemed returns 409 Conflict.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"generic\",\n    \"orderId\": \"VTEX-99182\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Coupon settled",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{couponCode}}/settlement",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "{{couponCode}}",
                                        "settlement"
                                    ]
                                },
                                "description": "Settles a coupon by `couponCode` — marks it as redeemed and binds it\nto the originating `orderId`. The (organization, interface, code)\ntriple must match a non-redeemed `coupon_codes` row; re-submitting a\ncode that has already been redeemed returns 409 Conflict.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"orderId\": \"VTEX-99182\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "No coupon code found with this couponCode",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{couponCode}}/settlement",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "{{couponCode}}",
                                        "settlement"
                                    ]
                                },
                                "description": "Settles a coupon by `couponCode` — marks it as redeemed and binds it\nto the originating `orderId`. The (organization, interface, code)\ntriple must match a non-redeemed `coupon_codes` row; re-submitting a\ncode that has already been redeemed returns 409 Conflict.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"orderId\": \"VTEX-99182\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Coupon already redeemed",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/coupon/{{couponCode}}/settlement",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "coupon",
                                        "{{couponCode}}",
                                        "settlement"
                                    ]
                                },
                                "description": "Settles a coupon by `couponCode` — marks it as redeemed and binds it\nto the originating `orderId`. The (organization, interface, code)\ntriple must match a non-redeemed `coupon_codes` row; re-submitting a\ncode that has already been redeemed returns 409 Conflict.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"orderId\": \"VTEX-99182\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"error\": true, \"message\": \"This coupon has already been redeemed.\" }"
                        }
                    ]
                }
            ]
        },
        {
            "name": "External event",
            "item": [
                {
                    "name": "External Event: Create Reward",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/external-event",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "external-event"
                            ]
                        },
                        "description": "Issues reward cards driven by **external-events** campaigns — used when an\noutside system (CRM, app, e-mail) decides *when* and *how much* to reward,\nand Guper just creates the cards under the campaign's identity (validity,\ntags, sequence, messaging).\n\nThe campaign supplies the structure; the request body supplies the value.\nInternally the call overrides the campaign's `aliquot` with the `value`\nyou send, so each entry in `campaigns[]` produces exactly one reward card\nof the requested amount. Optional `startsAt` / `expiresAt` per entry\noverride the default availability window of the resulting card.\n\nAccepts a single campaign object `{ id, value }` or an array of objects\n— a single object is auto-wrapped.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"generic\",\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"document\": \"<document>\",\n        \"name\": \"Tintim\"\n    },\n    \"campaigns\": [\n        {\n            \"id\": 7,\n            \"value\": 5000,\n            \"startsAt\": \"2026-05-08\",\n            \"expiresAt\": \"2027-05-08\"\n        }\n    ],\n    \"storeId\": \"<storeId>\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Cards generated",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/external-event",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "external-event"
                                    ]
                                },
                                "description": "Issues reward cards driven by **external-events** campaigns — used when an\noutside system (CRM, app, e-mail) decides *when* and *how much* to reward,\nand Guper just creates the cards under the campaign's identity (validity,\ntags, sequence, messaging).\n\nThe campaign supplies the structure; the request body supplies the value.\nInternally the call overrides the campaign's `aliquot` with the `value`\nyou send, so each entry in `campaigns[]` produces exactly one reward card\nof the requested amount. Optional `startsAt` / `expiresAt` per entry\noverride the default availability window of the resulting card.\n\nAccepts a single campaign object `{ id, value }` or an array of objects\n— a single object is auto-wrapped.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"document\": \"<document>\",\n        \"name\": \"Tintim\"\n    },\n    \"campaigns\": [\n        {\n            \"id\": 7,\n            \"value\": 5000,\n            \"startsAt\": \"2026-05-08\",\n            \"expiresAt\": \"2027-05-08\"\n        }\n    ],\n    \"storeId\": \"<storeId>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"reward\": [\n        { \"TID\": \"54eb6281…\", \"campaign\": 7,  \"rewardValue\": 5000 },\n        { \"TID\": \"54eb6281…\", \"campaign\": 12, \"rewardValue\": 1000 }\n    ],\n    \"total\": 6000\n}"
                        },
                        {
                            "name": "Body missing fields, invalid campaign, or campaign outside its window",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/external-event",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "external-event"
                                    ]
                                },
                                "description": "Issues reward cards driven by **external-events** campaigns — used when an\noutside system (CRM, app, e-mail) decides *when* and *how much* to reward,\nand Guper just creates the cards under the campaign's identity (validity,\ntags, sequence, messaging).\n\nThe campaign supplies the structure; the request body supplies the value.\nInternally the call overrides the campaign's `aliquot` with the `value`\nyou send, so each entry in `campaigns[]` produces exactly one reward card\nof the requested amount. Optional `startsAt` / `expiresAt` per entry\noverride the default availability window of the resulting card.\n\nAccepts a single campaign object `{ id, value }` or an array of objects\n— a single object is auto-wrapped.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"document\": \"<document>\",\n        \"name\": \"Tintim\"\n    },\n    \"campaigns\": [\n        {\n            \"id\": 7,\n            \"value\": 5000,\n            \"startsAt\": \"2026-05-08\",\n            \"expiresAt\": \"2027-05-08\"\n        }\n    ],\n    \"storeId\": \"<storeId>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"error\": \"bad_request\", \"message\": \"Campaign is not of type external-events (id: 7)\" }"
                        },
                        {
                            "name": "Interface, campaign or resolved client not found",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/external-event",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "external-event"
                                    ]
                                },
                                "description": "Issues reward cards driven by **external-events** campaigns — used when an\noutside system (CRM, app, e-mail) decides *when* and *how much* to reward,\nand Guper just creates the cards under the campaign's identity (validity,\ntags, sequence, messaging).\n\nThe campaign supplies the structure; the request body supplies the value.\nInternally the call overrides the campaign's `aliquot` with the `value`\nyou send, so each entry in `campaigns[]` produces exactly one reward card\nof the requested amount. Optional `startsAt` / `expiresAt` per entry\noverride the default availability window of the resulting card.\n\nAccepts a single campaign object `{ id, value }` or an array of objects\n— a single object is auto-wrapped.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"client\": {\n        \"id\": \"123123\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"tintim@guper.co\",\n        \"document\": \"<document>\",\n        \"name\": \"Tintim\"\n    },\n    \"campaigns\": [\n        {\n            \"id\": 7,\n            \"value\": 5000,\n            \"startsAt\": \"2026-05-08\",\n            \"expiresAt\": \"2027-05-08\"\n        }\n    ],\n    \"storeId\": \"<storeId>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"error\": \"not_found\", \"message\": \"Client not found\" }"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Ping",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "x-guper-authorization",
                        "value": "{{x-guper-authorization}}",
                        "type": "text",
                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                    },
                    {
                        "key": "Content-Type",
                        "value": "{{Content-Type}}",
                        "type": "text",
                        "description": "Always `application/json` for endpoints that accept a JSON body."
                    }
                ],
                "url": {
                    "raw": "https://{{organization}}.myguper.com/api/loyalty/ping",
                    "protocol": "https",
                    "host": [
                        "{{organization}}",
                        "myguper",
                        "com"
                    ],
                    "path": [
                        "api",
                        "loyalty",
                        "ping"
                    ]
                },
                "description": "Resource for checking service availability"
            },
            "response": [
                {
                    "name": "Success",
                    "originalRequest": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/ping",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "ping"
                            ]
                        },
                        "description": "Resource for checking service availability"
                    },
                    "status": "OK",
                    "code": 200,
                    "_postman_previewlanguage": "json",
                    "header": [
                        {
                            "key": "Content-Type",
                            "value": "application/json"
                        }
                    ],
                    "body": "{\n    \"organization\": \"acme\",\n    \"response\": \"Server online\",\n    \"dateTime\": \"2023-08-11T13:58:07-03:00\"\n}"
                }
            ]
        },
        {
            "name": "Redeem",
            "item": [
                {
                    "name": "Redeem: Reserve",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/redeem/reserve/{{hash}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "redeem",
                                "reserve",
                                "{{hash}}"
                            ]
                        },
                        "description": "Reserves the redeemable amount tied to a previously calculated reward\npromise (the `hash`/`confirmToken` returned by [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)).\nThe reservation enters `waitSettlement` and points are held against the\ncustomer's balance until the order is confirmed (`reserved` → `cancelled`\nor `redeemed` via [Settle](/docs/{lang}/api-reference/loyalty/redeem/settle)).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"refId\": \"<refId>\",\n    \"reserve\": 0,\n    \"couponCode\": \"<couponCode>\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Reservation accepted",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/redeem/reserve/{{hash}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "redeem",
                                        "reserve",
                                        "{{hash}}"
                                    ]
                                },
                                "description": "Reserves the redeemable amount tied to a previously calculated reward\npromise (the `hash`/`confirmToken` returned by [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)).\nThe reservation enters `waitSettlement` and points are held against the\ncustomer's balance until the order is confirmed (`reserved` → `cancelled`\nor `redeemed` via [Settle](/docs/{lang}/api-reference/loyalty/redeem/settle)).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"refId\": \"<refId>\",\n    \"reserve\": 0,\n    \"couponCode\": \"<couponCode>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"organization\": \"acme\",\n    \"person\":       184532,\n    \"redeem\":       { \"reserved\": 1500 },\n    \"dateTime\":     \"2026-08-27T18:12:31-03:00\"\n}"
                        },
                        {
                            "name": "Hash not found / expired",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/redeem/reserve/{{hash}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "redeem",
                                        "reserve",
                                        "{{hash}}"
                                    ]
                                },
                                "description": "Reserves the redeemable amount tied to a previously calculated reward\npromise (the `hash`/`confirmToken` returned by [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)).\nThe reservation enters `waitSettlement` and points are held against the\ncustomer's balance until the order is confirmed (`reserved` → `cancelled`\nor `redeemed` via [Settle](/docs/{lang}/api-reference/loyalty/redeem/settle)).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"refId\": \"<refId>\",\n    \"reserve\": 0,\n    \"couponCode\": \"<couponCode>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Redeem: Settle",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/redeem/settle/{{hash}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "redeem",
                                "settle",
                                "{{hash}}"
                            ]
                        },
                        "description": "Settles a redeem reservation — converts a `reserved` hold into a final\n`redeemed` debit on the customer's balance. Called after the order is\nconfirmed by the payment/POS layer.\n\nThe `{hash}` is the transaction id, not a card id: one call settles every\ncard held by that reservation.\n\nNote the response shape: the status is the **key** inside `redeem`, not a\nvalue — `{\"redeem\": {\"rescued\": 1500}}`, where the number is the amount in\ncents."
                    },
                    "response": [
                        {
                            "name": "Settlement accepted",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/redeem/settle/{{hash}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "redeem",
                                        "settle",
                                        "{{hash}}"
                                    ]
                                },
                                "description": "Settles a redeem reservation — converts a `reserved` hold into a final\n`redeemed` debit on the customer's balance. Called after the order is\nconfirmed by the payment/POS layer.\n\nThe `{hash}` is the transaction id, not a card id: one call settles every\ncard held by that reservation.\n\nNote the response shape: the status is the **key** inside `redeem`, not a\nvalue — `{\"redeem\": {\"rescued\": 1500}}`, where the number is the amount in\ncents."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"organization\": \"acme\",\n    \"person\":       184532,\n    \"redeem\":       { \"rescued\": 1500 },\n    \"dateTime\":     \"2026-08-27T18:13:25-03:00\"\n}"
                        },
                        {
                            "name": "Hash not found",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/redeem/settle/{{hash}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "redeem",
                                        "settle",
                                        "{{hash}}"
                                    ]
                                },
                                "description": "Settles a redeem reservation — converts a `reserved` hold into a final\n`redeemed` debit on the customer's balance. Called after the order is\nconfirmed by the payment/POS layer.\n\nThe `{hash}` is the transaction id, not a card id: one call settles every\ncard held by that reservation.\n\nNote the response shape: the status is the **key** inside `redeem`, not a\nvalue — `{\"redeem\": {\"rescued\": 1500}}`, where the number is the amount in\ncents."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Reports",
            "item": [
                {
                    "name": "Audience Targeted by Period",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/audience/{{start}}/{{end}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "audience",
                                "{{start}}",
                                "{{end}}"
                            ]
                        },
                        "description": "Who the campaigns were **addressed to** in a date window — the denominator\nbehind \"of the people we aimed at, how many actually got the reward\".\n\n*Cards* tells you how many rewards were created. It does not tell you how many\npeople the campaign tried to reach to get there. This endpoint is the other\nhalf: divide one by the other and you get the answer.\n\nThe work it does for you is that **the audience lives in three different\ntables, one per trigger, with three different units**. Everything comes back\nin **people**:\n\n| Trigger | Source | One row is |\n|---|---|---|\n| `audience-list` | the campaign audience | one person |\n| `reactivate-reward` | the reactivation queue | one customer |\n| `last-chance` | the last-chance queue | one **card × campaign** |\n\nLast chance is the trap: its queue is keyed by the expiring card, not by the\nperson, so one customer with three expiring cards produces three rows.\nCounting rows there inflates the audience by more than double and halves any\nrate built on it. This endpoint deduplicates it for you.\n\nTwo numbers come back, and only one of them is a denominator:\n\n- **`targeted`** — distinct people **within each campaign**, summed. This is\n  what pairs with rewards granted, because a reward is also created per\n  (campaign, person): someone in two campaigns counts twice on **both** sides\n  of the division.\n- **`clients`** — distinct people across the trigger. It answers \"how many\n  people did we reach\", and must never be used as a denominator.\n\n**Triggers with no audience do not appear here, on purpose.**\n`form-submission` and `external-events` start from something the customer did\n— nobody was addressed. Adding their rewards to a denominator that does not\nexist drops the rate for no reason. `meta.triggers` lists what is covered.\n\nNote there is no `birthday` trigger. Birthday campaigns exist, but they are\nbuilt as an audience list, so they come back in that bucket."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/audience/{{start}}/{{end}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "audience",
                                        "{{start}}",
                                        "{{end}}"
                                    ]
                                },
                                "description": "Who the campaigns were **addressed to** in a date window — the denominator\nbehind \"of the people we aimed at, how many actually got the reward\".\n\n*Cards* tells you how many rewards were created. It does not tell you how many\npeople the campaign tried to reach to get there. This endpoint is the other\nhalf: divide one by the other and you get the answer.\n\nThe work it does for you is that **the audience lives in three different\ntables, one per trigger, with three different units**. Everything comes back\nin **people**:\n\n| Trigger | Source | One row is |\n|---|---|---|\n| `audience-list` | the campaign audience | one person |\n| `reactivate-reward` | the reactivation queue | one customer |\n| `last-chance` | the last-chance queue | one **card × campaign** |\n\nLast chance is the trap: its queue is keyed by the expiring card, not by the\nperson, so one customer with three expiring cards produces three rows.\nCounting rows there inflates the audience by more than double and halves any\nrate built on it. This endpoint deduplicates it for you.\n\nTwo numbers come back, and only one of them is a denominator:\n\n- **`targeted`** — distinct people **within each campaign**, summed. This is\n  what pairs with rewards granted, because a reward is also created per\n  (campaign, person): someone in two campaigns counts twice on **both** sides\n  of the division.\n- **`clients`** — distinct people across the trigger. It answers \"how many\n  people did we reach\", and must never be used as a denominator.\n\n**Triggers with no audience do not appear here, on purpose.**\n`form-submission` and `external-events` start from something the customer did\n— nobody was addressed. Adding their rewards to a denominator that does not\nexist drops the rate for no reason. `meta.triggers` lists what is covered.\n\nNote there is no `birthday` trigger. Birthday campaigns exist, but they are\nbuilt as an audience list, so they come back in that bucket."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "`start` is after `end`.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/audience/{{start}}/{{end}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "audience",
                                        "{{start}}",
                                        "{{end}}"
                                    ]
                                },
                                "description": "Who the campaigns were **addressed to** in a date window — the denominator\nbehind \"of the people we aimed at, how many actually got the reward\".\n\n*Cards* tells you how many rewards were created. It does not tell you how many\npeople the campaign tried to reach to get there. This endpoint is the other\nhalf: divide one by the other and you get the answer.\n\nThe work it does for you is that **the audience lives in three different\ntables, one per trigger, with three different units**. Everything comes back\nin **people**:\n\n| Trigger | Source | One row is |\n|---|---|---|\n| `audience-list` | the campaign audience | one person |\n| `reactivate-reward` | the reactivation queue | one customer |\n| `last-chance` | the last-chance queue | one **card × campaign** |\n\nLast chance is the trap: its queue is keyed by the expiring card, not by the\nperson, so one customer with three expiring cards produces three rows.\nCounting rows there inflates the audience by more than double and halves any\nrate built on it. This endpoint deduplicates it for you.\n\nTwo numbers come back, and only one of them is a denominator:\n\n- **`targeted`** — distinct people **within each campaign**, summed. This is\n  what pairs with rewards granted, because a reward is also created per\n  (campaign, person): someone in two campaigns counts twice on **both** sides\n  of the division.\n- **`clients`** — distinct people across the trigger. It answers \"how many\n  people did we reach\", and must never be used as a denominator.\n\n**Triggers with no audience do not appear here, on purpose.**\n`form-submission` and `external-events` start from something the customer did\n— nobody was addressed. Adding their rewards to a denominator that does not\nexist drops the rate for no reason. `meta.triggers` lists what is covered.\n\nNote there is no `birthday` trigger. Birthday campaigns exist, but they are\nbuilt as an audience list, so they come back in that bucket."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Cashback issued & redeemed by campaign (aggregate)",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/cards/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "cards",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "Org-wide cashback aggregate — cards issued, credit distributed, redeemed,\nbalance and expired — broken down by month, day, campaign, campaign trigger or\nstore, in a **single call**. It is the campaign report, grouped: instead of\ncalling the per-campaign report once per campaign (an org can have hundreds),\nthis returns every campaign at once.\n\nThis is the **program dashboard / KPIs for cashback emission and redemption**:\nhow much was **issued, redeemed and expired per campaign** in the period. (For\nthe current spendable balance per wallet — available, used — use the reward\nbalances report instead; this one is the emission/redemption flow over time.)\n\nReconciles with `loyalty.campaign.report` by construction — same source, same\nmath: `rewardCard` for issuance/balance/cards, `rewardCard_flow` for the\nprecise redeemed value.\n\n**Conversion (usage of the cards).** A card counts as used when a sale that\nspent its balance was **settled** — partial or full use both count. Open\ncheckout reservations and canceled reservations do not. Card balance is never\nused for this: it also drops on reward reversals and manual debits.\n\n- `touchedCards` — cards issued in the period (not canceled) with any settled\n  redemption, at any date. `touchedRedeemed` — the value those same cards\n  redeemed, at any date (`redeemed` follows the redemption date instead).\n- `cardsRedeemedFull` / `cardsRedeemedPartial` — of those, the ones that spent\n  the whole credit / that still had balance left.\n- `usageRate` — **conversion rate**: `touchedCards / (cards − cardsCanceled)`,\n  in %. `partialShare` / `fullShare` — % of `touchedCards` (they add up to 100).\n- Status buckets that add up to `cards`: `cardsRedeemed` (card with **zero**\n  balance), `cardsExpired`, `cardsCanceled`, `cardsActive`. `cardsRedeemed` is\n  not the conversion: a reversal also zeroes a card.\n- `expiredBalance` — balance left on the expired cards: the credit lost\n  because it was not used in time (same cut as `cardsExpired`).\n\nA recent period is still maturing — its conversion keeps rising while the\ncards are valid. Compare with an older, closed period.\n\nValues are in **cents**. Reward type is separated (`rewardType=monetary` by\ndefault) — point wallets are a different scale and must not be summed with\ncash. Test cards (`production=0`) are excluded. Canceled cards are counted\napart (`cardsCanceled`), never dropped silently. The day is cut in the\norganization timezone, so it lines up with the sales report by (month, store).\n\n`redeemed` is the settled redeemed value. With `cohort=redemption` (default)\nit is windowed by the **redemption date** — a card issued in July and redeemed\nin August shows its issuance in July and its redeemed value in August. With\n`cohort=issuance` it is the value redeemed, at any date, from the cards\n**issued** in the period (\"what happened to what I issued\").\n\n`groupBy=tier` breaks the numbers down by the member tier **at issuance** — a\nsnapshot taken on the card when it was created (the tier at purchase is\nimmutable). `tier=null` means the card had no tier (anonymous / unidentified, or\nissued before this snapshot shipped; history is not backfilled unless stated).\n\nStill not here: **channel** — group by `store` and join the store-group map\nclient-side."
                    },
                    "response": [
                        {
                            "name": "OK — with `groupBy=campaign&campaign=191&cohort=issuance`",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/cards/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "cards",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "Org-wide cashback aggregate — cards issued, credit distributed, redeemed,\nbalance and expired — broken down by month, day, campaign, campaign trigger or\nstore, in a **single call**. It is the campaign report, grouped: instead of\ncalling the per-campaign report once per campaign (an org can have hundreds),\nthis returns every campaign at once.\n\nThis is the **program dashboard / KPIs for cashback emission and redemption**:\nhow much was **issued, redeemed and expired per campaign** in the period. (For\nthe current spendable balance per wallet — available, used — use the reward\nbalances report instead; this one is the emission/redemption flow over time.)\n\nReconciles with `loyalty.campaign.report` by construction — same source, same\nmath: `rewardCard` for issuance/balance/cards, `rewardCard_flow` for the\nprecise redeemed value.\n\n**Conversion (usage of the cards).** A card counts as used when a sale that\nspent its balance was **settled** — partial or full use both count. Open\ncheckout reservations and canceled reservations do not. Card balance is never\nused for this: it also drops on reward reversals and manual debits.\n\n- `touchedCards` — cards issued in the period (not canceled) with any settled\n  redemption, at any date. `touchedRedeemed` — the value those same cards\n  redeemed, at any date (`redeemed` follows the redemption date instead).\n- `cardsRedeemedFull` / `cardsRedeemedPartial` — of those, the ones that spent\n  the whole credit / that still had balance left.\n- `usageRate` — **conversion rate**: `touchedCards / (cards − cardsCanceled)`,\n  in %. `partialShare` / `fullShare` — % of `touchedCards` (they add up to 100).\n- Status buckets that add up to `cards`: `cardsRedeemed` (card with **zero**\n  balance), `cardsExpired`, `cardsCanceled`, `cardsActive`. `cardsRedeemed` is\n  not the conversion: a reversal also zeroes a card.\n- `expiredBalance` — balance left on the expired cards: the credit lost\n  because it was not used in time (same cut as `cardsExpired`).\n\nA recent period is still maturing — its conversion keeps rising while the\ncards are valid. Compare with an older, closed period.\n\nValues are in **cents**. Reward type is separated (`rewardType=monetary` by\ndefault) — point wallets are a different scale and must not be summed with\ncash. Test cards (`production=0`) are excluded. Canceled cards are counted\napart (`cardsCanceled`), never dropped silently. The day is cut in the\norganization timezone, so it lines up with the sales report by (month, store).\n\n`redeemed` is the settled redeemed value. With `cohort=redemption` (default)\nit is windowed by the **redemption date** — a card issued in July and redeemed\nin August shows its issuance in July and its redeemed value in August. With\n`cohort=issuance` it is the value redeemed, at any date, from the cards\n**issued** in the period (\"what happened to what I issued\").\n\n`groupBy=tier` breaks the numbers down by the member tier **at issuance** — a\nsnapshot taken on the card when it was created (the tier at purchase is\nimmutable). `tier=null` means the card had no tier (anonymous / unidentified, or\nissued before this snapshot shipped; history is not backfilled unless stated).\n\nStill not here: **channel** — group by `store` and join the store-group map\nclient-side."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": {\n    \"unit\": \"cents\", \"timezone\": \"Etc/GMT+6\",\n    \"groupBy\": [\"campaign\"], \"rewardType\": \"monetary\",\n    \"cohort\": \"issuance\",\n    \"filters\": { \"campaign\": 191, \"store\": null }\n  },\n  \"rows\": [\n    { \"campaign\": 191, \"cards\": 6687, \"clients\": 5798, \"creditIssued\": 352339478,\n      \"redeemed\": 34095898, \"balance\": 0, \"expiredBalance\": 314870362, \"cardsRedeemed\": 280,\n      \"cardsExpired\": 6319, \"cardsCanceled\": 88, \"cardsActive\": 0,\n      \"touchedCards\": 696, \"touchedRedeemed\": 34095898, \"cardsRedeemedPartial\": 448, \"cardsRedeemedFull\": 248,\n      \"usageRate\": 10.5, \"partialShare\": 64.4, \"fullShare\": 35.6 }\n  ],\n  \"total\": {\n    \"clients\": 5798, \"cards\": 6687, \"creditIssued\": 352339478,\n    \"redeemed\": 34095898, \"balance\": 0, \"expiredBalance\": 314870362, \"cardsRedeemed\": 280,\n    \"cardsExpired\": 6319, \"cardsCanceled\": 88, \"cardsActive\": 0,\n    \"touchedCards\": 696, \"touchedRedeemed\": 34095898, \"cardsRedeemedPartial\": 448, \"cardsRedeemedFull\": 248,\n    \"usageRate\": 10.5, \"partialShare\": 64.4, \"fullShare\": 35.6\n  }\n}"
                        },
                        {
                            "name": "Invalid `groupBy`, `rewardType` or `cohort`, `month` combined with `day`, or `dateStart` after `dateEnd`.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/cards/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "cards",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "Org-wide cashback aggregate — cards issued, credit distributed, redeemed,\nbalance and expired — broken down by month, day, campaign, campaign trigger or\nstore, in a **single call**. It is the campaign report, grouped: instead of\ncalling the per-campaign report once per campaign (an org can have hundreds),\nthis returns every campaign at once.\n\nThis is the **program dashboard / KPIs for cashback emission and redemption**:\nhow much was **issued, redeemed and expired per campaign** in the period. (For\nthe current spendable balance per wallet — available, used — use the reward\nbalances report instead; this one is the emission/redemption flow over time.)\n\nReconciles with `loyalty.campaign.report` by construction — same source, same\nmath: `rewardCard` for issuance/balance/cards, `rewardCard_flow` for the\nprecise redeemed value.\n\n**Conversion (usage of the cards).** A card counts as used when a sale that\nspent its balance was **settled** — partial or full use both count. Open\ncheckout reservations and canceled reservations do not. Card balance is never\nused for this: it also drops on reward reversals and manual debits.\n\n- `touchedCards` — cards issued in the period (not canceled) with any settled\n  redemption, at any date. `touchedRedeemed` — the value those same cards\n  redeemed, at any date (`redeemed` follows the redemption date instead).\n- `cardsRedeemedFull` / `cardsRedeemedPartial` — of those, the ones that spent\n  the whole credit / that still had balance left.\n- `usageRate` — **conversion rate**: `touchedCards / (cards − cardsCanceled)`,\n  in %. `partialShare` / `fullShare` — % of `touchedCards` (they add up to 100).\n- Status buckets that add up to `cards`: `cardsRedeemed` (card with **zero**\n  balance), `cardsExpired`, `cardsCanceled`, `cardsActive`. `cardsRedeemed` is\n  not the conversion: a reversal also zeroes a card.\n- `expiredBalance` — balance left on the expired cards: the credit lost\n  because it was not used in time (same cut as `cardsExpired`).\n\nA recent period is still maturing — its conversion keeps rising while the\ncards are valid. Compare with an older, closed period.\n\nValues are in **cents**. Reward type is separated (`rewardType=monetary` by\ndefault) — point wallets are a different scale and must not be summed with\ncash. Test cards (`production=0`) are excluded. Canceled cards are counted\napart (`cardsCanceled`), never dropped silently. The day is cut in the\norganization timezone, so it lines up with the sales report by (month, store).\n\n`redeemed` is the settled redeemed value. With `cohort=redemption` (default)\nit is windowed by the **redemption date** — a card issued in July and redeemed\nin August shows its issuance in July and its redeemed value in August. With\n`cohort=issuance` it is the value redeemed, at any date, from the cards\n**issued** in the period (\"what happened to what I issued\").\n\n`groupBy=tier` breaks the numbers down by the member tier **at issuance** — a\nsnapshot taken on the card when it was created (the tier at purchase is\nimmutable). `tier=null` means the card had no tier (anonymous / unidentified, or\nissued before this snapshot shipped; history is not backfilled unless stated).\n\nStill not here: **channel** — group by `store` and join the store-group map\nclient-side."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "CashBack Card Expired",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/cashBackCardExpired/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "cashBackCardExpired",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "**Request body parameters**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| interface \\* | string | interface of sale |\n| storeId \\* | string |  |\n| client | array / int / null | In this field, you can enter an `id`(person ID, guper), leave it as `null` to represent an anonymous customer, or fill it with a complete customer's data, as shown in the example: `{\"id\": \"47\", \"name\": \"Trifólio Girassol\", \"`countryCallingCode\": 55 `\"cellphone\": \"19954264546\", \"email\": \"`[<code>trifolio@girassol.com</code>](https://)`\"};`  <br>For already registered customers, it is necessary to provide at least `id` or `cellphone`. To register a new customer, you need to include `id`, `cellphone`, and `name`. Our API is responsible for handling customer registration and retrieval efficiently using this information. |\n| attendants | array |  |\n| items \\* | array |  |\n| total_order | int | total order amount |\n| total_item | int | total value of items only |\n| total_shipping | int | total amount of shipping fee only |\n| total_discounts | int | total amount of discounts; _Cashback values ​​should not be passed in this field_ |"
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/cashBackCardExpired/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "cashBackCardExpired",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "**Request body parameters**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| interface \\* | string | interface of sale |\n| storeId \\* | string |  |\n| client | array / int / null | In this field, you can enter an `id`(person ID, guper), leave it as `null` to represent an anonymous customer, or fill it with a complete customer's data, as shown in the example: `{\"id\": \"47\", \"name\": \"Trifólio Girassol\", \"`countryCallingCode\": 55 `\"cellphone\": \"19954264546\", \"email\": \"`[<code>trifolio@girassol.com</code>](https://)`\"};`  <br>For already registered customers, it is necessary to provide at least `id` or `cellphone`. To register a new customer, you need to include `id`, `cellphone`, and `name`. Our API is responsible for handling customer registration and retrieval efficiently using this information. |\n| attendants | array |  |\n| items \\* | array |  |\n| total_order | int | total order amount |\n| total_item | int | total value of items only |\n| total_shipping | int | total amount of shipping fee only |\n| total_discounts | int | total amount of discounts; _Cashback values ​​should not be passed in this field_ |"
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "CashBack Card Flow",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/cashBackCardFlow/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "cashBackCardFlow",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "**Request body parameters**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| interface \\* | string | interface of sale |\n| storeId \\* | string |  |\n| client | array / int / null | In this field, you can enter an `id`(person ID, guper), leave it as `null` to represent an anonymous customer, or fill it with a complete customer's data, as shown in the example: `{\"id\": \"47\", \"name\": \"Trifólio Girassol\", \"`countryCallingCode\": 55 `\"cellphone\": \"19954264546\", \"email\": \"`[<code>trifolio@girassol.com</code>](https://)`\"};`  <br>For already registered customers, it is necessary to provide at least `id` or `cellphone`. To register a new customer, you need to include `id`, `cellphone`, and `name`. Our API is responsible for handling customer registration and retrieval efficiently using this information. |\n| attendants | array |  |\n| items \\* | array |  |\n| total_order | int | total order amount |\n| total_item | int | total value of items only |\n| total_shipping | int | total amount of shipping fee only |\n| total_discounts | int | total amount of discounts; _Cashback values ​​should not be passed in this field_ |"
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/cashBackCardFlow/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "cashBackCardFlow",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "**Request body parameters**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| interface \\* | string | interface of sale |\n| storeId \\* | string |  |\n| client | array / int / null | In this field, you can enter an `id`(person ID, guper), leave it as `null` to represent an anonymous customer, or fill it with a complete customer's data, as shown in the example: `{\"id\": \"47\", \"name\": \"Trifólio Girassol\", \"`countryCallingCode\": 55 `\"cellphone\": \"19954264546\", \"email\": \"`[<code>trifolio@girassol.com</code>](https://)`\"};`  <br>For already registered customers, it is necessary to provide at least `id` or `cellphone`. To register a new customer, you need to include `id`, `cellphone`, and `name`. Our API is responsible for handling customer registration and retrieval efficiently using this information. |\n| attendants | array |  |\n| items \\* | array |  |\n| total_order | int | total order amount |\n| total_item | int | total value of items only |\n| total_shipping | int | total amount of shipping fee only |\n| total_discounts | int | total amount of discounts; _Cashback values ​​should not be passed in this field_ |"
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Notification campaign funnel: people reached, who bought, and the conversion",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/notifications/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "notifications",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "The funnel of the campaigns that **only send a message**: how many people the\nmessage reached, and how many of them bought. It is the **denominator** no other\nreport has — `order.report.sales` says how much the message generated, not at\nwhat cost of reach.\n\nOnly campaigns with `type = notification`. That is the attribution rule, not a\nconvenience: a monetary or point campaign issues a reward card and is attributed\nby the **redemption** of that balance; the message it sends is a cashback notice,\nnot \"the message that brought the customer\". Without this cut, on 2026-08-14 one\norganization had 24,035 message attributions coming from monetary campaigns\nagainst 41 from notification campaigns — 99.8% of them undue.\n\n⚠️ **Two different dates, and the response keeps them apart** instead of folding\nthem into a single rate:\n\n- **`total`** is the **cohort**: messages *sent* inside the window\n  (`notificationCard.createdAt`), and how many of those have already converted,\n  on any date. Conversion only means something this way — numerator and\n  denominator are the same people. A recent window is immature: most of it is\n  still `open`, and its conversion keeps rising afterwards.\n- **`total.result`** is what *happened* inside the window (`attributionDate`):\n  the attributions and orders of the period. This is the block that lines up with\n  the influenced revenue of `order.report.sales`, which also filters by the sale\n  date.\n\nThe attribution window of each message is\n`COALESCE(expiresAt, attributionAt, createdAt + 30 days)`. ⚠️ `attributionAt` is\n**not** the date a purchase was attributed — it is written at the card's birth and\nis deprecated; counting conversion by it would always give 100%. Conversion lives\nonly in the attribution table.\n\nThe three buckets `converted` / `open` / `expired` are exclusive and add up to\n`sent`, so the screen can show where every message stands."
                    },
                    "response": [
                        {
                            "name": "OK — with `groupBy=campaign,day`",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/notifications/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "notifications",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "The funnel of the campaigns that **only send a message**: how many people the\nmessage reached, and how many of them bought. It is the **denominator** no other\nreport has — `order.report.sales` says how much the message generated, not at\nwhat cost of reach.\n\nOnly campaigns with `type = notification`. That is the attribution rule, not a\nconvenience: a monetary or point campaign issues a reward card and is attributed\nby the **redemption** of that balance; the message it sends is a cashback notice,\nnot \"the message that brought the customer\". Without this cut, on 2026-08-14 one\norganization had 24,035 message attributions coming from monetary campaigns\nagainst 41 from notification campaigns — 99.8% of them undue.\n\n⚠️ **Two different dates, and the response keeps them apart** instead of folding\nthem into a single rate:\n\n- **`total`** is the **cohort**: messages *sent* inside the window\n  (`notificationCard.createdAt`), and how many of those have already converted,\n  on any date. Conversion only means something this way — numerator and\n  denominator are the same people. A recent window is immature: most of it is\n  still `open`, and its conversion keeps rising afterwards.\n- **`total.result`** is what *happened* inside the window (`attributionDate`):\n  the attributions and orders of the period. This is the block that lines up with\n  the influenced revenue of `order.report.sales`, which also filters by the sale\n  date.\n\nThe attribution window of each message is\n`COALESCE(expiresAt, attributionAt, createdAt + 30 days)`. ⚠️ `attributionAt` is\n**not** the date a purchase was attributed — it is written at the card's birth and\nis deprecated; counting conversion by it would always give 100%. Conversion lives\nonly in the attribution table.\n\nThe three buckets `converted` / `open` / `expired` are exclusive and add up to\n`sent`, so the screen can show where every message stands."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": {\n    \"unit\": \"clients\",\n    \"timezone\": \"America/Sao_Paulo\",\n    \"window\": { \"start\": \"2026-09-01\", \"end\": \"2026-09-22\" },\n    \"groupBy\": [\"campaign\", \"day\"]\n  },\n  \"total\": {\n    \"sent\": 23964, \"clients\": 23694,\n    \"converted\": 124, \"convertedClients\": 124,\n    \"open\": 22889, \"expired\": 951,\n    \"conversionRate\": 0.0052,\n    \"result\": { \"attributions\": 139, \"orders\": 139, \"clients\": 124 }\n  },\n  \"byCampaign\": [\n    {\n      \"campaign\": 664, \"campaignName\": \"09-moda-producto-correo-septiembre-2026\",\n      \"sent\": 3948, \"clients\": 3948,\n      \"converted\": 13, \"convertedClients\": 13,\n      \"open\": 3800, \"expired\": 135, \"conversionRate\": 0.0033,\n      \"result\": { \"attributions\": 14, \"orders\": 14, \"clients\": 13 }\n    }\n  ],\n  \"byDay\": [\n    { \"day\": \"2026-09-01\", \"sent\": 1204, \"clients\": 1204, \"attributions\": 6, \"orders\": 6 }\n  ]\n}"
                        },
                        {
                            "name": "Invalid `groupBy`, a campaign id that is not a positive integer, or `dateStart` after `dateEnd`.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/notifications/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "notifications",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "The funnel of the campaigns that **only send a message**: how many people the\nmessage reached, and how many of them bought. It is the **denominator** no other\nreport has — `order.report.sales` says how much the message generated, not at\nwhat cost of reach.\n\nOnly campaigns with `type = notification`. That is the attribution rule, not a\nconvenience: a monetary or point campaign issues a reward card and is attributed\nby the **redemption** of that balance; the message it sends is a cashback notice,\nnot \"the message that brought the customer\". Without this cut, on 2026-08-14 one\norganization had 24,035 message attributions coming from monetary campaigns\nagainst 41 from notification campaigns — 99.8% of them undue.\n\n⚠️ **Two different dates, and the response keeps them apart** instead of folding\nthem into a single rate:\n\n- **`total`** is the **cohort**: messages *sent* inside the window\n  (`notificationCard.createdAt`), and how many of those have already converted,\n  on any date. Conversion only means something this way — numerator and\n  denominator are the same people. A recent window is immature: most of it is\n  still `open`, and its conversion keeps rising afterwards.\n- **`total.result`** is what *happened* inside the window (`attributionDate`):\n  the attributions and orders of the period. This is the block that lines up with\n  the influenced revenue of `order.report.sales`, which also filters by the sale\n  date.\n\nThe attribution window of each message is\n`COALESCE(expiresAt, attributionAt, createdAt + 30 days)`. ⚠️ `attributionAt` is\n**not** the date a purchase was attributed — it is written at the card's birth and\nis deprecated; counting conversion by it would always give 100%. Conversion lives\nonly in the attribution table.\n\nThe three buckets `converted` / `open` / `expired` are exclusive and add up to\n`sent`, so the screen can show where every message stands."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Cashback time-to-redeem report: days or weeks until the balance is used (distribution, median, p90)",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/redemption-latency/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "redemption-latency",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "Distribution of the **time until a cashback card is redeemed** — how many card\nuses happened on the first day, the second day, and so on (or per week). It is a\ndistribution, not an average: the average hides exactly what matters, which is\nthe concentration in the first days against the tail near expiry. `median` and\n`p90` come from the same distribution.\n\n`basis` says where the clock starts:\n\n- `available` (default): when the card became usable (`startsAt`, after the\n  campaign waiting period). Use it to tune the validity period.\n- `issued`: when the card was issued. Includes the waiting period.\n\nBuckets are **complete periods** (24 hours or 7 days) between the basis and the\ncheckout debit; bucket `0` is the first day/week. Only **settled** redemptions\ncount. The grain is the **card use**: a redemption that used two cards\ncontributes two latencies (`uses`); `redemptions` is the count of distinct\nredemptions in the bucket. `share` is `uses / total` (a ratio).\n\nSame filters as `loyalty.report.redemptions`: `cohort` (`redemption` = debits in\nthe period, default; `issuance` = cards issued in the period), `campaign` (list),\n`originStore`, `redeemStore`. Values in **cents**."
                    },
                    "response": [
                        {
                            "name": "OK — `cohort=issuance` (excerpt)",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/redemption-latency/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "redemption-latency",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "Distribution of the **time until a cashback card is redeemed** — how many card\nuses happened on the first day, the second day, and so on (or per week). It is a\ndistribution, not an average: the average hides exactly what matters, which is\nthe concentration in the first days against the tail near expiry. `median` and\n`p90` come from the same distribution.\n\n`basis` says where the clock starts:\n\n- `available` (default): when the card became usable (`startsAt`, after the\n  campaign waiting period). Use it to tune the validity period.\n- `issued`: when the card was issued. Includes the waiting period.\n\nBuckets are **complete periods** (24 hours or 7 days) between the basis and the\ncheckout debit; bucket `0` is the first day/week. Only **settled** redemptions\ncount. The grain is the **card use**: a redemption that used two cards\ncontributes two latencies (`uses`); `redemptions` is the count of distinct\nredemptions in the bucket. `share` is `uses / total` (a ratio).\n\nSame filters as `loyalty.report.redemptions`: `cohort` (`redemption` = debits in\nthe period, default; `issuance` = cards issued in the period), `campaign` (list),\n`originStore`, `redeemStore`. Values in **cents**."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": { \"unit\": \"days\", \"basis\": \"cardAvailableAt\", \"cohort\": \"issuance\", \"timezone\": \"Etc/GMT+6\" },\n  \"total\": 767,\n  \"median\": 2,\n  \"p90\": 8,\n  \"rows\": [\n    { \"bucket\": 0, \"uses\": 172, \"redemptions\": 166, \"redeemedValue\": 7788667, \"share\": 0.2243 },\n    { \"bucket\": 1, \"uses\": 121, \"redemptions\": 117, \"redeemedValue\": 4434159, \"share\": 0.1578 },\n    { \"bucket\": 2, \"uses\": 100, \"redemptions\": 100, \"redeemedValue\": 3856692, \"share\": 0.1304 }\n  ]\n}"
                        },
                        {
                            "name": "Invalid `buckets`, `basis`, `cohort` or `rewardType`, a non-integer filter, or `dateStart` after `dateEnd`.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/redemption-latency/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "redemption-latency",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "Distribution of the **time until a cashback card is redeemed** — how many card\nuses happened on the first day, the second day, and so on (or per week). It is a\ndistribution, not an average: the average hides exactly what matters, which is\nthe concentration in the first days against the tail near expiry. `median` and\n`p90` come from the same distribution.\n\n`basis` says where the clock starts:\n\n- `available` (default): when the card became usable (`startsAt`, after the\n  campaign waiting period). Use it to tune the validity period.\n- `issued`: when the card was issued. Includes the waiting period.\n\nBuckets are **complete periods** (24 hours or 7 days) between the basis and the\ncheckout debit; bucket `0` is the first day/week. Only **settled** redemptions\ncount. The grain is the **card use**: a redemption that used two cards\ncontributes two latencies (`uses`); `redemptions` is the count of distinct\nredemptions in the bucket. `share` is `uses / total` (a ratio).\n\nSame filters as `loyalty.report.redemptions`: `cohort` (`redemption` = debits in\nthe period, default; `issuance` = cards issued in the period), `campaign` (list),\n`originStore`, `redeemStore`. Values in **cents**."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Cashback redemptions report: which orders redeemed, per campaign, origin store vs redemption store (circulation)",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/redemptions/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "redemptions",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "**Settled** cashback redemptions — one row per (redemption, card) — with the\norder that used the balance, the store that **issued** the card and the store\nwhere it was **redeemed**. Paginated. Pass `groupBy` to get aggregates instead\n(by day, month, campaign, origin store and/or redemption store).\n\nUse it for the detail table of redemptions, to answer \"which orders used the\ncashback of campaign X\", and for **balance circulation between stores**\n(`groupBy=originStore,redeemStore`: where the balance was generated vs where it\nwas spent).\n\n**Grain: the card.** An order that used three cards shows up three times, so\nthere is **no order total** here on purpose — summing a ticket over these rows\ncounts the same order several times. For revenue per order use\n`order.report.sales` (with attribution) or `order.campaign.report`.\n\nA redemption counts only once the sale is **settled**. Open checkout\nreservations and canceled reservations are left out. `redeemedValue` is the\ndebit minus any partial reversal of that same redemption, on that card.\n\n`cohort=redemption` (default): debits (checkout) dated in the period, from\ncards of any date. `cohort=issuance`: cards issued in the period, redeemed at\nany date. Values are in **cents**; dates are in the organization timezone.\nTest cards (`production=0`) are excluded; `rewardType` defaults to `monetary`.\n\nIn aggregates, `redemptions` (distinct redemptions), `cards` (distinct cards)\nand `orders` (distinct orders) are different counts — none of them is a\ndenominator for the others."
                    },
                    "response": [
                        {
                            "name": "OK — list (`campaign=191&cohort=issuance&entries=1`)",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/redemptions/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "redemptions",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "**Settled** cashback redemptions — one row per (redemption, card) — with the\norder that used the balance, the store that **issued** the card and the store\nwhere it was **redeemed**. Paginated. Pass `groupBy` to get aggregates instead\n(by day, month, campaign, origin store and/or redemption store).\n\nUse it for the detail table of redemptions, to answer \"which orders used the\ncashback of campaign X\", and for **balance circulation between stores**\n(`groupBy=originStore,redeemStore`: where the balance was generated vs where it\nwas spent).\n\n**Grain: the card.** An order that used three cards shows up three times, so\nthere is **no order total** here on purpose — summing a ticket over these rows\ncounts the same order several times. For revenue per order use\n`order.report.sales` (with attribution) or `order.campaign.report`.\n\nA redemption counts only once the sale is **settled**. Open checkout\nreservations and canceled reservations are left out. `redeemedValue` is the\ndebit minus any partial reversal of that same redemption, on that card.\n\n`cohort=redemption` (default): debits (checkout) dated in the period, from\ncards of any date. `cohort=issuance`: cards issued in the period, redeemed at\nany date. Values are in **cents**; dates are in the organization timezone.\nTest cards (`production=0`) are excluded; `rewardType` defaults to `monetary`.\n\nIn aggregates, `redemptions` (distinct redemptions), `cards` (distinct cards)\nand `orders` (distinct orders) are different counts — none of them is a\ndenominator for the others."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": { \"unit\": \"cents\", \"timezone\": \"Etc/GMT+6\", \"cohort\": \"issuance\", \"groupBy\": null },\n  \"total\": { \"rows\": 757, \"redemptions\": 694, \"orders\": 694, \"redeemedValue\": 34095898 },\n  \"page\": 1, \"entries\": 1, \"pages\": 757,\n  \"list\": [\n    { \"tid\": \"f19f97178e926abacd584819d8e83e954b5254c4c6b12aea23c02670d21eb9e3\",\n      \"cardId\": 334708, \"campaign\": 191, \"clientId\": 2461453,\n      \"originStore\": 1629, \"redeemStore\": 1629, \"orderId\": 3940209,\n      \"redeemedValue\": 147400, \"redeemedAt\": \"2025-10-04 15:26:23\",\n      \"settledAt\": \"2026-08-27 16:42:03\", \"cardCreatedAt\": \"2025-08-17 16:48:09\" }\n  ]\n}"
                        },
                        {
                            "name": "OK — aggregate (`groupBy=campaign&campaign=191&cohort=issuance`)",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/redemptions/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "redemptions",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "**Settled** cashback redemptions — one row per (redemption, card) — with the\norder that used the balance, the store that **issued** the card and the store\nwhere it was **redeemed**. Paginated. Pass `groupBy` to get aggregates instead\n(by day, month, campaign, origin store and/or redemption store).\n\nUse it for the detail table of redemptions, to answer \"which orders used the\ncashback of campaign X\", and for **balance circulation between stores**\n(`groupBy=originStore,redeemStore`: where the balance was generated vs where it\nwas spent).\n\n**Grain: the card.** An order that used three cards shows up three times, so\nthere is **no order total** here on purpose — summing a ticket over these rows\ncounts the same order several times. For revenue per order use\n`order.report.sales` (with attribution) or `order.campaign.report`.\n\nA redemption counts only once the sale is **settled**. Open checkout\nreservations and canceled reservations are left out. `redeemedValue` is the\ndebit minus any partial reversal of that same redemption, on that card.\n\n`cohort=redemption` (default): debits (checkout) dated in the period, from\ncards of any date. `cohort=issuance`: cards issued in the period, redeemed at\nany date. Values are in **cents**; dates are in the organization timezone.\nTest cards (`production=0`) are excluded; `rewardType` defaults to `monetary`.\n\nIn aggregates, `redemptions` (distinct redemptions), `cards` (distinct cards)\nand `orders` (distinct orders) are different counts — none of them is a\ndenominator for the others."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": { \"unit\": \"cents\", \"cohort\": \"issuance\", \"groupBy\": [\"campaign\"] },\n  \"rows\": [\n    { \"campaign\": 191, \"redemptions\": 694, \"cards\": 700, \"orders\": 694, \"clients\": 618, \"redeemedValue\": 34095898 }\n  ],\n  \"total\": { \"campaign\": null, \"redemptions\": 694, \"cards\": 700, \"orders\": 694, \"clients\": 618, \"redeemedValue\": 34095898 }\n}"
                        },
                        {
                            "name": "Invalid `groupBy`, `cohort` or `rewardType`, a non-integer filter, `day` combined with `month`, or `dateStart` after `dateEnd`.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/redemptions/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "redemptions",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "**Settled** cashback redemptions — one row per (redemption, card) — with the\norder that used the balance, the store that **issued** the card and the store\nwhere it was **redeemed**. Paginated. Pass `groupBy` to get aggregates instead\n(by day, month, campaign, origin store and/or redemption store).\n\nUse it for the detail table of redemptions, to answer \"which orders used the\ncashback of campaign X\", and for **balance circulation between stores**\n(`groupBy=originStore,redeemStore`: where the balance was generated vs where it\nwas spent).\n\n**Grain: the card.** An order that used three cards shows up three times, so\nthere is **no order total** here on purpose — summing a ticket over these rows\ncounts the same order several times. For revenue per order use\n`order.report.sales` (with attribution) or `order.campaign.report`.\n\nA redemption counts only once the sale is **settled**. Open checkout\nreservations and canceled reservations are left out. `redeemedValue` is the\ndebit minus any partial reversal of that same redemption, on that card.\n\n`cohort=redemption` (default): debits (checkout) dated in the period, from\ncards of any date. `cohort=issuance`: cards issued in the period, redeemed at\nany date. Values are in **cents**; dates are in the organization timezone.\nTest cards (`production=0`) are excluded; `rewardType` defaults to `monetary`.\n\nIn aggregates, `redemptions` (distinct redemptions), `cards` (distinct cards)\nand `orders` (distinct orders) are different counts — none of them is a\ndenominator for the others."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Reward Balances",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/rewardBalances/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "rewardBalances",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "Returns the **organization-wide loyalty balances** aggregated over a date window. Cards are filtered by their **creation date** (`createAt`) between `dateStart` and `dateEnd`.\n\nThis is a `GET` and takes **no request body**. Both dates are required path params (`YYYY-MM-DD`).\n\n> To read the **current balance of a single customer**, use [Reward Balances By Person](/api-reference/loyalty/report/reward-balances-by-person) instead — it sums all of the customer's cards with no date window.\n\n> Monetary wallets return values in **cents** (divide by 100 to get the amount in the org currency). Point wallets (`rewardType: point`) return the point quantity.\n\n**Response fields**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `total` | int | Everything credited on cards created in the window (sum of all credits) |\n| `available` | int | Balance still available to redeem (cards not expired and not canceled) |\n| `expired` | int | Balance that expired without being redeemed |\n| `canceled` | int | Balance on canceled cards |\n| `used` | int | Balance already redeemed |\n| `byWallet` | object | Same metrics broken down per wallet (policy), keyed by wallet id |\n| `byWallet[id].name` | string | Wallet name |\n| `byWallet[id].rewardType` | string | `monetary` or `point` |"
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/rewardBalances/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "rewardBalances",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "Returns the **organization-wide loyalty balances** aggregated over a date window. Cards are filtered by their **creation date** (`createAt`) between `dateStart` and `dateEnd`.\n\nThis is a `GET` and takes **no request body**. Both dates are required path params (`YYYY-MM-DD`).\n\n> To read the **current balance of a single customer**, use [Reward Balances By Person](/api-reference/loyalty/report/reward-balances-by-person) instead — it sums all of the customer's cards with no date window.\n\n> Monetary wallets return values in **cents** (divide by 100 to get the amount in the org currency). Point wallets (`rewardType: point`) return the point quantity.\n\n**Response fields**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `total` | int | Everything credited on cards created in the window (sum of all credits) |\n| `available` | int | Balance still available to redeem (cards not expired and not canceled) |\n| `expired` | int | Balance that expired without being redeemed |\n| `canceled` | int | Balance on canceled cards |\n| `used` | int | Balance already redeemed |\n| `byWallet` | object | Same metrics broken down per wallet (policy), keyed by wallet id |\n| `byWallet[id].name` | string | Wallet name |\n| `byWallet[id].rewardType` | string | `monetary` or `point` |"
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"total\": 1284500,\n    \"available\": 642100,\n    \"expired\": 310200,\n    \"canceled\": 12000,\n    \"used\": 320200,\n    \"byWallet\": {\n        \"12\": {\n            \"name\": \"Cashback\",\n            \"rewardType\": \"monetary\",\n            \"total\": 1284500,\n            \"available\": 642100,\n            \"expired\": 310200,\n            \"canceled\": 12000,\n            \"used\": 320200\n        }\n    }\n}"
                        }
                    ]
                },
                {
                    "name": "Reward Balances By Person",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/report/rewardBalances/person/{{person}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "report",
                                "rewardBalances",
                                "person",
                                "{{person}}"
                            ]
                        },
                        "description": "Returns the **consolidated loyalty balance of a single customer**, summing **all of the customer's cards** with **no date window**. This is the canonical endpoint to read a customer's current balance — use the **`available`** field as the amount ready to redeem.\n\nThis is a `GET` and takes **no request body**. The only input is the `person` (customer) id in the path.\n\n> Monetary wallets return values in **cents** (divide by 100 to get the amount in the org currency). Point wallets (`rewardType: point`) return the point quantity.\n\n**Response fields**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `total` | int | Everything ever credited to the customer (sum of all credits, historical) |\n| `available` | int | **Balance available to redeem right now** (cards not expired and not canceled) |\n| `expired` | int | Balance that expired without being redeemed |\n| `canceled` | int | Balance on canceled cards |\n| `used` | int | Balance already redeemed |\n| `byWallet` | object | Same metrics broken down per wallet (policy), keyed by wallet id |\n| `byWallet[id].name` | string | Wallet name |\n| `byWallet[id].rewardType` | string | `monetary` or `point` |"
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/report/rewardBalances/person/{{person}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "report",
                                        "rewardBalances",
                                        "person",
                                        "{{person}}"
                                    ]
                                },
                                "description": "Returns the **consolidated loyalty balance of a single customer**, summing **all of the customer's cards** with **no date window**. This is the canonical endpoint to read a customer's current balance — use the **`available`** field as the amount ready to redeem.\n\nThis is a `GET` and takes **no request body**. The only input is the `person` (customer) id in the path.\n\n> Monetary wallets return values in **cents** (divide by 100 to get the amount in the org currency). Point wallets (`rewardType: point`) return the point quantity.\n\n**Response fields**\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `total` | int | Everything ever credited to the customer (sum of all credits, historical) |\n| `available` | int | **Balance available to redeem right now** (cards not expired and not canceled) |\n| `expired` | int | Balance that expired without being redeemed |\n| `canceled` | int | Balance on canceled cards |\n| `used` | int | Balance already redeemed |\n| `byWallet` | object | Same metrics broken down per wallet (policy), keyed by wallet id |\n| `byWallet[id].name` | string | Wallet name |\n| `byWallet[id].rewardType` | string | `monetary` or `point` |"
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"total\": 306943,\n    \"available\": 111541,\n    \"expired\": 88938,\n    \"canceled\": 0,\n    \"used\": 106464,\n    \"byWallet\": {\n        \"12\": {\n            \"name\": \"Cashback\",\n            \"rewardType\": \"monetary\",\n            \"total\": 306943,\n            \"available\": 111541,\n            \"expired\": 88938,\n            \"canceled\": 0,\n            \"used\": 106464\n        }\n    }\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Reward",
            "item": [
                {
                    "name": "Direct",
                    "item": [
                        {
                            "name": "Reward Direct: Consume",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/reward",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "reward"
                                    ]
                                },
                                "description": "Debits points from a customer's reward balance against an order\npayload. Computes the value as `total_item / pointsDivisor *\npointsDividend` against the resolved policy, then executes the\nredeem on the matching cards (FIFO by expiration).\n\nReturns the cards that were touched plus the actual debited value.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": 47,\n    \"value\": 96390\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Debited",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/reward",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "reward"
                                            ]
                                        },
                                        "description": "Debits points from a customer's reward balance against an order\npayload. Computes the value as `total_item / pointsDivisor *\npointsDividend` against the resolved policy, then executes the\nredeem on the matching cards (FIFO by expiration).\n\nReturns the cards that were touched plus the actual debited value.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": 47,\n    \"value\": 96390\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "Missing fields",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/reward",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "reward"
                                            ]
                                        },
                                        "description": "Debits points from a customer's reward balance against an order\npayload. Computes the value as `total_item / pointsDivisor *\npointsDividend` against the resolved policy, then executes the\nredeem on the matching cards (FIFO by expiration).\n\nReturns the cards that were touched plus the actual debited value.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": 47,\n    \"value\": 96390\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Reward Direct: Create",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/reward",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "reward"
                                    ]
                                },
                                "description": "Manually issues a reward card to a customer, bypassing the order/engine\nflow. Common use cases: support credits, marketing one-offs, manual\nreconciliation.\n\nLinked to a **policy** so the card inherits the policy's expiration\nrules and aggregation mode.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"policy\": 1,\n    \"client\": 47,\n    \"value\": 5000,\n    \"expiresAt\": \"2026-12-31\",\n    \"startsAt\": \"2026-05-04\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Card created",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/reward",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "reward"
                                            ]
                                        },
                                        "description": "Manually issues a reward card to a customer, bypassing the order/engine\nflow. Common use cases: support credits, marketing one-offs, manual\nreconciliation.\n\nLinked to a **policy** so the card inherits the policy's expiration\nrules and aggregation mode.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"policy\": 1,\n    \"client\": 47,\n    \"value\": 5000,\n    \"expiresAt\": \"2026-12-31\",\n    \"startsAt\": \"2026-05-04\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"cardId\": 9182, \"policy\": 1, \"client\": 47, \"value\": 5000, \"expiresAt\": \"2026-12-31T23:59:59-03:00\" }"
                                },
                                {
                                    "name": "Missing/invalid fields or unknown policy",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/loyalty/reward",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "loyalty",
                                                "reward"
                                            ]
                                        },
                                        "description": "Manually issues a reward card to a customer, bypassing the order/engine\nflow. Common use cases: support credits, marketing one-offs, manual\nreconciliation.\n\nLinked to a **policy** so the card inherits the policy's expiration\nrules and aggregation mode.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"policy\": 1,\n    \"client\": 47,\n    \"value\": 5000,\n    \"expiresAt\": \"2026-12-31\",\n    \"startsAt\": \"2026-05-04\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Reward: Find by hash",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/reward/{{hash}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "reward",
                                "{{hash}}"
                            ]
                        },
                        "description": "Returns the reward promise associated with a given `hash`/`confirmToken`\n— the response that was originally produced by [Search](/docs/{lang}/api-reference/loyalty/reward/search)\nor [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order).\n\nUseful for resyncing the integration's local state when the cached\nresponse has been lost or expired."
                    },
                    "response": [
                        {
                            "name": "Stored response payload",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/reward/{{hash}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "reward",
                                        "{{hash}}"
                                    ]
                                },
                                "description": "Returns the reward promise associated with a given `hash`/`confirmToken`\n— the response that was originally produced by [Search](/docs/{lang}/api-reference/loyalty/reward/search)\nor [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order).\n\nUseful for resyncing the integration's local state when the cached\nresponse has been lost or expired."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Hash not found / expired",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/reward/{{hash}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "reward",
                                        "{{hash}}"
                                    ]
                                },
                                "description": "Returns the reward promise associated with a given `hash`/`confirmToken`\n— the response that was originally produced by [Search](/docs/{lang}/api-reference/loyalty/reward/search)\nor [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order).\n\nUseful for resyncing the integration's local state when the cached\nresponse has been lost or expired."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Reward: Search",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/reward/search",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "reward",
                                "search"
                            ]
                        },
                        "description": "Calculates the reward (cashback / promotion / points) an order would\nreceive — same engine as [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)\nbut exposed as a standalone search endpoint. Returns a `hash`/`confirmToken`\nyou can later send to redeem/settle.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": {\n        \"id\": 47,\n        \"refId\": \"3143c4fb\",\n        \"name\": \"Trifólio Girassol\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"trifolio@girassol.com\",\n        \"document\": \"<document>\"\n    },\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"quantity\": 1,\n            \"price\": 96390,\n            \"listPrice\": 100000,\n            \"categoryId\": \"<categoryId>\",\n            \"brandId\": \"<brandId>\",\n            \"tax\": 0\n        }\n    ],\n    \"total_order\": 97390,\n    \"total_item\": 96390,\n    \"total_shipping\": 2000,\n    \"total_discounts\": 1000\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Reward computed (with hash)",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/reward/search",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "reward",
                                        "search"
                                    ]
                                },
                                "description": "Calculates the reward (cashback / promotion / points) an order would\nreceive — same engine as [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)\nbut exposed as a standalone search endpoint. Returns a `hash`/`confirmToken`\nyou can later send to redeem/settle.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": {\n        \"id\": 47,\n        \"refId\": \"3143c4fb\",\n        \"name\": \"Trifólio Girassol\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"trifolio@girassol.com\",\n        \"document\": \"<document>\"\n    },\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"quantity\": 1,\n            \"price\": 96390,\n            \"listPrice\": 100000,\n            \"categoryId\": \"<categoryId>\",\n            \"brandId\": \"<brandId>\",\n            \"tax\": 0\n        }\n    ],\n    \"total_order\": 97390,\n    \"total_item\": 96390,\n    \"total_shipping\": 2000,\n    \"total_discounts\": 1000\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Interface not defined",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/reward/search",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "reward",
                                        "search"
                                    ]
                                },
                                "description": "Calculates the reward (cashback / promotion / points) an order would\nreceive — same engine as [Reward by Order](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)\nbut exposed as a standalone search endpoint. Returns a `hash`/`confirmToken`\nyou can later send to redeem/settle.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"interface\": \"generic\",\n    \"storeId\": \"1\",\n    \"client\": {\n        \"id\": 47,\n        \"refId\": \"3143c4fb\",\n        \"name\": \"Trifólio Girassol\",\n        \"countryCallingCode\": 55,\n        \"cellphone\": \"19954264546\",\n        \"email\": \"trifolio@girassol.com\",\n        \"document\": \"<document>\"\n    },\n    \"items\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Smartphone Guper MK1\",\n            \"quantity\": 1,\n            \"price\": 96390,\n            \"listPrice\": 100000,\n            \"categoryId\": \"<categoryId>\",\n            \"brandId\": \"<brandId>\",\n            \"tax\": 0\n        }\n    ],\n    \"total_order\": 97390,\n    \"total_item\": 96390,\n    \"total_shipping\": 2000,\n    \"total_discounts\": 1000\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Rules",
            "item": [
                {
                    "name": "List",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/rule",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "rule"
                            ]
                        },
                        "description": "Returns the paginated list of loyalty rules."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/rule",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "rule"
                                    ]
                                },
                                "description": "Returns the paginated list of loyalty rules."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        {\n            \"id\": 1,\n            \"name\": \"Compra de valor\",\n            \"class\": \"Rule\",\n            \"method\": \"value\",\n            \"priority\": 100\n        },\n        {\n            \"id\": 2,\n            \"name\": \"Produto da categoria\",\n            \"class\": \"Rule\",\n            \"method\": \"categoryItems\",\n            \"priority\": 0\n        },\n        {\n            \"id\": 3,\n            \"name\": \"Quantidade\",\n            \"class\": \"Rule\",\n            \"method\": \"quantityItems\",\n            \"priority\": 100\n        },\n        {\n            \"id\": 4,\n            \"name\": \"Produto da marca\",\n            \"class\": \"Rule\",\n            \"method\": \"brandProduct\",\n            \"priority\": 0\n        }\n    ],\n    \"total\": 4,\n    \"pagination\": {\n        \"entries\": 20,\n        \"totalPages\": 1,\n        \"currentPage\": 1,\n        \"isInitial\": true,\n        \"isEnd\": true,\n        \"totalPrevPages\": 0,\n        \"totalNextPages\": 0\n    }\n}"
                        }
                    ]
                },
                {
                    "name": "Get",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/rule/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "rule",
                                "{{id}}"
                            ]
                        },
                        "description": "Returns a single the rule matching the given identifier."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/rule/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "rule",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single the rule matching the given identifier."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 1,\n    \"name\": \"Compra de valor\",\n    \"class\": \"Rule\",\n    \"method\": \"value\",\n    \"priority\": 100\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Transaction",
            "item": [
                {
                    "name": "By Order — By Order ID",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/byOrder/{{idOrder}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "transaction",
                                "byOrder",
                                "{{idOrder}}"
                            ]
                        },
                        "description": "Looks up transactions directly by Guper's internal `orderId`."
                    },
                    "response": [
                        {
                            "name": "List of transactions tied to the order",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/byOrder/{{idOrder}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "transaction",
                                        "byOrder",
                                        "{{idOrder}}"
                                    ]
                                },
                                "description": "Looks up transactions directly by Guper's internal `orderId`."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"order\": 2467383,\n    \"transactions\": [\n        {\n            \"TID\":        \"dcf33b4448d604033d12ce176253ee54851531212b29bde1468d359e82005b92\",\n            \"person\":     570971,\n            \"canceledAt\": null,\n            \"createdAt\":  \"2026-01-15T16:21:44-03:00\"\n        },\n        {\n            \"TID\":        \"8c91a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1\",\n            \"person\":     570971,\n            \"canceledAt\": \"2026-01-20T09:14:00-03:00\",\n            \"createdAt\":  \"2026-01-15T17:02:11-03:00\"\n        }\n    ]\n}"
                        },
                        {
                            "name": "Missing order parameter",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/byOrder/{{idOrder}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "transaction",
                                        "byOrder",
                                        "{{idOrder}}"
                                    ]
                                },
                                "description": "Looks up transactions directly by Guper's internal `orderId`."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "No transaction found for this order",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/byOrder/{{idOrder}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "transaction",
                                        "byOrder",
                                        "{{idOrder}}"
                                    ]
                                },
                                "description": "Looks up transactions directly by Guper's internal `orderId`."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "By Order — By RefId",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/{{interface}}/transaction/byOrder/{{idOrRefId}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "{{interface}}",
                                "transaction",
                                "byOrder",
                                "{{idOrRefId}}"
                            ]
                        },
                        "description": "Accepts an external reference id. The order service resolves\n`interface` + `refId` to the internal `orderId` before the\nlookup. The response echoes the resolved `refId` and `interface`."
                    },
                    "response": [
                        {
                            "name": "List of transactions tied to the order",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/{{interface}}/transaction/byOrder/{{idOrRefId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "{{interface}}",
                                        "transaction",
                                        "byOrder",
                                        "{{idOrRefId}}"
                                    ]
                                },
                                "description": "Accepts an external reference id. The order service resolves\n`interface` + `refId` to the internal `orderId` before the\nlookup. The response echoes the resolved `refId` and `interface`."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"order\":     2467383,\n    \"refId\":     \"GUP-847\",\n    \"interface\": \"vtex\",\n    \"transactions\": [\n        {\n            \"TID\":        \"a411612a868befe17a8fde6076e25d8e0ea4c651dcaa88a24f97417627ad6d07\",\n            \"person\":     570971,\n            \"canceledAt\": null,\n            \"createdAt\":  \"2026-01-15T16:21:44-03:00\"\n        }\n    ]\n}"
                        },
                        {
                            "name": "Missing order parameter",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/{{interface}}/transaction/byOrder/{{idOrRefId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "{{interface}}",
                                        "transaction",
                                        "byOrder",
                                        "{{idOrRefId}}"
                                    ]
                                },
                                "description": "Accepts an external reference id. The order service resolves\n`interface` + `refId` to the internal `orderId` before the\nlookup. The response echoes the resolved `refId` and `interface`."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Order or transaction not found",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/{{interface}}/transaction/byOrder/{{idOrRefId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "{{interface}}",
                                        "transaction",
                                        "byOrder",
                                        "{{idOrRefId}}"
                                    ]
                                },
                                "description": "Accepts an external reference id. The order service resolves\n`interface` + `refId` to the internal `orderId` before the\nlookup. The response echoes the resolved `refId` and `interface`."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Cancel",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/cancel/{{TID}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "transaction",
                                "cancel",
                                "{{TID}}"
                            ]
                        },
                        "description": "Cancels the the transaction."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/cancel/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "transaction",
                                        "cancel",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Cancels the the transaction."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"TID\": \"5876f434afea2e0aafeed9bcc0adfd625b52e301fb9c1b5f437f2b819fa541e4\",\n    \"order\": 1898583,\n    \"reward\": [\n        {\n            \"cardId\": 95980,\n            \"value\": 5\n        }\n    ],\n    \"redemption\": [\n        {\n            \"cardId\": 74744,\n            \"value\": 50\n        }\n    ]\n}"
                        }
                    ]
                },
                {
                    "name": "Get",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/{{TID}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "loyalty",
                                "transaction",
                                "{{TID}}"
                            ]
                        },
                        "description": "Returns a single the transaction matching the given identifier."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper. Omit only on endpoints that explicitly support a Public mode."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/loyalty/transaction/{{TID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "loyalty",
                                        "transaction",
                                        "{{TID}}"
                                    ]
                                },
                                "description": "Returns a single the transaction matching the given identifier."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"TID\": \"dcf33b4448d604033d12ce176253ee54851531212b29bde1468d359e82005b92\",\n    \"order\": 2467383,\n    \"reward\": [\n        {\n            \"cardId\": 185840,\n            \"value\": 0\n        }\n    ],\n    \"redemption\": [\n        {\n            \"cardId\": 185839,\n            \"value\": 1099\n        }\n    ]\n}"
                        }
                    ]
                }
            ]
        }
    ],
    "variable": [
        {
            "key": "scheme",
            "value": "https",
            "type": "string"
        },
        {
            "key": "organization",
            "value": "acme",
            "type": "string"
        },
        {
            "key": "TID",
            "value": "tx_demo_a1b2c3d4",
            "type": "string"
        },
        {
            "key": "confirmToken",
            "value": "54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49",
            "type": "string"
        },
        {
            "key": "hash",
            "value": "h_demo_abc123def456",
            "type": "string"
        },
        {
            "key": "id",
            "value": "42",
            "type": "string"
        },
        {
            "key": "personId",
            "value": "1234",
            "type": "string"
        },
        {
            "key": "couponCode",
            "value": "DEMO20",
            "type": "string"
        },
        {
            "key": "transactionId",
            "value": "tx_demo_a1b2c3d4",
            "type": "string"
        },
        {
            "key": "dateStart",
            "value": "2024-04-01",
            "type": "string"
        },
        {
            "key": "dateEnd",
            "value": "2024-04-30",
            "type": "string"
        },
        {
            "key": "x-guper-authorization",
            "value": "48c70a3d6bc1d15104abfaee80c6010f348713f5315bfd12028c2455667685a2",
            "type": "string"
        },
        {
            "key": "Content-Type",
            "value": "application/json",
            "type": "string"
        },
        {
            "key": "User-Agent",
            "value": "guper-docs/2.x",
            "type": "string"
        },
        {
            "key": "environment",
            "value": "",
            "type": "string"
        }
    ]
}