{"info":{"_postman_id":"0899c8f7-e09d-4227-adb2-a5dc562d6899","name":"Documentação Luna Checkout","description":"

Documentação dos Webhooks da plataforma Luna Checkout.

URL da API: https://api.lunacheckout.com

Os webhooks permitem que sua aplicação receba notificações em tempo real sobre eventos que acontecem no checkout, como vendas, pagamentos, abandonos de carrinho, processamento/expedição e atualizações de rastreio.

Como funciona

Configure uma URL de webhook no painel da Luna Checkout
\n
Selecione os eventos que deseja receber
\n
A Luna Checkout enviará um POST com payload JSON para sua URL sempre que o evento ocorrer
\n

Configuração de Webhooks

Endpoint: POST https://api.lunacheckout.com/stores/{store_uuid}/webhooks

{\n    \"url\": \"https://sua-url.com/webhook\",\n    \"description\": \"Meu webhook\",\n    \"active\": 1,\n    \"event_sale_approved\": 1,\n    \"event_sale_waiting_payment\": 1,\n    \"event_sale_refused\": 1,\n    \"event_sale_chargeback\": 1,\n    \"event_sale_refunded\": 1,\n    \"event_sale_cancelled\": 1,\n    \"event_cart_abandoned\": 1,\n    \"event_sale_cart_recovered\": 1,\n    \"event_sale_partially_processed\": 1,\n    \"event_sale_processed\": 1,\n    \"event_tracking_posted\": 1,\n    \"event_tracking_in_transit\": 1,\n    \"event_tracking_out_for_delivery\": 1,\n    \"event_tracking_delivered\": 1,\n    \"event_tracking_cancelled\": 1,\n    \"event_tracking_returned\": 1\n}\n\n

Autenticação

Os webhooks são enviados via POST com Content-Type: application/json. Não há header de autenticação — recomenda-se validar pelo conteúdo do payload (ex: verificar se o id da venda existe).

Retry

O sistema possui proteção contra duplicatas via idempotência. Cada combinação de evento + URL + pedido é enviada apenas uma vez.

Eventos de Venda

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Evento	Descrição
`sale_approved`	Pagamento aprovado/confirmado
`sale_pending`	Venda criada (aguardando pagamento)
`sale_waiting_payment`	Aguardando confirmação do pagamento
`sale_refused`	Pagamento recusado pelo gateway
`sale_chargeback`	Chargeback recebido
`sale_refunded`	Pagamento estornado
`sale_cancelled`	Venda cancelada
`sale_cart_abandoned`	Carrinho abandonado (cliente não finalizou)
`sale_cart_recovered`	Carrinho recuperado (cliente retornou e comprou)
`sale_partially_processed`	Pedido parcialmente processado (parte dos itens foi expedida em 1+ pacote). Inclui o array `packages` com os pacotes já gerados
`sale_processed`	Pedido totalmente processado (todos os itens foram expedidos). Inclui o array `packages` completo

Eventos de Rastreio

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Evento	Descrição
`tracking_posted`	Pedido postado/despachado na transportadora
`tracking_in_transit`	Pedido em trânsito
`tracking_out_for_delivery`	Pedido saiu para entrega
`tracking_delivered`	Pedido entregue ao destinatário
`tracking_cancelled`	Envio cancelado
`tracking_returned`	Pedido devolvido ao remetente

Payload Completo

Campos Principais

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`id`	`string`	ID interno da venda. Para carrinhos sem pedido, será `\"c-{cart_id}\"`
`event`	`string`	Nome do evento
`amount`	`number`	Valor total da venda (em reais)
`method`	`string`	Método de pagamento: `pix`, `card`, `bankslip`, `debit`
`checkout_url`	`string/null`	URL completa do checkout
`status`	`string`	Status do pagamento: `paid`, `pending`, `waiting_payment`, `refused`, `refunded`

Objeto `client`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`name`	`string`	Nome completo
`email`	`string`	E-mail
`phone`	`string`	Telefone com DDI (ex: `5511999999999`)
`doc`	`string`	CPF/CNPJ (somente números)

Objeto `tracking`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`status`	`string`	Status: `pending`, `posted`, `in_transit`, `out_for_delivery`, `delivered`, `cancelled`, `returned`
`status_label`	`string`	Label em português: `Postado`, `Em Trânsito`, etc.
`tracking_code`	`string/null`	Código de rastreio
`shipping_company`	`string/null`	Transportadora
`expected_delivery_date`	`string/null`	Data prevista de entrega
`fee`	`number`	Valor do frete

Objeto `address`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`street`	`string`	Rua/Logradouro
`number`	`string`	Número
`complement`	`string`	Complemento
`neighborhood`	`string`	Bairro
`city`	`string`	Cidade
`state`	`string`	Estado (UF)
`zipcode`	`string`	CEP

Objeto `utm`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`src`	`string/null`	Parâmetro `src`
`sck`	`string/null`	Parâmetro `sck`
`utm_source`	`string/null`	Origem do tráfego
`utm_campaign`	`string/null`	Campanha
`utm_medium`	`string/null`	Meio
`utm_content`	`string/null`	Conteúdo
`utm_term`	`string/null`	Termo de busca
`click_id`	`string/null`	ID do clique

Array `items[]`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`id`	`string`	ID do produto
`name`	`string`	Nome do produto
`variant`	`string`	Variação selecionada
`description`	`string`	Mesma info de variant
`quantity`	`number`	Quantidade
`price`	`number`	Preço unitário (reais)
`width`	`number`	Largura cm (com embalagem)
`height`	`number`	Altura cm (com embalagem)
`weight`	`number`	Peso gramas (com embalagem)
`length`	`number`	Comprimento cm (com embalagem)

Array `packages[]`

O array packages é enviado em todos os webhooks e representa os pacotes físicos gerados para o pedido (tabela orders_packages). Para pedidos que ainda não foram processados/expedidos, o array virá vazio ([]). Cada item representa 1 pacote com seu próprio código de rastreio e a lista dos produtos que ele contém.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`uuid`	`string/null`	UUID do pacote
`tracking_code`	`string/null`	Código de rastreio do pacote
`tracking_link`	`string/null`	URL de rastreio
`tracking_company`	`string/null`	Transportadora do pacote
`invoice_key`	`string/null`	Chave da NF-e (44 dígitos)
`created_at`	`string`	Data de criação do pacote
`updated_at`	`string`	Data da última atualização do pacote
`items[]`	`array`	Itens incluídos neste pacote (ver abaixo)

Array `packages[].items[]`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`id`	`number`	ID do produto (bate com `items[].id` do payload)
`name`	`string/null`	Nome do produto
`variant`	`string/null`	Variação selecionada
`price`	`number/null`	Preço unitário (reais)
`quantity`	`number`	Quantidade neste pacote
`quantity_total`	`number`	Quantidade total desse produto no pedido

Objeto `payment`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`status`	`string`	Status do pagamento
`qrcode`	`string/null`	Código PIX copia-e-cola
`created_at`	`string`	Data criação do pedido
`paid_at`	`string/null`	Data confirmação (só quando paid)
`reason_status`	`string/null`	Motivo da recusa

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"44514406","collectionId":"0899c8f7-e09d-4227-adb2-a5dc562d6899","publishedId":"2sBXqFNNW7","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-22T16:36:37.000Z"},"item":[{"name":"Webhooks de Venda","item":[{"name":"Venda Aprovada (sale_approved)","id":"cc407d6e-58f1-4758-9f33-a960e66eb597","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234567\",\n \"event\": \"sale_approved\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto?utm_source=google&utm_campaign=black-friday\",\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"tracking\": {\n \"status\": \"pending\",\n \"status_label\": \"pending\",\n \"tracking_code\": null,\n \"shipping_company\": null,\n \"expected_delivery_date\": null,\n \"fee\": 15.90\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"utm\": {\n \"src\": \"google\",\n \"sck\": null,\n \"utm_source\": \"google\",\n \"utm_campaign\": \"black-friday\",\n \"utm_medium\": \"cpc\",\n \"utm_content\": \"banner-topo\",\n \"utm_term\": \"comprar produto\",\n \"click_id\": \"abc123\"\n },\n \"checkout_query_params\": {\n \"product\": \"uuid-do-produto\",\n \"utm_source\": \"google\"\n },\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"width\": 20,\n \"height\": 5,\n \"weight\": 300,\n \"length\": 30,\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n },\n {\n \"id\": \"1002\",\n \"name\": \"Boné Esportivo\",\n \"width\": 15,\n \"height\": 10,\n \"weight\": 150,\n \"length\": 20,\n \"variant\": \"Cor Preta / Tamanho Único\",\n \"description\": \"Cor Preta / Tamanho Único\",\n \"quantity\": 1,\n \"price\": 49.90\n }\n ],\n \"packages\": [],\n \"amount\": 209.70,\n \"method\": \"pix\",\n \"status\": \"paid\",\n \"payment\": {\n \"status\": \"paid\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T10:30:00\",\n \"paid_at\": \"2026-03-09T10:32:15\",\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pagamento é aprovado/confirmado. Este é o evento mais importante — indica que o dinheiro foi recebido e o pedido pode ser processado/enviado.

O array packages virá vazio ([]) até que o pedido seja processado/expedido (ver eventos sale_partially_processed e sale_processed).

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"cc407d6e-58f1-4758-9f33-a960e66eb597"},{"name":"Aguardando Pagamento (sale_waiting_payment)","id":"aa1f7106-e90f-48ea-8f35-134b8722972d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234567\",\n \"event\": \"sale_waiting_payment\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"Maria Oliveira\",\n \"phone\": \"5521988888888\",\n \"email\": \"maria@example.com\",\n \"doc\": \"98765432100\"\n },\n \"tracking\": {\n \"status\": \"pending\",\n \"status_label\": \"pending\",\n \"tracking_code\": null,\n \"shipping_company\": null,\n \"expected_delivery_date\": null,\n \"fee\": 0\n },\n \"address\": {\n \"street\": \"Av Brasil\",\n \"number\": \"456\",\n \"complement\": \"\",\n \"neighborhood\": \"Copacabana\",\n \"city\": \"Rio de Janeiro\",\n \"state\": \"RJ\",\n \"zipcode\": \"22041080\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": null,\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"2001\",\n \"name\": \"Tênis Running\",\n \"width\": 25,\n \"height\": 15,\n \"weight\": 500,\n \"length\": 35,\n \"variant\": \"Preto / 42\",\n \"description\": \"Preto / 42\",\n \"quantity\": 1,\n \"price\": 299.90\n }\n ],\n \"packages\": [],\n \"amount\": 299.90,\n \"method\": \"pix\",\n \"status\": \"waiting_payment\",\n \"payment\": {\n \"status\": \"waiting_payment\",\n \"qrcode\": \"00020126580014br.gov.bcb.pix0136...\",\n \"created_at\": \"2026-03-09T14:00:00\",\n \"paid_at\": null,\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido está aguardando pagamento (ex: PIX gerado mas ainda não pago, boleto emitido).

O array packages virá sempre vazio ([]) — o pedido ainda não foi pago nem processado.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"aa1f7106-e90f-48ea-8f35-134b8722972d"},{"name":"Venda Recusada (sale_refused)","id":"846781dd-bfa7-404c-8947-46b58c700590","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234568\",\n \"event\": \"sale_refused\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"Carlos Souza\",\n \"phone\": \"5531977777777\",\n \"email\": \"carlos@example.com\",\n \"doc\": \"11122233344\"\n },\n \"tracking\": {\n \"status\": \"pending\",\n \"status_label\": \"pending\",\n \"tracking_code\": null,\n \"shipping_company\": null,\n \"expected_delivery_date\": null,\n \"fee\": 0\n },\n \"address\": {\n \"street\": \"Rua Minas Gerais\",\n \"number\": \"789\",\n \"complement\": \"Sala 3\",\n \"neighborhood\": \"Savassi\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zipcode\": \"30130150\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": \"instagram\",\n \"utm_campaign\": null,\n \"utm_medium\": \"social\",\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"3001\",\n \"name\": \"Smartwatch Pro\",\n \"width\": 10,\n \"height\": 8,\n \"weight\": 200,\n \"length\": 10,\n \"variant\": \"Preto\",\n \"description\": \"Preto\",\n \"quantity\": 1,\n \"price\": 599.90\n }\n ],\n \"packages\": [],\n \"amount\": 599.90,\n \"method\": \"card\",\n \"status\": \"refused\",\n \"payment\": {\n \"status\": \"refused\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T16:00:00\",\n \"paid_at\": null,\n \"reason_status\": \"Cartão recusado pelo emissor\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pagamento é recusado pelo gateway. O campo payment.reason_status contém o motivo da recusa.

O array packages virá sempre vazio ([]) — nada foi expedido.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"846781dd-bfa7-404c-8947-46b58c700590"},{"name":"Estorno (sale_refunded)","id":"b73d35aa-14f3-4bdd-aa33-c0e14860dc01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234567\",\n \"event\": \"sale_refunded\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"tracking\": {\n \"status\": \"pending\",\n \"status_label\": \"pending\",\n \"tracking_code\": null,\n \"shipping_company\": null,\n \"expected_delivery_date\": null,\n \"fee\": 15.90\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": null,\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"width\": 20,\n \"height\": 5,\n \"weight\": 300,\n \"length\": 30,\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n }\n ],\n \"packages\": [],\n \"amount\": 159.80,\n \"method\": \"pix\",\n \"status\": \"refunded\",\n \"payment\": {\n \"status\": \"refunded\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T10:30:00\",\n \"paid_at\": \"2026-03-09T10:32:15\",\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pagamento é estornado.

Se o pedido já havia sido processado/expedido antes do estorno, o array packages virá preenchido com os pacotes gerados; caso contrário, virá vazio ([]).

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"b73d35aa-14f3-4bdd-aa33-c0e14860dc01"},{"name":"Chargeback (sale_chargeback)","id":"9a37531e-ab04-41f5-8985-ca804bc8f2f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234569\",\n \"event\": \"sale_chargeback\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"Pedro Lima\",\n \"phone\": \"5541966666666\",\n \"email\": \"pedro@example.com\",\n \"doc\": \"55566677788\"\n },\n \"tracking\": {\n \"status\": \"delivered\",\n \"status_label\": \"Entregue\",\n \"tracking_code\": \"BR123456789\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": null,\n \"fee\": 20.00\n },\n \"address\": {\n \"street\": \"Rua Paraná\",\n \"number\": \"100\",\n \"complement\": \"\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Curitiba\",\n \"state\": \"PR\",\n \"zipcode\": \"80010000\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": null,\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"4001\",\n \"name\": \"Notebook Gamer\",\n \"width\": 40,\n \"height\": 5,\n \"weight\": 2500,\n \"length\": 30,\n \"variant\": \"16GB RAM / 512GB SSD\",\n \"description\": \"16GB RAM / 512GB SSD\",\n \"quantity\": 1,\n \"price\": 4999.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d\",\n \"tracking_code\": \"BR123456789\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR123456789\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000001231234567890\",\n \"created_at\": \"2026-03-02T10:00:00\",\n \"updated_at\": \"2026-03-05T16:45:00\",\n \"items\": [\n {\n \"id\": 4001,\n \"name\": \"Notebook Gamer\",\n \"variant\": \"16GB RAM / 512GB SSD\",\n \"price\": 4999.90,\n \"quantity\": 1,\n \"quantity_total\": 1\n }\n ]\n }\n ],\n \"amount\": 4999.90,\n \"method\": \"card\",\n \"status\": \"refunded\",\n \"payment\": {\n \"status\": \"refunded\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-01T09:00:00\",\n \"paid_at\": \"2026-03-01T09:01:30\",\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando ocorre um chargeback (contestação do pagamento pelo titular do cartão).

Como o chargeback geralmente acontece após o pedido já estar processado/expedido, o array packages costuma vir preenchido.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"9a37531e-ab04-41f5-8985-ca804bc8f2f9"},{"name":"Venda Cancelada (sale_cancelled)","id":"0382216e-a1fa-4fc3-ad7f-a9ff7b0c78f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234570\",\n \"event\": \"sale_cancelled\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"Ana Costa\",\n \"phone\": \"5561955555555\",\n \"email\": \"ana@example.com\",\n \"doc\": \"99988877766\"\n },\n \"tracking\": {\n \"status\": \"pending\",\n \"status_label\": \"pending\",\n \"tracking_code\": null,\n \"shipping_company\": null,\n \"expected_delivery_date\": null,\n \"fee\": 0\n },\n \"address\": {\n \"street\": \"SQN 310\",\n \"number\": \"B\",\n \"complement\": \"Apto 201\",\n \"neighborhood\": \"Asa Norte\",\n \"city\": \"Brasília\",\n \"state\": \"DF\",\n \"zipcode\": \"70756100\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": null,\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"5001\",\n \"name\": \"Fone Bluetooth\",\n \"width\": 10,\n \"height\": 5,\n \"weight\": 100,\n \"length\": 10,\n \"variant\": \"Branco\",\n \"description\": \"Branco\",\n \"quantity\": 1,\n \"price\": 149.90\n }\n ],\n \"packages\": [],\n \"amount\": 149.90,\n \"method\": \"pix\",\n \"status\": \"refused\",\n \"payment\": {\n \"status\": \"refused\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T18:00:00\",\n \"paid_at\": null,\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando uma venda é cancelada.

O array packages vem vazio ([]) quando a venda é cancelada antes do processamento; se houver pacotes já gerados, eles virão preenchidos.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"0382216e-a1fa-4fc3-ad7f-a9ff7b0c78f9"},{"name":"Carrinho Abandonado (sale_cart_abandoned)","id":"3abe150f-6a31-4c05-90a0-233f9bbc6e16","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"c-9876543\",\n \"event\": \"sale_cart_abandoned\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto?utm_source=facebook\",\n \"client\": {\n \"name\": \"Lucas Santos\",\n \"phone\": \"5571944444444\",\n \"email\": \"lucas@example.com\",\n \"doc\": \"44455566677\"\n },\n \"tracking\": {\n \"status\": null,\n \"status_label\": null,\n \"tracking_code\": null,\n \"shipping_company\": null,\n \"expected_delivery_date\": null,\n \"fee\": 0\n },\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"\",\n \"neighborhood\": \"Barra\",\n \"city\": \"Salvador\",\n \"state\": \"BA\",\n \"zipcode\": \"40140000\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": \"facebook\",\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {\n \"product\": \"uuid-do-produto\",\n \"utm_source\": \"facebook\"\n },\n \"items\": [\n {\n \"id\": \"6001\",\n \"name\": \"Kit Skincare\",\n \"width\": 15,\n \"height\": 10,\n \"weight\": 400,\n \"length\": 20,\n \"variant\": \"Kit Completo\",\n \"description\": \"Kit Completo\",\n \"quantity\": 1,\n \"price\": 189.90\n }\n ],\n \"packages\": [],\n \"amount\": 189.90,\n \"method\": null,\n \"status\": \"pending\",\n \"payment\": {\n \"status\": null,\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T20:00:00\",\n \"paid_at\": null,\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando um carrinho é abandonado (cliente não finalizou a compra). Note que o id começa com c- indicando que é um ID de carrinho, não de pedido. O method e payment.status podem ser null.

O array packages virá sempre vazio ([]).

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"3abe150f-6a31-4c05-90a0-233f9bbc6e16"},{"name":"Carrinho Recuperado (sale_cart_recovered)","id":"67f9bccb-eb25-4775-8425-15dc4fb4c9ed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234571\",\n \"event\": \"sale_cart_recovered\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"Lucas Santos\",\n \"phone\": \"5571944444444\",\n \"email\": \"lucas@example.com\",\n \"doc\": \"44455566677\"\n },\n \"tracking\": {\n \"status\": \"pending\",\n \"status_label\": \"pending\",\n \"tracking_code\": null,\n \"shipping_company\": null,\n \"expected_delivery_date\": null,\n \"fee\": 12.50\n },\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"\",\n \"neighborhood\": \"Barra\",\n \"city\": \"Salvador\",\n \"state\": \"BA\",\n \"zipcode\": \"40140000\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": \"facebook\",\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"6001\",\n \"name\": \"Kit Skincare\",\n \"width\": 15,\n \"height\": 10,\n \"weight\": 400,\n \"length\": 20,\n \"variant\": \"Kit Completo\",\n \"description\": \"Kit Completo\",\n \"quantity\": 1,\n \"price\": 189.90\n }\n ],\n \"packages\": [],\n \"amount\": 189.90,\n \"method\": \"pix\",\n \"status\": \"paid\",\n \"payment\": {\n \"status\": \"paid\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T20:00:00\",\n \"paid_at\": \"2026-03-10T08:15:30\",\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando um carrinho que havia sido abandonado é recuperado (cliente voltou e finalizou a compra).

O array packages virá vazio ([]) até que o pedido seja processado/expedido.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"67f9bccb-eb25-4775-8425-15dc4fb4c9ed"},{"name":"Venda Parcialmente Processada (sale_partially_processed)","id":"cc011869-5dce-497e-9179-f007055a52f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234572\",\n \"event\": \"sale_partially_processed\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"tracking\": {\n \"status\": \"posted\",\n \"status_label\": \"Postado\",\n \"tracking_code\": \"BR111111111\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": \"2026-03-20\",\n \"fee\": 18.50\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": null,\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"width\": 20,\n \"height\": 5,\n \"weight\": 300,\n \"length\": 30,\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n },\n {\n \"id\": \"1002\",\n \"name\": \"Boné Esportivo\",\n \"width\": 15,\n \"height\": 10,\n \"weight\": 150,\n \"length\": 20,\n \"variant\": \"Cor Preta / Tamanho Único\",\n \"description\": \"Cor Preta / Tamanho Único\",\n \"quantity\": 1,\n \"price\": 49.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"11111111-2222-3333-4444-555555555555\",\n \"tracking_code\": \"BR111111111\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR111111111\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000011111234567890\",\n \"created_at\": \"2026-03-10T09:30:00\",\n \"updated_at\": \"2026-03-10T09:30:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 1,\n \"quantity_total\": 2\n }\n ]\n }\n ],\n \"amount\": 209.70,\n \"method\": \"pix\",\n \"status\": \"paid\",\n \"payment\": {\n \"status\": \"paid\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T10:30:00\",\n \"paid_at\": \"2026-03-09T10:32:15\",\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido é parcialmente processado — parte dos itens foi expedida em 1+ pacote, mas ainda restam itens a serem enviados.

O array packages contém somente os pacotes já gerados (pode haver um, dois ou mais). Compare packages[].items[].quantity (quantidade neste pacote) com packages[].items[].quantity_total (quantidade total pedida) para identificar o que ainda falta expedir.

O evento é disparado sempre que um novo pacote é criado e ainda sobra item por expedir.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"cc011869-5dce-497e-9179-f007055a52f1"},{"name":"Venda Processada (sale_processed)","id":"611d60e8-f1a1-4f71-978b-4885f6076d94","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1234572\",\n \"event\": \"sale_processed\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"tracking\": {\n \"status\": \"posted\",\n \"status_label\": \"Postado\",\n \"tracking_code\": \"BR222222222\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": \"2026-03-20\",\n \"fee\": 18.50\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"utm\": {\n \"src\": null,\n \"sck\": null,\n \"utm_source\": null,\n \"utm_campaign\": null,\n \"utm_medium\": null,\n \"utm_content\": null,\n \"utm_term\": null,\n \"click_id\": null\n },\n \"checkout_query_params\": {},\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"width\": 20,\n \"height\": 5,\n \"weight\": 300,\n \"length\": 30,\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n },\n {\n \"id\": \"1002\",\n \"name\": \"Boné Esportivo\",\n \"width\": 15,\n \"height\": 10,\n \"weight\": 150,\n \"length\": 20,\n \"variant\": \"Cor Preta / Tamanho Único\",\n \"description\": \"Cor Preta / Tamanho Único\",\n \"quantity\": 1,\n \"price\": 49.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"11111111-2222-3333-4444-555555555555\",\n \"tracking_code\": \"BR111111111\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR111111111\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000011111234567890\",\n \"created_at\": \"2026-03-10T09:30:00\",\n \"updated_at\": \"2026-03-10T09:30:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 1,\n \"quantity_total\": 2\n }\n ]\n },\n {\n \"uuid\": \"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\n \"tracking_code\": \"BR222222222\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR222222222\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000022221234567890\",\n \"created_at\": \"2026-03-11T14:00:00\",\n \"updated_at\": \"2026-03-11T14:00:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 1,\n \"quantity_total\": 2\n },\n {\n \"id\": 1002,\n \"name\": \"Boné Esportivo\",\n \"variant\": \"Cor Preta / Tamanho Único\",\n \"price\": 49.90,\n \"quantity\": 1,\n \"quantity_total\": 1\n }\n ]\n }\n ],\n \"amount\": 209.70,\n \"method\": \"pix\",\n \"status\": \"paid\",\n \"payment\": {\n \"status\": \"paid\",\n \"qrcode\": null,\n \"created_at\": \"2026-03-09T10:30:00\",\n \"paid_at\": \"2026-03-09T10:32:15\",\n \"reason_status\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido é totalmente processado — todos os itens foram expedidos em pacotes.

O array packages vem completo, contendo todos os pacotes do pedido com seus códigos de rastreio, transportadora, chave da NF-e e a lista exata dos produtos (e quantidades) incluídos em cada pacote.

Use este evento como gatilho para liberar acesso a produtos digitais, disparar e-mails de confirmação de expedição, atualizar o painel do cliente final etc.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"611d60e8-f1a1-4f71-978b-4885f6076d94"}],"id":"dce88f30-592b-432b-b07a-68dfeba60879","description":"

Exemplos de payloads dos webhooks de eventos de venda. Esses webhooks são enviados via POST para a URL configurada sempre que um evento de venda ocorre.

Todos os payloads incluem o array packages (pacotes físicos gerados para o pedido). Em eventos anteriores ao processamento, o array virá vazio ([]); nos eventos sale_partially_processed e sale_processed, o array trará os pacotes com código de rastreio e itens agrupados.

\n","_postman_id":"dce88f30-592b-432b-b07a-68dfeba60879"},{"name":"Webhooks de Rastreio","item":[{"name":"Pedido Postado (tracking_posted)","id":"366f5647-fc8f-49df-af85-054e0d0e16c5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": 1234567,\n \"event\": \"tracking_posted\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"tracking\": {\n \"status\": \"posted\",\n \"status_label\": \"Postado\",\n \"tracking_code\": \"BR123456789\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": \"2026-03-15\",\n \"fee\": 15.90\n },\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d\",\n \"tracking_code\": \"BR123456789\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR123456789\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000001231234567890\",\n \"created_at\": \"2026-03-09T14:00:00\",\n \"updated_at\": \"2026-03-09T14:00:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 2,\n \"quantity_total\": 2\n }\n ]\n }\n ],\n \"amount\": 159.80,\n \"method\": \"pix\",\n \"status\": \"paid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido é postado/despachado na transportadora. O campo tracking.tracking_code contém o código de rastreio.

O array packages traz o(s) pacote(s) do pedido com seus respectivos códigos de rastreio e itens.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"366f5647-fc8f-49df-af85-054e0d0e16c5"},{"name":"Em Trânsito (tracking_in_transit)","id":"6c3002eb-d9ae-48e7-b809-1743e8097ea7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": 1234567,\n \"event\": \"tracking_in_transit\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"tracking\": {\n \"status\": \"in_transit\",\n \"status_label\": \"Em Trânsito\",\n \"tracking_code\": \"BR123456789\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": \"2026-03-15\",\n \"fee\": 15.90\n },\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d\",\n \"tracking_code\": \"BR123456789\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR123456789\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000001231234567890\",\n \"created_at\": \"2026-03-09T14:00:00\",\n \"updated_at\": \"2026-03-11T08:20:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 2,\n \"quantity_total\": 2\n }\n ]\n }\n ],\n \"amount\": 159.80,\n \"method\": \"pix\",\n \"status\": \"paid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido está em trânsito.

O array packages traz o(s) pacote(s) do pedido com seus respectivos códigos de rastreio e itens.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"6c3002eb-d9ae-48e7-b809-1743e8097ea7"},{"name":"Saiu para Entrega (tracking_out_for_delivery)","id":"57efbd96-0fb4-4db7-a4bf-faf86d22c0f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": 1234567,\n \"event\": \"tracking_out_for_delivery\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"tracking\": {\n \"status\": \"out_for_delivery\",\n \"status_label\": \"Saiu para Entrega\",\n \"tracking_code\": \"BR123456789\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": \"2026-03-15\",\n \"fee\": 15.90\n },\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d\",\n \"tracking_code\": \"BR123456789\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR123456789\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000001231234567890\",\n \"created_at\": \"2026-03-09T14:00:00\",\n \"updated_at\": \"2026-03-15T07:10:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 2,\n \"quantity_total\": 2\n }\n ]\n }\n ],\n \"amount\": 159.80,\n \"method\": \"pix\",\n \"status\": \"paid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido saiu para entrega.

O array packages traz o(s) pacote(s) do pedido com seus respectivos códigos de rastreio e itens.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"57efbd96-0fb4-4db7-a4bf-faf86d22c0f4"},{"name":"Entregue (tracking_delivered)","id":"f662a0cc-e8e3-48c9-a3b8-90c1cd3fbe97","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": 1234567,\n \"event\": \"tracking_delivered\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"tracking\": {\n \"status\": \"delivered\",\n \"status_label\": \"Entregue\",\n \"tracking_code\": \"BR123456789\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": \"2026-03-15\",\n \"fee\": 15.90\n },\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d\",\n \"tracking_code\": \"BR123456789\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR123456789\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000001231234567890\",\n \"created_at\": \"2026-03-09T14:00:00\",\n \"updated_at\": \"2026-03-15T16:45:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 2,\n \"quantity_total\": 2\n }\n ]\n }\n ],\n \"amount\": 159.80,\n \"method\": \"pix\",\n \"status\": \"paid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido é entregue ao destinatário.

O array packages traz o(s) pacote(s) do pedido com seus respectivos códigos de rastreio e itens.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"f662a0cc-e8e3-48c9-a3b8-90c1cd3fbe97"},{"name":"Envio Cancelado (tracking_cancelled)","id":"3cd537fc-b91f-40d5-98e6-10d06d2f2c17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": 1234567,\n \"event\": \"tracking_cancelled\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"tracking\": {\n \"status\": \"cancelled\",\n \"status_label\": \"Cancelado\",\n \"tracking_code\": \"BR123456789\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": null,\n \"fee\": 15.90\n },\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d\",\n \"tracking_code\": \"BR123456789\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR123456789\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000001231234567890\",\n \"created_at\": \"2026-03-09T14:00:00\",\n \"updated_at\": \"2026-03-12T11:20:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 2,\n \"quantity_total\": 2\n }\n ]\n }\n ],\n \"amount\": 159.80,\n \"method\": \"pix\",\n \"status\": \"paid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o envio é cancelado.

O array packages traz o(s) pacote(s) do pedido com seus respectivos códigos de rastreio e itens.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"3cd537fc-b91f-40d5-98e6-10d06d2f2c17"},{"name":"Devolvido (tracking_returned)","id":"1d62695c-c3aa-4824-9751-dc4986e8b140","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": 1234567,\n \"event\": \"tracking_returned\",\n \"checkout_url\": \"https://loja.lunacheckout.com/produto\",\n \"tracking\": {\n \"status\": \"returned\",\n \"status_label\": \"Devolvido\",\n \"tracking_code\": \"BR123456789\",\n \"shipping_company\": \"Correios\",\n \"expected_delivery_date\": null,\n \"fee\": 15.90\n },\n \"client\": {\n \"name\": \"João da Silva\",\n \"phone\": \"5511999999999\",\n \"email\": \"joao@example.com\",\n \"doc\": \"12345678900\"\n },\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"complement\": \"Apto 45\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01001000\"\n },\n \"items\": [\n {\n \"id\": \"1001\",\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"description\": \"Cor Azul / Tamanho M\",\n \"quantity\": 2,\n \"price\": 79.90\n }\n ],\n \"packages\": [\n {\n \"uuid\": \"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d\",\n \"tracking_code\": \"BR123456789\",\n \"tracking_link\": \"https://rastreio.correios.com.br/app/index.php?objeto=BR123456789\",\n \"tracking_company\": \"Correios\",\n \"invoice_key\": \"35240812345678901234550010000001231234567890\",\n \"created_at\": \"2026-03-09T14:00:00\",\n \"updated_at\": \"2026-03-18T09:00:00\",\n \"items\": [\n {\n \"id\": 1001,\n \"name\": \"Camiseta Premium\",\n \"variant\": \"Cor Azul / Tamanho M\",\n \"price\": 79.90,\n \"quantity\": 2,\n \"quantity_total\": 2\n }\n ]\n }\n ],\n \"amount\": 159.80,\n \"method\": \"pix\",\n \"status\": \"paid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sua-url.com/webhook","description":"

Webhook enviado quando o pedido é devolvido ao remetente.

O array packages traz o(s) pacote(s) do pedido com seus respectivos códigos de rastreio e itens.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"1d62695c-c3aa-4824-9751-dc4986e8b140"}],"id":"714579c4-4029-48b8-8b14-cc9ddb52d15f","description":"

Exemplos de payloads dos webhooks de rastreio. Diferente dos webhooks de venda, os de rastreio incluem o objeto tracking com dados de envio mas NÃO incluem utm, checkout_query_params nem payment.

Todos os payloads incluem o array packages (pacotes físicos gerados para o pedido) com seus códigos de rastreio, transportadora, chave da NF-e e itens agrupados.

\n","_postman_id":"714579c4-4029-48b8-8b14-cc9ddb52d15f"}],"variable":[{"key":"webhook_url","value":"https://sua-url.com/webhook"}]}

Como funciona

Configuração de Webhooks

Autenticação

Retry

Eventos de Venda

Eventos de Rastreio

Payload Completo

Campos Principais

Objeto client

Objeto tracking

Objeto address

Objeto utm

Array items[]

Array packages[]

Array packages[].items[]

Objeto payment

Objeto `client`

Objeto `tracking`

Objeto `address`

Objeto `utm`

Array `items[]`

Array `packages[]`

Array `packages[].items[]`

Objeto `payment`