Cobrança de renovação gerada

Evento: TRANSACTION_PENDING

A cobrança de renovação de uma assinatura em PIX ou boleto foi gerada e espera pagamento.

Quando dispara: quando a PagPolar gera a nova cobrança do ciclo para o cliente. Assinaturas em PIX ou boleto nascem no checkout da PagPolar; pela API, a assinatura é sempre no cartão.

O que fazer: mostre ao cliente o PIX (payment_details.qr_code) ou o boleto (payment_details.billet_link e payment_details.billet_barcode) do novo ciclo. Quando ele pagar, chega TRANSACTION_PAID.

Atenção: é uma venda nova, com outro transaction.id. transaction.cycle indica o ciclo cobrado e subscription vem preenchida. Se a cobrança anterior não foi paga, ela chega antes como TRANSACTION_EXPIRED.

Exemplo de payload

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "event": "TRANSACTION_PENDING",
  "creation_date": "2026-02-28T10:00:05.000Z",
  "version": "1.0.0",
  "data": {
    "transaction": {
      "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "identifier": "PPO0087103960",
      "status": "DRAFT",
      "type": "BILLING",
      "payment_method": "BOLETO",
      "total_amount": "555.2400",
      "net_amount": 450,
      "effective_value": "426.5500",
      "base_tax": "23.4500",
      "installment_tax": "0.0000",
      "base_fixed_tax": "0.9900",
      "base_percentage_tax": "22.4600",
      "installments": 1,
      "cycle": 2,
      "paid_at": null,
      "created_at": "2026-01-29T14:00:00.000Z"
    },
    "items": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "quantity": 1,
        "amount": "450.0000",
        "original_amount": "500.0000",
        "discount_value": "50.0000",
        "product": {
          "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
          "name": "Curso Completo de Marketing Digital",
          "type": "DIGITAL"
        },
        "price": {
          "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
          "title": "Plano Anual",
          "price": "500.0000",
          "identifier": "PPP1234567890"
        }
      }
    ],
    "product": {
      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "name": "Curso Completo de Marketing Digital",
      "type": "DIGITAL"
    },
    "buyer": {
      "name": "João Silva",
      "email": "joao.silva@email.com",
      "document": "12345678900",
      "phone": "11999999999"
    },
    "address": null,
    "payment_details": {
      "origin": "DIRECT",
      "qr_code": null,
      "billet_barcode": "23793381286000000000300000000409184340000004990",
      "billet_link": "https://boletos.exemplo.com.br/a1b2c3d4.pdf",
      "last_credit_card_digits": null,
      "shipping_value": "0.00"
    },
    "coupon": null,
    "subscription": {
      "id": "c3d4e5f6-a7b8-4012-8def-123456789012",
      "status": "PENDING_RENEWAL",
      "start_at": "2026-01-28T10:00:00.000Z",
      "next_billing_at": "2026-03-28T10:00:00.000Z"
    },
    "affiliate": null,
    "source": {
      "channel": "API",
      "api_credential_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
    }
  }
}

Header Parameters

Authorization?string

Bearer <webhook_authorization>: o token do webhook, exibido uma única vez na criação da credencial. Compare com o valor guardado antes de processar o evento.

X-PagPolar-Test?string

true só nos envios de teste feitos pelo Playground de webhooks do portal. Os eventos reais não trazem este header.

Value in"true"

Request Body

idstring

Id desta tentativa de entrega. Cada nova tentativa do mesmo evento chega com outro id: não use este campo para evitar processamento duplicado.

Formatuuid

eventstring

Nome do evento.

creation_datestring

Data e hora (UTC) em que esta tentativa foi montada.

Formatdate-time

versionstring

Versão do formato do payload.

test?boolean

Só aparece nos envios de teste feitos pelo Playground de webhooks do portal, junto com o header X-PagPolar-Test: true. Os eventos reais não trazem este campo: ignore em produção qualquer evento com test: true.

dataTransactionEventData

Dados do evento. Chega vazio ({}) se a venda ou a assinatura não for encontrada no momento do envio.

Cobrança de renovação gerada

Exemplo de payload

Header Parameters

Request Body

Response Body

200