- Invoices: os blocos de preço das faturas (
totalPrice[]comtype,valueecurrency) agora trazem tambémusageTimeValue, o valor proporcional ao tempo em que a assinatura da loja ficou ativa no mês. Ovaluecontinua sendo o valor do mês cheio. Vale paraGET /partner/v2/{partnerId}/invoices,GET /partner/v2/{partnerId}/merchants/invoiceseGET /partner/v2/{partnerId}/resales/invoices(no resumo, nos itens e nos planos). Saiba mais - Invoices: os itens de
GET /partner/v2/merchants/invoiceseGET /partner/v2/resales/invoicespassam a trazer o valor em reais:totalPrice(mês cheio) etotalUsageTimePrice(proporcional aousageTime). Os dois campos só são enviados quando o token representa o parceiro dono da fatura; para token de revenda eles não aparecem, assim como otieredPricingRangesdometadata. Saiba mais - Invoices: novos tipos de item nas faturas:
GROWTH_DISCOUNT(descontos),INTEGRATION_MARKETING(integrações de marketing) eINTEGRATION_LOGISTIC(integrações de logística). Saiba mais - Resales:
POST /partner/v2/resales/{resaleId}/activate,PUT /partner/v2/resales/{resaleId}/subscriptionePUT /partner/v2/resales/{resaleId}/agreementCodepassam a ignorar oplanId, já que a assinatura de uma revenda não tem plano. Antes, enviarplanIdresultava em erro500. Saiba mais
- Catálogo: as opções (
options) agora retornam a imagem noGET /merchant/v3/{merchantId}, no mesmo formato dos produtos (image.urleimage.checksum). O campo só é enviado quando a opção possui imagem cadastrada. O envio de imagem para opções viamerchantUpdate,merchantUpsertemerchantForce(entityType: "OPTION") também passa a estar documentado. Saiba mais
- Fidelidade: o programa agora pode declarar limites comerciais de resgate por pedido em
capabilities.redemptionLimits(minemax, cada umfixedem BRL oupercent). Omitir o objeto, ou um dos limites, significa sem limite ali: programas existentes seguem permitindo 100%. O teto estrutural continua valendo sempre, e percentuais incidem sobre os itens do pedido, nunca sobre o total (frete e taxas não são resgatáveis). Saiba mais - Fidelidade: a resposta de saldo (
GET /v1/loyalty/accounts/{accountId}) passa a aceitar o mesmo objetoredemptionLimits, opcional, para operadores cujas regras variam por cliente. Quando presente, ele substitui integralmente os limites do programa para aquele cliente: não é merge campo a campo. Saiba mais
- Open Delivery: um mesmo app agora atende várias lojas. Declarando a extensão Open Delivery, cada loja que instala o app recebe um
client_secretpróprio (formatoods_..., oclient_idcontinua sendo o do app) e o token emitido com ele vale só para aquela loja. A configuração (merchantId, URL de webhook e endpoint de catálogo) passa a ser por loja, assim como o circuito de webhooks: uma loja com endpoint fora do ar não interrompe as entregas das demais. Saiba mais - Open Delivery: novo endpoint
GET /v1/merchantStatus?merchantId={id}para acompanhar o processamento assíncrono disparado pelomerchantUpdate. RetornalastRead,status(SUCCESS,PROCESSINGouFAIL) emoreInfocom o detalhe da falha. Saiba mais
- Catálogo: o campo
menudos produtos agora usa os tipos individuaisDELIVERY,TAKEOUTeINDOOR. O valor agregadoDELIVERY_TAKEOUTcontinua aceito no envio por retrocompatibilidade (expandido automaticamente paraDELIVERY+TAKEOUT) e ainda é devolvido nas respostas quando o produto tem entrega e retirada. Prefira os tipos individuais em novas integrações. Saiba mais
- Fidelidade: nova extensão de fidelidade para apps que operam programas de cashback: o cliente adere ao programa no checkout (com consentimento e PIN opcional), resgata saldo como desconto e acumula sobre pedidos concluídos. O app declara a extensão com uma
api_base_url, ativa o programa por lojista viaPUT /merchant/v3/{merchantId}/loyalty/confige implementa o contrato HTTP do operador (spec loyalty_operator.yaml). Requer o novo scopedv.loyaltyalém dood.all. Saiba mais - Order: o pedido agora pode trazer o bloco
loyalty(visível apenas para o app cujo programa o cliente aderiu), comaccountId,programIde oredemptiondo pedido (statusCONFIRMED/REVERSED). Saiba mais
- Signup: novo endpoint público
POST /partner/v2/{partnerId}/signupna API Partner para cadastrar lojas e contas de proprietários a partir de uma landing page. A resposta é a mesma para e-mail novo ou já cadastrado (proteção contra enumeração de usuários): a presença do campoentryUrlindica se a conta foi criada. Saiba mais
- Open Delivery: as datas da API Open Delivery agora são serializadas em UTC (RFC 3339, sufixo
Z, ex.:2026-08-10T17:39:28Z), conforme exigido pela spec OD. A API Merchant V3 segue usando UTC-3. Saiba mais - Events: os filtros
eventTypeeorderTypedos endpoints de polling (GET /merchant/v3/events:pollingeGET /v1/events:pollingdo Open Delivery) seguem a serialização de arrays da spec OpenAPI (style: form,explode: true): repita o parâmetro na query, sem colchetes, ex.:?eventType=CREATED&eventType=CANCELLED. Valores inválidos retornam403 Forbidden. Saiba mais
- Events: o endpoint
GET /merchant/v3/events:pollingagora retorna no máximo 100 eventos por chamada, sempre do mais antigo para o mais recente. Se a resposta vier com 100 eventos, envie o acknowledgment e chame o polling novamente em seguida, sem aguardar o intervalo usual, até receber menos de 100 eventos (ou204 No Content). Integrações que precisam de eventos em tempo real devem considerar os webhooks como canal principal. Saiba mais
- Webhooks: agora a API Merchant pode enviar os eventos de pedido e de indoor em tempo real para uma URL sua, como complemento ao polling. Configure a URL de notificação no painel e valide a assinatura
X-App-Signature. Saiba mais - Deprecations: o prazo de descontinuação das rotas em deprecação (Merchant v1/v2, Tabs
available/unavailablee Invoices/Agreement Code da Partner v2) foi adiado para 01/08/2026. As rotas da Partner v1 já foram removidas e retornam410 Gone. Saiba mais
- Places: com os novos modos de Mesa e Comanda, agora é possível abrir ou fechar uma mesa para consumo. Saiba mais
- Order: novos atributos no objeto
indoordo pedido para suportar os modos de Mesa e Comanda. Saiba mais - Event: novos atributos nos eventos para suportar os modos de Mesa e Comanda. Saiba mais
- Deprecations: as rotas
availableeunavailabledas comandas entram em descontinuação. Saiba mais
- Plans: implementamos um novo sistema de cobrança: toda assinatura agora deve estar vinculada a um plano de cobrança específico. Saiba mais
- Invoices: com a mudança no modelo de cobrança, o módulo de Invoices foi reestruturado. Agora é possível listar as faturas de cada merchant para verificar o plano associado, o consumo de recursos e os valores calculados pela nova tabela de preços. Saiba mais
- Deprecations: para acomodar o novo sistema de cobrança, algumas rotas e versões de API serão descontinuadas. Consulte Deprecations para a lista completa e os prazos de remoção.
- Catalog & Services: no
merchantUpdatee nomerchantUpsert, oentityTypeMODIFIERfoi removido. Ele agora fica dentro deITEM, que deve ser usado para manter o modifier atualizado. - Catalog & Services: agora é possível adicionar os métodos de pagamento pela API.
- SalesChannel: novo campo
salesChannelnos pedidos. Saiba mais
- Descontos: novos endpoints para adicionar, atualizar e remover descontos de um merchant na API Merchant. Saiba mais
- Listar pedidos: novo endpoint para listar os pedidos de um merchant na API Merchant. Saiba mais
- Faturas dos merchants: novo endpoint para listar as faturas do ano e mês dos merchants na API Partner. Saiba mais
- Faturas das revendas: novo endpoint para listar as faturas do ano e mês das revendas na API Partner. Saiba mais
- Order:
placeNameetabIdadicionados quando o pedido é do tipoINDOOR. Saiba mais - Order events:
merchantIdadicionado aos eventos. Saiba mais - Indoor events:
merchantId,tabId,tabCodeetabNameadicionados. Saiba mais - Assinatura: nova rota para avisar um merchant sobre um possível bloqueio. Saiba mais
- Revenda: nova API para gerenciar as revendas. Saiba mais
- Recursos: nova API para gerenciar os recursos dos merchants. Saiba mais
- Catalog & Services: entidade
MODIFIERadicionada aomerchantUpdatee aomerchantUpsert. Saiba mais
- Catalog & Services: agora é possível atualizar, inserir e administrar o catálogo de um merchant pela API. Saiba mais
- Order events: o polling de eventos passa a aceitar o filtro
orderType. Saiba mais - Listar merchants: a lista de merchants passa a aceitar o filtro por
identifier. Saiba mais
- Order API: agora é possível fazer o tracking de um pedido. Saiba mais
- Partner API: agora é possível adicionar ou remover a permissão de uma aplicação para um merchant. Saiba mais
- Merchant Tools: agora é possível saber a taxa de entrega a partir de uma latitude e longitude. Saiba mais
- Merchant Indoor: agora é possível receber pedidos e cadastrar comandas do tipo indoor. Saiba mais
- MagicLink: agora é possível logar um membro sem senha. Saiba mais
- Membros: agora é possível listar, adicionar, atualizar e remover membros de um merchant. Saiba mais
- Cadastrar merchant: agora é possível adicionar um merchant a um partner. Saiba mais
- Novo filtro: ao listar merchants ou vendas, agora é possível filtrar só os merchants dos partners desejados. Saiba mais
- Nova order action: nova ação
deliveredna API de pedidos. Saiba mais
- Partner API V2: com ela é possível controlar as assinaturas dos merchants e acompanhar o faturamento delas. Saiba mais