Pagarme - Subscription Transaction

Eventos da família subscription_transaction.* na integração Pagarme.

Eventos Disponíveis

• subscription_transaction.waiting_payment.credit_card
• subscription_transaction.waiting_payment.pix
• subscription_transaction.waiting_payment.boleto
• subscription_transaction.waiting_payment.without_payment_method
• subscription_transaction.processing
• subscription_transaction.paid
• subscription_transaction.refunded
• subscription_transaction.failed

Estrutura do Payload

{
  "type": "subscription_transaction.paid",
  "data": {
    "id": "SUB-TXN-123456",
    "subscription": {
      "id": "SUB-123456",
      "status": "paid"
    },
    "status": "paid",
    "created_at": 1705319000,
    "paid_at": 1705319000,
    "currency": "BRL",
    "amount": 4900,
    "cycle": {
      "cycle": 1,
      "start_at": 1705319000,
      "end_at": 1707944400
    },
    "items": [
      {
        "id": "PROD-001",
        "description": "Plano Mensal",
        "quantity": 1,
        "amount": 4900
      }
    ],
    "customer": {
      "id": "CUST-001",
      "name": "João Silva",
      "document": "12345678900",
      "email": "[email protected]"
    },
    "charges": [
      {
        "id": "CHA-001",
        "status": "paid",
        "payment_method": "credit_card",
        "last_transaction": {
          "transaction_type": "credit_card",
          "card": {
            "brand": "visa",
            "last_four_digits": "1234",
            "exp_month": 12,
            "exp_year": 2030
          }
        }
      }
    ]
  }
}

---

Componentes do Payload

Customer

Campo	Tipo	Descrição
id	string | null	ID do cliente
name	string | null	Nome do cliente
document	string | null	Número do documento (CPF/CNPJ)
email	string | null	Email do cliente
phoneNumbers	Collection	Coleção de telefones
address	Address	Endereço do cliente

Subcomponentes

Campo	Tipo	Descrição
street	string | null	Nome da rua
number	string | null	Número
complement	string | null	Complemento
neighborhood	string | null	Bairro
city	string | null	Cidade
state	string | null	Estado (UF)
country	string | null	País
postalCode	string | null	CEP

---

Telefones

Campo	Tipo	Descrição
formattedPhone	PhoneFactory | null	Telefone formatado
type	null	Sempre null
rawNumber	string | null	Número bruto
areaCode	string | null	Código de área
internationalDialingCode	null	Sempre null

---

Charge

Campo	Tipo	Descrição
id	string | null	ID da cobrança
status	ChargeStatus | null	Status normalizado da cobrança
type	string	Sempre cycle
value	int | null	Valor da cobrança
createdAt	Carbon | null	Data de criação

Status Normalizados (ChargeStatus)

A Pagarme retorna os seguintes valores normalizados para o status da cobrança:

Valor	Descrição
paid	Pago
waiting_payment	Aguardando pagamento
canceled	Cancelado

---

Order

Campo	Tipo	Descrição
id	string | null	ID do pedido
status	OrderStatus	Status normalizado do pedido
rawStatus	string | null	Status original do provider
createdAt	Carbon | null	Data de criação do pedido
updatedAt	Carbon | null	Data de atualização do pedido
paidAt	Carbon | null	Data do pagamento
canceledAt	Carbon | null	Data do cancelamento
refundedAt	Carbon | null	Data do reembolso
warrantyUntil	null	Sempre null
refundableUntil	null	Sempre null

Status Normalizados (OrderStatus)

A Pagarme retorna os seguintes valores normalizados para o status do pedido:

Valor	Descrição
paid	Pago
waiting_payment	Aguardando pagamento
payment_processing	Processando pagamento
refunded	Reembolsado
failed	Falhou
canceled	Cancelado

---

Payment

Campo	Tipo	Descrição
currency	string | null	Moeda da transação
total	int | null	Valor total do pedido
totalProductsValue	int | null	Soma dos valores dos produtos
discountValue	int | null	Valor do desconto
shippingValue	int | null	Valor do frete
coupons	Collection	Coleção de cupons
paymentMethod	PaymentMethod | null	Método de pagamento

