{"info":{"_postman_id":"73fba179-72af-4eb2-bf37-1da0c1d4b157","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 e atualizações de rastreio.

Como funciona

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

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_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

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

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)

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)

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":"73fba179-72af-4eb2-bf37-1da0c1d4b157","publishedId":"2sBXinJWaJ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-31T18:21:14.000Z"},"item":[{"name":"Webhooks de Venda","item":[{"name":"Venda Aprovada (sale_approved)","id":"0ead9cdc-fca0-49f6-9497-878890643af6","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"0ead9cdc-fca0-49f6-9497-878890643af6"},{"name":"Aguardando Pagamento (sale_waiting_payment)","id":"bc309551-5013-4b8d-8b3c-4e476579825d","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 \"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).

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"bc309551-5013-4b8d-8b3c-4e476579825d"},{"name":"Venda Recusada (sale_refused)","id":"d4ef0293-2ccf-4680-bc6e-4003170a00e3","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"d4ef0293-2ccf-4680-bc6e-4003170a00e3"},{"name":"Estorno (sale_refunded)","id":"a9b03307-0af2-418d-8ec5-9e6391d36201","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"a9b03307-0af2-418d-8ec5-9e6391d36201"},{"name":"Chargeback (sale_chargeback)","id":"a1b9a1b7-8b2c-44ed-bb63-ac21b56873db","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 \"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).

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"a1b9a1b7-8b2c-44ed-bb63-ac21b56873db"},{"name":"Venda Cancelada (sale_cancelled)","id":"b5866392-47a9-49fa-9be1-981b052bd0db","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"b5866392-47a9-49fa-9be1-981b052bd0db"},{"name":"Carrinho Abandonado (sale_cart_abandoned)","id":"654d7001-d44f-4531-be30-cc98336a788f","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"654d7001-d44f-4531-be30-cc98336a788f"},{"name":"Carrinho Recuperado (sale_cart_recovered)","id":"24c2992c-92f9-4c0d-a4c1-46891254d80e","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 \"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).

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"24c2992c-92f9-4c0d-a4c1-46891254d80e"}],"id":"83f88bb8-7027-4c93-a3c5-5cca0f0bceb4","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.

\n","_postman_id":"83f88bb8-7027-4c93-a3c5-5cca0f0bceb4"},{"name":"Webhooks de Rastreio","item":[{"name":"Pedido Postado (tracking_posted)","id":"fe140944-016a-4202-8543-bcfa37b1d427","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"fe140944-016a-4202-8543-bcfa37b1d427"},{"name":"Em Trânsito (tracking_in_transit)","id":"e83fdc4e-c792-4312-b660-1359e0a00e76","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"e83fdc4e-c792-4312-b660-1359e0a00e76"},{"name":"Saiu para Entrega (tracking_out_for_delivery)","id":"80cc74fb-b446-4cc5-bbbb-a9d8740eff16","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"80cc74fb-b446-4cc5-bbbb-a9d8740eff16"},{"name":"Entregue (tracking_delivered)","id":"e16d770c-9452-4bbc-b4fb-638dd76be539","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"e16d770c-9452-4bbc-b4fb-638dd76be539"},{"name":"Envio Cancelado (tracking_cancelled)","id":"04a70cf5-8bb5-400d-b70a-d14f0f1f5d80","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"04a70cf5-8bb5-400d-b70a-d14f0f1f5d80"},{"name":"Devolvido (tracking_returned)","id":"aca53ffd-48e8-4cff-943a-40011cc22a5f","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 \"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.

\n","urlObject":{"host":["https://sua-url.com/webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"aca53ffd-48e8-4cff-943a-40011cc22a5f"}],"id":"e66cb17d-130d-469d-8698-7f61b6b8fa4c","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.

\n","_postman_id":"e66cb17d-130d-469d-8698-7f61b6b8fa4c"}],"variable":[{"key":"webhook_url","value":"https://sua-url.com/webhook"}]}