{
    "info": {
        "_postman_id": "969b4c55-0b79-436a-bc5e-2636880aff0a",
        "name": "Guper · Integration",
        "description": "Guper Integration API reference. Generated from the documentation portal.",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "item": [
        {
            "name": "Interface",
            "item": [
                {
                    "name": "By field",
                    "item": [
                        {
                            "name": "Read interface by slug",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface/by/slug/{{slug}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface",
                                        "by",
                                        "slug",
                                        "{{slug}}"
                                    ]
                                },
                                "description": "Returns the interface matching `(organization, slug)`. **Hot path** consumed by `loyalty.Services\\Middleware\\Interfaces\\Finding` on every `reward/search` — handle with care."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "signature",
                                                "value": "{{signature}}",
                                                "type": "text",
                                                "description": "RSA signature `account.service.token` validated against the org public key."
                                            },
                                            {
                                                "key": "User-Agent",
                                                "value": "{{User-Agent}}",
                                                "type": "text",
                                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                            },
                                            {
                                                "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/integration/interface/by/slug/{{slug}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "integration",
                                                "interface",
                                                "by",
                                                "slug",
                                                "{{slug}}"
                                            ]
                                        },
                                        "description": "Returns the interface matching `(organization, slug)`. **Hot path** consumed by `loyalty.Services\\Middleware\\Interfaces\\Finding` on every `reward/search` — handle with care."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\": 41, \"organization\": \"xpto\", \"slug\": \"ecommerce\", \"name\": \"E-commerce\", \"source\": \"vtex\", \"activated\": \"2026-01-15T10:00:00+00:00\"}"
                                },
                                {
                                    "name": "Not Found",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "signature",
                                                "value": "{{signature}}",
                                                "type": "text",
                                                "description": "RSA signature `account.service.token` validated against the org public key."
                                            },
                                            {
                                                "key": "User-Agent",
                                                "value": "{{User-Agent}}",
                                                "type": "text",
                                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                            },
                                            {
                                                "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/integration/interface/by/slug/{{slug}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "integration",
                                                "interface",
                                                "by",
                                                "slug",
                                                "{{slug}}"
                                            ]
                                        },
                                        "description": "Returns the interface matching `(organization, slug)`. **Hot path** consumed by `loyalty.Services\\Middleware\\Interfaces\\Finding` on every `reward/search` — handle with care."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"error\": \"Integration [ecommerce] not found\"}"
                                }
                            ]
                        },
                        {
                            "name": "List interfaces by source",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface/by/source/{{source}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface",
                                        "by",
                                        "source",
                                        "{{source}}"
                                    ]
                                },
                                "description": "Returns every interface of the given `source` activated for the org. Useful e.g. to find every VTEX tenant the org has."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "signature",
                                                "value": "{{signature}}",
                                                "type": "text",
                                                "description": "RSA signature `account.service.token` validated against the org public key."
                                            },
                                            {
                                                "key": "User-Agent",
                                                "value": "{{User-Agent}}",
                                                "type": "text",
                                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                            },
                                            {
                                                "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/integration/interface/by/source/{{source}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "integration",
                                                "interface",
                                                "by",
                                                "source",
                                                "{{source}}"
                                            ]
                                        },
                                        "description": "Returns every interface of the given `source` activated for the org. Useful e.g. to find every VTEX tenant the org has."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    {\"id\": 41, \"organization\": \"xpto\", \"slug\": \"ecommerce\", \"name\": \"E-commerce\", \"source\": \"vtex\", \"activated\": \"2026-01-15T10:00:00+00:00\"}\n]"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Create interface",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/interface",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "interface"
                            ]
                        },
                        "description": "Activates a new integration for the org. `slug` must be unique inside `(organization, slug)`. `activated` accepts a boolean: `true` sets the current timestamp, `false` (or omitted) leaves it `null` (= integration registered but not yet enabled).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"slug\": \"ecommerce\",\n    \"name\": \"E-commerce\",\n    \"source\": \"vtex\",\n    \"activated\": \"true\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface"
                                    ]
                                },
                                "description": "Activates a new integration for the org. `slug` must be unique inside `(organization, slug)`. `activated` accepts a boolean: `true` sets the current timestamp, `false` (or omitted) leaves it `null` (= integration registered but not yet enabled).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"slug\": \"ecommerce\",\n    \"name\": \"E-commerce\",\n    \"source\": \"vtex\",\n    \"activated\": \"true\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Created",
                            "code": 201,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"id\": 102, \"organization\": \"xpto\", \"slug\": \"ecommerce\", \"name\": \"E-commerce\", \"source\": \"vtex\", \"activated\": \"2026-06-24T12:00:00+00:00\"}"
                        },
                        {
                            "name": "Conflict (duplicate)",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface"
                                    ]
                                },
                                "description": "Activates a new integration for the org. `slug` must be unique inside `(organization, slug)`. `activated` accepts a boolean: `true` sets the current timestamp, `false` (or omitted) leaves it `null` (= integration registered but not yet enabled).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"slug\": \"ecommerce\",\n    \"name\": \"E-commerce\",\n    \"source\": \"vtex\",\n    \"activated\": \"true\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"error\": \"Duplicate entry for (organization, slug)\"}"
                        }
                    ]
                },
                {
                    "name": "Delete interface",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/interface/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "interface",
                                "{{id}}"
                            ]
                        },
                        "description": "Removes a interface. Irreversible — does not soft-delete. Make sure no cron/job is still keyed off this id."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Removes a interface. Irreversible — does not soft-delete. Make sure no cron/job is still keyed off this id."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"deleted\": true}"
                        }
                    ]
                },
                {
                    "name": "List interfaces",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/interface",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "interface"
                            ]
                        },
                        "description": "Lists every integration activated for the org (derived from the signature header). Supports the standard `Tools\\Data\\Listing` query params (`p`/`page`, `e`/`entries`, `q[col][OP]`)."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface"
                                    ]
                                },
                                "description": "Lists every integration activated for the org (derived from the signature header). Supports the standard `Tools\\Data\\Listing` query params (`p`/`page`, `e`/`entries`, `q[col][OP]`)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        {\"id\": 41, \"organization\": \"xpto\", \"slug\": \"ecommerce\", \"name\": \"E-commerce\", \"source\": \"vtex\", \"activated\": \"2026-01-15T10:00:00+00:00\"},\n        {\"id\": 42, \"organization\": \"xpto\", \"slug\": \"loja-fisica\", \"name\": \"Loja Física\", \"source\": \"linx\", \"activated\": null}\n    ],\n    \"total\": 2,\n    \"pagination\": {\"entries\": 50, \"currentPage\": 1, \"totalPages\": 1}\n}"
                        }
                    ]
                },
                {
                    "name": "Get interface",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/interface/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "interface",
                                "{{id}}"
                            ]
                        },
                        "description": "Returns a single interface by id. Implicit org filter — returns 404 if the id belongs to another org."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single interface by id. Implicit org filter — returns 404 if the id belongs to another org."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"id\": 41, \"organization\": \"xpto\", \"slug\": \"ecommerce\", \"name\": \"E-commerce\", \"source\": \"vtex\", \"activated\": \"2026-01-15T10:00:00+00:00\"}"
                        },
                        {
                            "name": "Not Found",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single interface by id. Implicit org filter — returns 404 if the id belongs to another org."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"error\": \"Not Found\"}"
                        }
                    ]
                },
                {
                    "name": "Update interface",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/interface/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "interface",
                                "{{id}}"
                            ]
                        },
                        "description": "Updates fields of an existing interface. Pass `activated: true` to enable, `activated: false` to disable.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"slug\": \"ecommerce\",\n    \"name\": \"E-commerce Brasil\",\n    \"source\": \"vtex\",\n    \"activated\": \"true\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/interface/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "interface",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates fields of an existing interface. Pass `activated: true` to enable, `activated: false` to disable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"slug\": \"ecommerce\",\n    \"name\": \"E-commerce Brasil\",\n    \"source\": \"vtex\",\n    \"activated\": \"true\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"id\": 102, \"organization\": \"xpto\", \"slug\": \"ecommerce\", \"name\": \"E-commerce Brasil\", \"source\": \"vtex\", \"activated\": \"2026-06-24T12:00:00+00:00\"}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Ping",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "signature",
                        "value": "{{signature}}",
                        "type": "text",
                        "description": "RSA signature `account.service.token` validated against the org public key."
                    },
                    {
                        "key": "User-Agent",
                        "value": "{{User-Agent}}",
                        "type": "text",
                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                    },
                    {
                        "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/integration/ping",
                    "protocol": "https",
                    "host": [
                        "{{organization}}",
                        "myguper",
                        "com"
                    ],
                    "path": [
                        "api",
                        "integration",
                        "ping"
                    ]
                },
                "description": "Health check endpoint. No auth required."
            },
            "response": [
                {
                    "name": "OK",
                    "originalRequest": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/ping",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "ping"
                            ]
                        },
                        "description": "Health check endpoint. No auth required."
                    },
                    "status": "OK",
                    "code": 200,
                    "_postman_previewlanguage": "json",
                    "header": [
                        {
                            "key": "Content-Type",
                            "value": "application/json"
                        }
                    ],
                    "body": "{\"pong\":true}"
                }
            ]
        },
        {
            "name": "Source",
            "item": [
                {
                    "name": "Create source",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/source",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "source"
                            ]
                        },
                        "description": "Registers a new integration type globally. `slug` must be unique. Use sparingly — done once per new platform Guper supports.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"slug\": \"cegid\",\n    \"name\": \"Cegid\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/source",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "source"
                                    ]
                                },
                                "description": "Registers a new integration type globally. `slug` must be unique. Use sparingly — done once per new platform Guper supports.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"slug\": \"cegid\",\n    \"name\": \"Cegid\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Created",
                            "code": 201,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"id\": 11, \"slug\": \"cegid\", \"name\": \"Cegid\"}"
                        },
                        {
                            "name": "Conflict (duplicate)",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/source",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "source"
                                    ]
                                },
                                "description": "Registers a new integration type globally. `slug` must be unique. Use sparingly — done once per new platform Guper supports.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"slug\": \"cegid\",\n    \"name\": \"Cegid\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"error\": \"Duplicate entry for slug\"}"
                        }
                    ]
                },
                {
                    "name": "Delete source",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/source/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "source",
                                "{{id}}"
                            ]
                        },
                        "description": "Removes a source. Caller is responsible for ensuring no `tenant` rows still reference it — referential integrity is not enforced at the DB level (logical FK)."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/source/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "source",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Removes a source. Caller is responsible for ensuring no `tenant` rows still reference it — referential integrity is not enforced at the DB level (logical FK)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"deleted\": true}"
                        }
                    ]
                },
                {
                    "name": "List sources",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/source",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "source"
                            ]
                        },
                        "description": "Returns the global master list of integration types. **Not org-scoped** — every org sees the same list. Use as the FK target for `tenant.source`."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/source",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "source"
                                    ]
                                },
                                "description": "Returns the global master list of integration types. **Not org-scoped** — every org sees the same list. Use as the FK target for `tenant.source`."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        {\"id\": 2, \"slug\": \"vtex\", \"name\": \"Vtex\"},\n        {\"id\": 3, \"slug\": \"shopify\", \"name\": \"Shopify\"},\n        {\"id\": 4, \"slug\": \"linx\", \"name\": \"Linx\"}\n    ],\n    \"total\": 10,\n    \"pagination\": {\"entries\": 50, \"currentPage\": 1, \"totalPages\": 1}\n}"
                        }
                    ]
                },
                {
                    "name": "Get source",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/source/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "source",
                                "{{id}}"
                            ]
                        },
                        "description": "Returns a single source by id."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/source/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "source",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single source by id."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"id\": 2, \"slug\": \"vtex\", \"name\": \"Vtex\"}"
                        },
                        {
                            "name": "Not Found",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/source/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "source",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single source by id."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"error\": \"Not Found\"}"
                        }
                    ]
                },
                {
                    "name": "Update source",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "signature",
                                "value": "{{signature}}",
                                "type": "text",
                                "description": "RSA signature `account.service.token` validated against the org public key."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                            },
                            {
                                "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/integration/source/{{id}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "integration",
                                "source",
                                "{{id}}"
                            ]
                        },
                        "description": "Updates fields of an existing source. `slug` updates propagate to every `tenant.source` referencing it.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"slug\": \"cegid\",\n    \"name\": \"Cegid\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "signature",
                                        "value": "{{signature}}",
                                        "type": "text",
                                        "description": "RSA signature `account.service.token` validated against the org public key."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": "Caller service name (e.g. `middleware`, `loyalty`)."
                                    },
                                    {
                                        "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/integration/source/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "integration",
                                        "source",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates fields of an existing source. `slug` updates propagate to every `tenant.source` referencing it.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"slug\": \"cegid\",\n    \"name\": \"Cegid\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\"id\": 11, \"slug\": \"cegid\", \"name\": \"Cegid\"}"
                        }
                    ]
                }
            ]
        }
    ],
    "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"
        }
    ]
}