Métodos de Pagamento

Campo	Tipo	Descrição
brand	string | null	Bandeira do cartão
lastDigits	string | null	Últimos 4 dígitos
expirationMonth	int | null	Mês de expiração
expirationYear	int | null	Ano de expiração

---

Campo	Tipo	Descrição
brand	string | null	Bandeira do cartão
lastDigits	string | null	Últimos 4 dígitos
expirationMonth	int | null	Mês de expiração
expirationYear	int | null	Ano de expiração

---

Campo	Tipo	Descrição
qrcodeUrl	string | null	URL do QR Code Pix
qrcodeSignature	string | null	Assinatura do QR Code Pix
expirationDate	Carbon | null	Data de expiração
pixKey	null	Sempre null
pixKeyType	null	Sempre null

---

Campo	Tipo	Descrição
digitableLine	string | null	Linha digitável do boleto
url	string | null	URL do boleto ou PDF
expirationDate	Carbon | null	Data de vencimento

---

Campo	Tipo	Descrição
type	string	Sempre bank_transfer

---

Campo	Tipo	Descrição
type	string	Sempre cash

---

Product

Campo	Tipo	Descrição
id	string | null	ID do produto
name	string | null	Nome do produto
quantity	int | null	Quantidade
unitValue	int | null	Valor unitário em centavos
totalValue	int | null	Valor total
imageUrl	null	Sempre null
type	string	Tipo do produto (product ou subscription_plan)
offerType	string	Sempre main

---

Shipping

Campo	Tipo	Descrição
carrier	null	Sempre null
totalValue	int | null	Valor do frete
trackingUrl	null	Sempre null
trackingCode	null	Sempre null
method	null	Sempre null
deliveryAddress	Address	Endereço de entrega
estimatedDeliveryDate	null	Sempre null
estimatedDeliveryTimeInDays	null	Sempre null
rawStatus	null	Sempre null
status	null	Sempre null

Campo	Tipo	Descrição
street	string | null	Nome da rua
number	string | null	Número
complement	string | null	Complemento
neighborhood	string | null	Bairro
city	string | null	Cidade
state	string | null	Estado (UF)
country	string | null	País
postalCode	string | null	CEP

---

Checkout

Campo	Tipo	Descrição
id	null	Sempre null
url	string | null	URL do checkout

Status Normalizados (OrderStatus)

A Pagarme retorna os seguintes valores normalizados para o status:

Valor	Descrição
paid	Pago
waiting_payment	Aguardando pagamento
payment_processing	Processando pagamento
refunded	Reembolsado
failed	Falhou
canceled	Cancelado

---

LeadTracking

Campo	Tipo	Descrição
src	null	Sempre null
sck	null	Sempre null
utmSource	null	Sempre null
utmCampaign	null	Sempre null
utmMedium	null	Sempre null
utmContent	null	Sempre null
utmTerm	null	Sempre null
utmId	null	Sempre null
metaFbp	null	Sempre null
googleGaId	null	Sempre null
googleGclid	null	Sempre null
googleGclsrc	null	Sempre null
googleDclid	null	Sempre null
googleGbraid	null	Sempre null
googleWbraid	null	Sempre null
tiktokTtlid	null	Sempre null
ip	null	Sempre null

Campo	Tipo	Descrição
src	null	Sempre null
sck	null	Sempre null
utm_source	null	Sempre null
utm_campaign	null	Sempre null
utm_medium	null	Sempre null
utm_content	null	Sempre null
utm_term	null	Sempre null
utm_id	null	Sempre null
meta_fbp	null	Sempre null
google_ga_id	null	Sempre null
google_gclid	null	Sempre null
google_gclsrc	null	Sempre null
google_dclid	null	Sempre null
google_gbraid	null	Sempre null
google_wbraid	null	Sempre null
tiktok_ttlid	null	Sempre null
ip	null	Sempre null

[!NOTE] Essa integração não disponibiliza informações de lead tracking.

---

Voltar para visão geral da integração