{ "openapi": "3.0.3", "info": { "title": "Woofi - Webservice V2", "version": "2.0.0", "description": "Para liberar acesso como agência, primeiramente você deve criar um nome para seu app e ativar o webservice do Woofi, no apicativo WEB, basta ir até o seu perfil e a opção de Webservice estará lá." }, "servers": [ { "url": "https://portal.woo-fi.com/api/webservice/v2", "description": "Produção" }, { "url": "https://beta.woo-fi.com/api/webservice/v2", "description": "Sandbox" } ], "tags": [ { "name": "Auth" }, { "name": "Catalog" }, { "name": "Activations" }, { "name": "Credit" }, { "name": "Dashboard" } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer" } } }, "security": [ { "bearerAuth": [] } ], "paths": { "/auth/login": { "post": { "summary": "Login", "operationId": "webservice-v2-post-auth-login", "tags": [ "Auth" ], "description": "Autentica a agência e retorna um token Bearer.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "E-mail da conta" }, "password": { "type": "string", "description": "Senha da conta" }, "device_name": { "type": "string", "description": "Nome/rótulo do dispositivo ou app (identifica o token)" } }, "required": [ "email", "password", "device_name" ] }, "example": { "email": "agencia@exemplo.com", "password": "sua-senha", "device_name": "meu-app" } } } }, "responses": { "200": { "description": "Login Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "user": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "email": { "type": "string" }, "photo": { "type": "string" }, "phone": { "type": "string" }, "document": { "type": "string" } } } } }, "example": { "token": "12|aBc...tokenDeExemplo", "user": { "id": 42, "name": "Agência Exemplo", "email": "agencia@exemplo.com", "photo": "/user-images/image.jpeg", "phone": "(18) 99999-9999", "document": "333.333.333-33" } } } } }, "401": { "description": "Login Failed", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" } } }, "example": { "message": "Credenciais inválidas" } } } } } } }, "/auth/check-user": { "get": { "summary": "Check User", "operationId": "webservice-v2-get-auth-check-user", "tags": [ "Auth" ], "description": "Esse endpoit é válido para quando queremos validar se o usuário está com o seu token válido ou não, caso sim ele retornará um 200 code e caso não, retornará um 401. A sessão sempre durará uma hora.", "responses": { "200": { "description": "Invalid Token", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/auth/user-info": { "get": { "summary": "User Info", "operationId": "webservice-v2-get-auth-user-info", "tags": [ "Auth" ], "responses": { "200": { "description": "User Info", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "photo": { "type": "string" } } }, "example": { "id": 133, "name": "João Silva", "email": "joao.silva@example.com", "phone": "(11) 98765-4321", "photo": "/user-images/example.jpeg" } } } } } } }, "/operators": { "get": { "summary": "Operators", "operationId": "webservice-v2-get-operators", "tags": [ "Catalog" ], "responses": { "200": { "description": "Operators", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } } }, "example": [ { "id": 14, "name": "T-Mobile" }, { "id": 15, "name": "WOOFI" } ] } } } } } }, "/products/{operatorId}": { "get": { "summary": "Products", "operationId": "webservice-v2-get-products-operatorid", "tags": [ "Catalog" ], "parameters": [ { "name": "operatorId", "in": "path", "required": true, "description": "Valor usado para substituir {operatorId} na rota.", "schema": { "type": "string", "example": "15" } } ], "responses": { "200": { "description": "Products", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "operator_id": { "type": "integer" } } } }, "example": [ { "id": 1, "name": "Product 1", "operator_id": 15 }, { "id": 2, "name": "Product 2", "operator_id": 15 } ] } } } } } }, "/products/{productId}/variations": { "get": { "summary": "Product Variations", "operationId": "webservice-v2-get-products-productid-variations", "tags": [ "Catalog" ], "parameters": [ { "name": "productId", "in": "path", "required": true, "description": "Valor usado para substituir {productId} na rota.", "schema": { "type": "string", "example": "43" } } ], "responses": { "200": { "description": "Product Variations", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "product_id": { "type": "integer" }, "description": { "type": "string" }, "price": { "type": "number" }, "duration": { "type": "string" }, "region": { "nullable": true } } } }, "example": [ { "id": 60, "product_id": 49, "description": "5 Dias 1GB", "price": 26.98, "duration": "5", "region": null }, { "id": 61, "product_id": 49, "description": "6 Dias 1GB Suiça", "price": 40.99, "duration": "6", "region": "Suiça" } ] } } } } } }, "/products/prices": { "get": { "summary": "Product Prices", "operationId": "webservice-v2-get-products-prices", "tags": [ "Catalog" ], "parameters": [ { "name": "operator_id", "in": "query", "required": false, "description": "Filtra por operadora", "schema": { "type": "number", "example": "15" } } ], "description": "Lista todos os produtos e variações acessíveis à agência com seus preços.", "responses": { "200": { "description": "Products", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "idProduct": { "type": "integer" }, "description": { "type": "string" }, "sequence": { "type": "integer" }, "price": { "type": "integer" }, "itemName": { "type": "string" } } } }, "example": [ { "idProduct": 140, "description": "USA - COM INTERNET E LIGAÇÕES ILIMITADAS", "sequence": 590, "price": 20, "itemName": "30 Dias 5GB EUA" } ] } } } } } }, "/activations": { "post": { "summary": "Create Activation", "operationId": "webservice-v2-post-activations-post", "tags": [ "Activations" ], "description": "Cria uma ativação (eSIM ou chip físico). Valida o payload inteiro na entrada.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "product_id": { "type": "integer", "description": "Produto escolhido no catálogo" }, "variation_id": { "type": "integer", "description": "Variação (plano) escolhida" }, "activation_type": { "type": "string", "description": "esim ou chip" }, "activation_date": { "type": "string", "description": "Data de início do plano (AAAA-MM-DD)" }, "client": { "type": "object", "properties": { "name": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "document": { "type": "string" } }, "description": "Dados do cliente: name, email, phone (obrigatórios) e document (opcional)" }, "items": { "type": "array", "items": { "type": "object", "properties": { "icc": { "type": "string" }, "imei": { "type": "string" }, "eid": { "type": "string" }, "pin": { "type": "string" }, "line": { "type": "string" } } }, "description": "Dados do chip por item: icc/imei/eid/pin/line" }, "external_id": { "type": "string", "description": "Seu identificador para consultar a ativação depois" } }, "required": [ "product_id", "variation_id", "activation_type", "activation_date", "client", "items" ] }, "example": { "product_id": 63, "variation_id": 232, "activation_type": "esim", "activation_date": "2026-05-20", "client": { "name": "João Silva", "email": "joao.silva@example.com", "phone": "(11) 98765-4321", "document": "182.177.290-34" }, "items": [ { "icc": "", "imei": "", "eid": "", "pin": "", "line": "" } ], "external_id": "434" } } } }, "responses": { "201": { "description": "Create Activation", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "order": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "integer" }, "total_price": { "type": "number" }, "external_id": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "product_name": { "type": "string" }, "variation_description": { "type": "string" }, "unit_price": { "type": "number" }, "icc": { "nullable": true }, "imei": { "nullable": true }, "imei2": { "nullable": true }, "eid": { "type": "string" }, "pin": { "nullable": true }, "line": { "nullable": true }, "qrcode_url": { "type": "string" }, "qr_content": { "type": "string" } } } } } } } }, "example": { "message": "Pedido realizado com sucesso!", "order": { "id": 25360, "status": 2, "total_price": 33.25, "external_id": "434", "items": [ { "id": 25869, "product_name": "EUROPA ILIMITADO COM 2GB", "variation_description": "9 Dias 2GB", "unit_price": 33.25, "icc": null, "imei": null, "imei2": null, "eid": "8904000000000000000", "pin": null, "line": null, "qrcode_url": "https://portal.woo-fi.com/qr_codes/example.png", "qr_content": "LPA:1$rsp.example.com$QR-G-01-ABCDEF" } ] } } } } } } }, "get": { "summary": "List Activations", "operationId": "webservice-v2-get-activations-get", "tags": [ "Activations" ], "parameters": [ { "name": "page", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "1" } } ], "responses": { "200": { "description": "List Activations", "content": { "application/json": { "schema": { "type": "object", "properties": { "current_page": { "type": "integer" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "seller_name": { "nullable": true }, "dealer_name": { "type": "string" }, "product": { "type": "string" }, "created_at": { "type": "string" }, "total_price": { "type": "integer" }, "status": { "type": "integer" } } } }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "last_page": { "type": "integer" } } }, "example": { "current_page": 1, "data": [ { "id": 1, "seller_name": null, "dealer_name": "Dealer 1", "product": "Product 1", "created_at": "2026-05-13 10:00:00", "total_price": 24, "status": 2 } ], "per_page": 15, "total": 1, "last_page": 1 } } } } } } }, "/activations/{id}": { "get": { "summary": "Get one activation", "operationId": "webservice-v2-get-activations-id", "tags": [ "Activations" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Valor usado para substituir {id} na rota.", "schema": { "type": "string", "example": "6767" } } ], "responses": { "200": { "description": "Get one activation", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "integer" }, "total_price": { "type": "number" }, "activation_type": { "type": "string" }, "external_id": { "type": "string" }, "created_at": { "type": "string" }, "activated_at": { "type": "string" }, "client": { "type": "object", "properties": { "name": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "document": { "type": "string" } } }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "product_name": { "type": "string" }, "variation_description": { "type": "string" }, "unit_price": { "type": "number" }, "icc": { "type": "string" }, "imei": { "type": "string" }, "eid": { "type": "string" }, "pin": { "type": "string" }, "line": { "type": "string" }, "qrcode_url": { "type": "string" }, "imei2": { "nullable": true }, "qr_content": { "type": "string" } } } } } }, "example": { "id": 25360, "status": 2, "total_price": 66.5, "activation_type": "esim", "external_id": "434", "created_at": "2026-05-18 15:30:00", "activated_at": "2026-05-20 00:00:00", "client": { "name": "João Silva", "email": "joao.silva@example.com", "phone": "(11) 98765-4321", "document": "182.177.290-34" }, "items": [ { "id": 25869, "product_name": "EUROPA ILIMITADO COM 2GB", "variation_description": "9 Dias 2GB", "unit_price": 33.25, "icc": "8955...", "imei": "3587...", "eid": "8904...", "pin": "1234", "line": "11988888888", "qrcode_url": "https://beta.woo-fi.com/storage/qrcodes/ex.png", "imei2": null, "qr_content": "LPA:1$rsp.example.com$QR-G-01-ABCDEF" } ] } } } } } } }, "/activations/cancel/{id}": { "post": { "summary": "Cancel Activation", "operationId": "webservice-v2-post-activations-cancel-id", "tags": [ "Activations" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Valor usado para substituir {id} na rota.", "schema": { "type": "string", "example": "9431" } } ], "responses": { "200": { "description": "Cancel Activation", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" } } }, "example": { "message": "Ativação cancelada com sucesso." } } } } } } }, "/activations/consumption/order/{orderId}": { "get": { "summary": "Consumo por Pedido", "operationId": "webservice-v2-get-activations-consumption-order-orderid", "tags": [ "Activations" ], "parameters": [ { "name": "orderId", "in": "path", "required": true, "description": "Valor usado para substituir {orderId} na rota.", "schema": { "type": "string", "example": "434" } } ], "description": "Consulta o consumo dos chips de um pedido. Todos os volumes vêm em **MB**. Em planos ilimitados, `unlimited=true` e franquia/saldo/percentual vêm `null`.\n\n> [!IMPORTANT]\n> Recurso restrito: a agência precisa ter a **consulta de consumo habilitada** (`allow_consumption_query`). Sem a permissão, a resposta é `403`.\n\nO `{orderId}` aceita o **id interno** ou o **external_id** do pedido.", "responses": { "200": { "description": "Consumo por Pedido", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "message": { "type": "string", "description": "Presente apenas quando available=false; explica o motivo da indisponibilidade" }, "data": { "type": "object", "properties": { "order_id": { "type": "integer", "description": "ID interno do pedido" }, "external_id": { "type": "string", "description": "Seu identificador do pedido (external_id)" }, "activation_type": { "type": "string", "description": "esim ou chip" }, "chips": { "type": "array", "items": { "type": "object", "properties": { "sequence": { "type": "integer", "description": "ID do item (chip) no pedido" }, "identifier": { "type": "string", "description": "ICC, EID ou IMEI2 usado na consulta (null se indisponível)" }, "available": { "type": "boolean", "description": "Indica se o consumo pôde ser consultado" }, "unlimited": { "type": "boolean", "description": "Plano ilimitado; quando true, allowance_mb, remaining_mb e usage_percentage vêm null" }, "total_used_mb": { "type": "integer", "description": "Total consumido no ciclo, em MB" }, "allowance_mb": { "type": "integer", "description": "Franquia do plano, em MB (null quando ilimitado)" }, "remaining_mb": { "type": "integer", "description": "Saldo restante, em MB (null quando ilimitado)" }, "usage_percentage": { "type": "integer", "description": "Percentual utilizado (null quando ilimitado)" }, "last_usage_at": { "type": "string", "description": "Data do último consumo registrado (AAAA-MM-DD)" }, "fetched_at": { "type": "string", "description": "Instante da consulta (ISO 8601)" }, "history": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "Dia do consumo no histórico (AAAA-MM-DD)" }, "used_mb": { "type": "integer", "description": "Consumo do dia, em MB" } } }, "description": "Consumo diário do ciclo" } } }, "description": "Lista de chips do pedido com o consumo (campos abaixo)" } } } } }, "example": { "status": "success", "message": "Consumo consultado com sucesso.", "data": { "order_id": 25360, "external_id": "434", "activation_type": "chip", "chips": [ { "sequence": 25869, "identifier": "8955010012345678909", "available": true, "unlimited": false, "total_used_mb": 3584, "allowance_mb": 5120, "remaining_mb": 1536, "usage_percentage": 70, "last_usage_at": "2026-09-21", "fetched_at": "2026-09-22T13:40:05-03:00", "history": [ { "date": "2026-09-21", "used_mb": 820 }, { "date": "2026-09-20", "used_mb": 640 } ] }, { "sequence": 25870, "identifier": "355000000000000", "available": true, "unlimited": true, "total_used_mb": 12480, "allowance_mb": null, "remaining_mb": null, "usage_percentage": null, "last_usage_at": "2026-09-22", "fetched_at": "2026-09-22T13:40:05-03:00", "history": [ { "date": "2026-09-22", "used_mb": 1500 } ] } ] } } } } }, "403": { "description": "Sem permissão", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "message": { "type": "string", "description": "Presente apenas quando available=false; explica o motivo da indisponibilidade" }, "data": { "type": "array", "items": {} } } }, "example": { "status": "error", "message": "Funcionalidade não habilitada para esta agência.", "data": [] } } } } } } }, "/activations/consumption/chip/{identifier}": { "get": { "summary": "Consumo por Chip", "operationId": "webservice-v2-get-activations-consumption-chip-identifier", "tags": [ "Activations" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Valor usado para substituir {identifier} na rota.", "schema": { "type": "string", "example": "8955010012345678909" } } ], "description": "Consulta o consumo de um único chip. Todos os volumes vêm em **MB**. Em planos ilimitados, `unlimited=true` e franquia/saldo/percentual vêm `null`.\n\n> [!IMPORTANT]\n> Recurso restrito: a agência precisa ter a **consulta de consumo habilitada** (`allow_consumption_query`). Sem a permissão, a resposta é `403`.\n\nO chip é resolvido pelo **ICC**, **EID**, **IMEI2** ou **número da linha**, sempre dentro do escopo da agência autenticada. Havendo mais de um item para o mesmo identificador, vence o mais recente.", "responses": { "200": { "description": "Consumo por Chip", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "message": { "type": "string", "description": "Presente apenas quando available=false; explica o motivo da indisponibilidade" }, "data": { "type": "object", "properties": { "order_id": { "type": "integer", "description": "ID interno do pedido" }, "external_id": { "type": "string", "description": "Seu identificador do pedido (external_id)" }, "activation_type": { "type": "string", "description": "esim ou chip" }, "chip": { "type": "object", "properties": { "sequence": { "type": "integer", "description": "ID do item (chip) no pedido" }, "identifier": { "type": "string", "description": "ICC, EID ou IMEI2 usado na consulta (null se indisponível)" }, "available": { "type": "boolean", "description": "Indica se o consumo pôde ser consultado" }, "unlimited": { "type": "boolean", "description": "Plano ilimitado; quando true, allowance_mb, remaining_mb e usage_percentage vêm null" }, "total_used_mb": { "type": "integer", "description": "Total consumido no ciclo, em MB" }, "allowance_mb": { "type": "integer", "description": "Franquia do plano, em MB (null quando ilimitado)" }, "remaining_mb": { "type": "integer", "description": "Saldo restante, em MB (null quando ilimitado)" }, "usage_percentage": { "type": "integer", "description": "Percentual utilizado (null quando ilimitado)" }, "last_usage_at": { "type": "string", "description": "Data do último consumo registrado (AAAA-MM-DD)" }, "fetched_at": { "type": "string", "description": "Instante da consulta (ISO 8601)" }, "history": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "Dia do consumo no histórico (AAAA-MM-DD)" }, "used_mb": { "type": "integer", "description": "Consumo do dia, em MB" } } }, "description": "Consumo diário do ciclo" } }, "description": "Consumo do chip (campos abaixo)" } } } } }, "example": { "status": "success", "message": "Consumo consultado com sucesso.", "data": { "order_id": 25360, "external_id": "434", "activation_type": "chip", "chip": { "sequence": 25869, "identifier": "8955010012345678909", "available": true, "unlimited": false, "total_used_mb": 3584, "allowance_mb": 5120, "remaining_mb": 1536, "usage_percentage": 70, "last_usage_at": "2026-09-21", "fetched_at": "2026-09-22T13:40:05-03:00", "history": [ { "date": "2026-09-21", "used_mb": 820 }, { "date": "2026-09-20", "used_mb": 640 } ] } } } } } }, "403": { "description": "Sem permissão", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "message": { "type": "string", "description": "Presente apenas quando available=false; explica o motivo da indisponibilidade" }, "data": { "type": "array", "items": {} } } }, "example": { "status": "error", "message": "Funcionalidade não habilitada para esta agência.", "data": [] } } } } } } }, "/get-tax/{uf}": { "get": { "summary": "Get Tax", "operationId": "webservice-v2-get-get-tax-uf", "tags": [ "Activations" ], "parameters": [ { "name": "uf", "in": "path", "required": true, "description": "Valor usado para substituir {uf} na rota.", "schema": { "type": "string", "example": "sp" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "Get Tax", "content": { "application/json": { "schema": { "type": "object", "properties": { "sedex": { "type": "integer" }, "pac": { "type": "number" } } }, "example": { "sedex": 13, "pac": 5.9 } } } } } } }, "/order/checkIcc/{icc}": { "get": { "summary": "Check ICC", "operationId": "webservice-v2-get-order-checkicc-icc", "tags": [ "Activations" ], "parameters": [ { "name": "icc", "in": "path", "required": true, "description": "Valor usado para substituir {icc} na rota.", "schema": { "type": "string", "example": "8955000000000000000" } } ], "responses": { "200": { "description": "check icc", "content": { "application/json": { "schema": { "type": "object", "properties": { "exists": { "type": "boolean" } } }, "example": { "exists": true } } } } } } }, "/current-balance": { "get": { "summary": "Current Balance", "operationId": "webservice-v2-get-current-balance", "tags": [ "Credit" ], "responses": { "200": { "description": "Current Balance", "content": { "application/json": { "schema": { "type": "object", "properties": { "current_balance": { "type": "number" } } }, "example": { "current_balance": 8661.15 } } } } } } }, "/credit-history": { "get": { "summary": "Credit History", "operationId": "webservice-v2-get-credit-history", "tags": [ "Credit" ], "responses": { "200": { "description": "Credit History", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "created_at": { "type": "string" }, "amount": { "type": "integer" }, "status": { "type": "string" }, "gateway": { "type": "string" } } } }, "example": [ { "id": 1201, "created_at": "2026-07-16 18:21:00", "amount": 5, "status": "Aprovado", "gateway": "Stripe" } ] } } } } } }, "/statement": { "get": { "summary": "Credit Statement", "operationId": "webservice-v2-get-statement", "tags": [ "Credit" ], "parameters": [ { "name": "initial_date", "in": "query", "required": false, "description": "Início do período (padrão: mês atual)", "schema": { "type": "string", "example": "2026-07-01" } }, { "name": "final_date", "in": "query", "required": false, "description": "Fim do período (padrão: mês atual)", "schema": { "type": "string", "example": "2026-07-31" } }, { "name": "status", "in": "query", "required": false, "description": "Filtro de status (ex.: Aprovado, all)", "schema": { "type": "string", "example": "Aprovado" } }, { "name": "per_page", "in": "query", "required": false, "description": "Itens por página (máx. 100, padrão 15)", "schema": { "type": "number", "example": "15" } } ], "description": "Retorna o extrato de vendas e débitos de ativações do período.", "responses": { "200": { "description": "Current Balance", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "object", "properties": { "total_sales_count": { "type": "integer" }, "total_sales_amount": { "type": "integer" }, "period_start": { "type": "string" }, "period_end": { "type": "string" } } }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "order_id": { "type": "integer" }, "date": { "type": "string" }, "amount": { "type": "integer" }, "description": { "type": "string" }, "status": { "type": "string" } } } }, "meta": { "type": "object", "properties": { "current_page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "last_page": { "type": "integer" } } } } }, "example": { "summary": { "total_sales_count": 2, "total_sales_amount": 135, "period_start": "2026-07-01", "period_end": "2026-07-31" }, "data": [ { "id": 1541, "order_id": 3021, "date": "2026-07-26T10:15:00-03:00", "amount": 45, "description": "Débito ref. Ativação de Pedido #3021", "status": "Aprovado" } ], "meta": { "current_page": 1, "per_page": 15, "total": 2, "last_page": 1 } } } } } } } }, "/charge": { "post": { "summary": "Create Charge", "operationId": "webservice-v2-post-charge", "tags": [ "Credit" ], "description": "Gera uma cobrança para recarregar a carteira.\n\nPara **Stripe**, a resposta traz `stripe_url` (link de checkout). Para **Ebanx**, informe `method` e, em cartão, os campos `card_*`.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "payment_type": { "type": "string", "description": "Gateway: stripe ou ebanx" }, "amount": { "type": "integer", "description": "Valor da recarga (respeita o mínimo do gateway)" }, "instalments": { "type": "integer", "description": "Parcelas (1 a 12)" } }, "required": [ "payment_type", "amount" ] }, "example": { "payment_type": "stripe", "amount": 100, "instalments": 1 } } } }, "responses": { "200": { "description": "Ebanx", "content": { "application/json": { "schema": { "type": "object" } } } }, "201": { "description": "Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "status": { "type": "string" }, "data": { "type": "object", "properties": { "resp": { "type": "object", "properties": { "price": { "type": "string" }, "finalPrice": { "type": "number" }, "typePayment": { "type": "string" }, "type": { "type": "string" }, "name": { "type": "string" }, "card_name": { "type": "string" }, "card_number": { "type": "string" }, "expiration": { "type": "string" }, "card_cvv": { "type": "string" }, "country": { "type": "string" }, "idUser": { "type": "integer" }, "idDealer": { "type": "integer" }, "people": { "type": "object", "properties": { "idPeople": { "type": "integer" }, "name": { "type": "string" }, "birthdate": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "cpfCnpj": { "type": "string" }, "zipCode": { "type": "string" }, "address": { "type": "string" }, "number": { "type": "string" }, "neighborhood": { "type": "string" }, "photo": { "type": "string" }, "active": { "type": "integer" }, "juridical": { "type": "integer" }, "created_at": { "nullable": true }, "updated_at": { "nullable": true }, "responsible": { "type": "string" }, "phone_responsible": { "type": "string" }, "userActive": { "type": "integer" }, "idUf": { "nullable": true }, "idCity": { "nullable": true }, "city_name": { "type": "string" }, "uf_name": { "type": "string" }, "ip": { "nullable": true } } }, "payment_id": { "type": "string" }, "ebanx_status": { "type": "string" } } }, "payment": { "type": "object", "properties": { "status": { "type": "integer" }, "phrase": { "type": "string" }, "body": { "type": "object", "properties": { "hash": { "type": "string" }, "country": { "type": "string" }, "merchant_payment_code": { "type": "string" }, "order_number": { "nullable": true }, "status": { "type": "string" }, "status_date": { "nullable": true }, "open_date": { "type": "string" }, "confirm_date": { "nullable": true }, "transfer_date": { "nullable": true }, "amount_br": { "type": "string" }, "amount_ext": { "type": "string" }, "amount_iof": { "type": "string" }, "currency_rate": { "type": "string" }, "currency_ext": { "type": "string" }, "due_date": { "type": "string" }, "instalments": { "type": "string" }, "payment_type_code": { "type": "string" }, "redirect_url": { "type": "string" }, "pre_approved": { "type": "boolean" }, "capture_available": { "nullable": true }, "pix": { "type": "object", "properties": { "qr_code_value": { "type": "string" } } } } }, "body_status": { "type": "string" } } } } }, "redirect": { "type": "string" }, "class": { "type": "string" } } }, "example": { "message": "Pedido realizado com sucesso!", "status": "success", "data": { "resp": { "price": "98.9", "finalPrice": 112.11, "typePayment": "ebanx", "type": "pix", "name": "People Name", "card_name": "People Card Name", "card_number": "4444 4444 4444 4444", "expiration": "01/34", "card_cvv": "111", "country": "Brasil", "idUser": 1, "idDealer": 1, "people": { "idPeople": 1, "name": "People Name", "birthdate": "2023-06-14", "email": "example@email.com", "phone": "(22) 222222-2222", "cpfCnpj": "333.333.333-33", "zipCode": "111111-1111", "address": "Rua de exemplo", "number": "123", "neighborhood": "Bairro de exemplo", "photo": "", "active": 1, "juridical": 1, "created_at": null, "updated_at": null, "responsible": "Pessoa", "phone_responsible": "(11) 11111-1111", "userActive": 1, "idUf": null, "idCity": null, "city_name": "Catanduva", "uf_name": "SP", "ip": null }, "payment_id": "818192839280192381231", "ebanx_status": "1" }, "payment": { "status": 200, "phrase": "OK", "body": { "hash": "akhsdkjahdgakjhdgasdjkshadgkjahda", "country": "br", "merchant_payment_code": "1231231_121312", "order_number": null, "status": "11", "status_date": null, "open_date": "2024-05-20 17:03:08", "confirm_date": null, "transfer_date": null, "amount_br": "656.08", "amount_ext": "112.11", "amount_iof": "2.48", "currency_rate": "5.8300", "currency_ext": "USD", "due_date": "2024-05-20", "instalments": "1", "payment_type_code": "pix", "redirect_url": "", "pre_approved": false, "capture_available": null, "pix": { "qr_code_value": "" } }, "body_status": "1" } }, "redirect": "", "class": "alert-success" } } } } } } }, "/charge/stripe/check-success": { "get": { "summary": "Check Stripe success", "operationId": "webservice-v2-get-charge-stripe-check-success", "tags": [ "Credit" ], "parameters": [ { "name": "session_id", "in": "query", "required": true, "description": "ID da sessão de checkout retornada pelo charge", "schema": { "type": "string", "example": "cs_test_a1Zj2XFnQGzd0PaeXxtBcByyD16r9fi6vPaX22bwUVY0Tu5q8SUU2JliCX" } } ], "description": "Confirma o resultado de um pagamento Stripe pela sessão de checkout.", "responses": { "200": { "description": "Check Stripe success", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" } } }, "example": { "status": true } } } } } } }, "/charge/stripe/last-id": { "get": { "summary": "Last Stripe ID", "operationId": "webservice-v2-get-charge-stripe-last-id", "tags": [ "Credit" ], "responses": { "200": { "description": "Last Stripe ID", "content": { "application/json": { "schema": { "type": "object", "properties": { "payment_id": { "type": "string" } } }, "example": { "payment_id": "cs_test_a1Zj2XFnQGzd0PaeXxtBcByyD16r9fi6vPaX22bwUVY0Tu5q8SUU2JliCX" } } } } } } }, "/dealer/summary": { "get": { "summary": "Summary", "operationId": "webservice-v2-get-dealer-summary", "tags": [ "Dashboard" ], "parameters": [ { "name": "month", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "05" } }, { "name": "year", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "2026" } } ], "responses": { "200": { "description": "Info Values", "content": { "application/json": { "schema": { "type": "object", "properties": { "current_balance": { "type": "number" }, "total_activations": { "type": "number" } } }, "example": { "current_balance": 8661.15, "total_activations": 696.12 } } } } } } }, "/dealer/top-sellers": { "get": { "summary": "Top Sellers", "operationId": "webservice-v2-get-dealer-top-sellers", "tags": [ "Dashboard" ], "parameters": [ { "name": "month", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "05" } }, { "name": "year", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "2026" } } ], "responses": { "200": { "description": "Top Sellers", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "total_amount": { "type": "number" } } } }, "example": [ { "name": "Seller 1", "total_amount": 380.64 }, { "name": "Seller 2", "total_amount": 200.64 } ] } } } } } }, "/dealer/top-activations": { "get": { "summary": "Top Activations", "operationId": "webservice-v2-get-dealer-top-activations", "tags": [ "Dashboard" ], "parameters": [ { "name": "month", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "05" } }, { "name": "year", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "2026" } } ], "responses": { "200": { "description": "Top Activations", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "seller_name": { "type": "string" }, "dealer_name": { "type": "string" }, "total_amount": { "type": "number" } } } }, "example": [ { "seller_name": "Seller 1", "dealer_name": "Dealer 1", "total_amount": 356.64 } ] } } } } } }, "/dealer/activations-by-status": { "get": { "summary": "Activations by Status", "operationId": "webservice-v2-get-dealer-activations-by-status", "tags": [ "Dashboard" ], "parameters": [ { "name": "month", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "05" } }, { "name": "year", "in": "query", "required": false, "description": "Parâmetro de consulta.", "schema": { "type": "string", "example": "2026" } } ], "responses": { "200": { "description": "Activations Month", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string" }, "color": { "type": "string" }, "total": { "type": "integer" }, "percentage": { "type": "integer" } } } }, "example": [ { "status": "Aberto", "color": "#F87315", "total": 3, "percentage": 75 }, { "status": "Concluído", "color": "#069668", "total": 1, "percentage": 25 } ] } } } } } }, "/dealer/sellers": { "get": { "summary": "Sellers", "operationId": "webservice-v2-get-dealer-sellers", "tags": [ "Dashboard" ], "responses": { "200": { "description": "Sellers", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "email": { "type": "string" }, "total_sales_amount": { "type": "number" }, "estimated_commission": { "type": "number" } } } }, "meta": { "type": "object", "properties": { "total_active_sellers": { "type": "integer" } } } } }, "example": { "data": [ { "name": "Seller 1", "email": "seller1@email.com", "total_sales_amount": 421.64, "estimated_commission": 42.16 } ], "meta": { "total_active_sellers": 2 } } } } } } } } } }