Passar para o conteúdo principal

Documentação do Webhook da Zedy

Receba notificações automáticas do checkout Zedy via Webhook. Veja abaixo o modelo de payload e a descrição dos campos disponíveis.

Atualizado essa semana

Exemplo de Payload JSON

{
"text": "Zedy | Pedido Z-03ZXG04QCP25 Pago",
"title": "Zedy | Pedido Z-03ZXG04QCP25 pago",
"image": "https://app.zedy.com.br/icon.png",
"actions": [
{
"name": "Pedido Z-03ZXG04QCP25",
"url": "https://app.zedy.com.br/admin/:idloja/salles/:idPedido"
}
],
"orderId": "Z-03ZXG04QCP25",
"platform": "ZedyCheckout",
"paymentMethod": "credit_card | pix | boleto",
"status": "waiting_payment | paid | refused | refunded",
"createdAt": "2025-04-03T14:39:34.976Z",
"approvedDate": "2025-04-03T14:43:01.000Z",
"refundedAt": null,
"customer": {
"name": "Fabríc....",
"email": "fa.....@gmail.com",
"phone": "....6499",
"document": ".....070",
"country": "BR"
},
"products": [
{
"id": 17130732,
"name": "Attracione Men (3 Unidade)",
"planId": 42201575817239,
"planName": "Default Title",
"quantity": 1,
"priceInCents": 12990
}
],
"trackingParameters": {
"src": null,
"sck": null,
"utm_source": "jLj67ee9d527703559cba828c4e",
"utm_campaign": "🥇CBO 03/04🥇|120220970676990221",
"utm_medium": "🥇CBO 03/04🥇|120220970679730221",
"utm_content": "Novo anúncio de Vendas|120220970679660221",
"utm_term": "Instagram_Reels"
},
"commission": {
"totalPriceInCents": 12990,
"gatewayFeeInCents": 324.75,
"userCommissionInCents": 12665.25
},
"address": {
"street": "Dante....",
"number": "5802",
"complement": "Casa ro....",
"neighborhood": "Faze.....",
"zipcode": "951....",
"city": "Caxia....",
"state": "RS",
"country": "BR"
},
"isTest": false
}

Descrição dos Campos

  • text: Mensagem curta de notificação.

  • title: Título da notificação.

  • image: URL da imagem de notificação.

  • actions: Ações rápidas com nome e link direto para o pedido.

  • orderId: ID do pedido.

  • platform: Plataforma utilizada.

  • paymentMethod: credit_card, pix, boleto.

  • status: waiting_payment, paid, refused, refunded.

  • createdAt, approvedDate, refundedAt: Datas em formato ISO.

Cliente (customer)

  • name, email, phone, document, country.

Produtos (products)

  • id: ID do produto.

  • name: Nome.

  • planId: ID do plano.

  • planName: Nome do plano.

  • quantity: Quantidade.

  • priceInCents: Preço unitário em centavos.

Rastreamento (trackingParameters)

  • utm_source, utm_campaign, utm_medium, utm_content, utm_term.

Comissão (commission)

  • totalPriceInCents: Valor total em centavos.

  • gatewayFeeInCents: Taxa do gateway.

  • userCommissionInCents: Valor líquido.

Endereço (address)

  • street, number, complement, neighborhood, zipcode, city, state, country.

Teste (isTest)

  • Booleano indicando se a transação é teste.

Considerações Finais

Seu sistema precisa tratar campos null e estar preparado para mudanças de status em tempo real. Garanta que os dados sejam interpretados corretamente em cada evento recebido.

Se tiver dúvidas sobre a configuração do webhook ou integração com a Zedy, fale com nosso time de suporte.

Respondeu à sua pergunta?