Seja bem-vindo(a) à documentação de Webhooks da Cakto! Essas informações te ajudarão a integrar e automatizar seus processos de forma simples e eficiente.

<aside> 💡

Os webhooks enviam uma requisição POST com informações sobre cada pedido. A Cakto interpreta qualquer resposta do seu sistema como entregue.

</aside>

<aside> 💡

Há um limite de tempo de 10 segundos em que é aguardado a confirmação do recebimento da requisição por parte do seu sistema, caso não haja nenhum tipo de resposta é feito 4 tentativas adicionais.

</aside>


Exemplo de webhook

{
    "secret": "123",
    "event": "purchase_approved",
    "data": {
        "id": "81b408ee-2a91-427d-80bd-226cbeae1fa0",
        "refId": "AUAe5xK",
        "customer": {
            "name": "Example",
            "birthDate": "2000-04-09",
            "email": "[email protected]",
            "phone": "34999999999"
        },
        "affiliate": "[email protected]",
        "offer": {
            "id": "B8BcHrY",
            "name": "Offer Example",
            "price": 5.55
        },
        "offer_type": "main",
        "product": {
            "name": "Webhook Example",
            "id": "cd287b31-d4b7-4e94-858a-96e05ce2f4a2",
            "short_id": "49bruPi",
            "supportEmail": "[email protected]",
            "type": "unique",
            "invoiceDescription": "213"
        },
        "parent_order": "",
        "checkoutUrl": "<https://pay.cakto.com.br/B8BcHrY>",
        "status": "paid",
        "baseAmount": 5.55,
        "discount": "0.00",
        "amount": 5.55,
        "commissions": [
            {
                "user": "[email protected]",
                "totalAmount": 3.06,
                "percentage": 100.0,
                "type": "producer"
            }
        ],
        "fees": 2.49,
        "couponCode": null,
        "reason": null,
        "refund_reason": null,
        "paymentMethod": "pix",
        "installments": 1,
        "paidAt": "2024-08-22T11:39:57.113068-03:00",
        "createdAt": "2024-08-22T11:38:32.945877-03:00",
        "pix": {
            "qrCode": "00020101021226770014BR.GOV.BCB.PIX2555api.itau/pix/qr/v2/b8e8a562-77b9-4d0f-9f48-7d99303bf5f25204000053039865802BR5909CAKTO PAY6009SAO PAULO62070503***630476FD",
            "expirationDate": "2024-08-22 17:25:14.804059+00:00"
        }
    }
}

Status de pagamento


Método de pagamento

O método de pagamento vai influenciar no modelo do webhook enviado, por isso, é importante entender que alguns campos só estarão disponíveis em alguns casos.

O Pix vai ter uma duração de 45 dias a partir da hora que ele foi criado.

Campos por método de pagamento:

❖ Pix