Greenn - Subscription Transaction

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

Eventos Disponíveis

• subscription_transaction.paid
• subscription_transaction.failed
• subscription_transaction.disputed
• subscription_transaction.refunded
• subscription_transaction.canceled
• subscription_transaction.waiting_payment

Estrutura do Payload

{
  "event": "saleUpdated",
  "type": "SALE",
  "currentStatus": "paid",
  "sale": {
    "type": "SUBSCRIPTION",
    "id": "SALE-123",
    "subscription_id": "SUB-456",
    "status": "paid",
    "created_at": 1705319000,
    "updated_at": 1705319100,
    "paid_at": 1705319100,
    "amount": 4970,
    "method": "CREDIT_CARD",
    "shipping_amount": 0
  },
  "client": {
    "id": "12345",
    "name": "João Silva",
    "email": "[email protected]",
    "document": "12345678900",
    "cellphone": "5511999999999"
  },
  "product": {
    "id": "PROD-001",
    "name": "Plano Mensal",
    "amount": 4970
  },
  "link_checkout": "https://greenn.com/checkout/abc123"
}

---

Componentes do Payload

Customer

Campo	Tipo	Descrição
id	string | null	ID do cliente
name	string | null	Nome do cliente
email	string | null	E-mail do cliente
document	string | null	Documento (CPF/CNPJ)
phone_numbers	Collection	Coleção de telefones
address	EmptyAddress	Sempre vazio

Telefone

Campo	Tipo	Descrição
formatted_phone	string | null	Telefone formatado
type	null	Sempre null
raw_number	string | null	Número bruto
area_code	null	Sempre null
international_dialing_code	null	Sempre null

---

Order

Campo	Tipo	Descrição
id	string | null	ID do pedido
status	string	Status normalizado do pedido
created_at	integer | null	Timestamp de criação
updated_at	integer | null	Timestamp de atualização
paid_at	integer | null	Timestamp do pagamento
warranty_until	null	Sempre null
canceled_at	null	Sempre null
refunded_at	null	Sempre null
raw_status	string | null	Status original do provider

Status Normalizados (OrderStatus)

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

Valor	Descrição
waiting_payment	Aguardando pagamento
paid	Pago
failed	Falhou
disputed	Em disputa/chargedback
refunded	Reembolsado
expired	Expirado
canceled	Cancelado

Cupom

Campo	Tipo	Descrição
id	string | null	ID do cupom
code	string | null	Código do cupom
value	integer | null	Valor do desconto (em centavos)
percentage	float | null	Percentual do desconto
incidence	string	Sempre total
incidence_type	string	Tipo de incidência (percentage ou value)
expiration_date	null	Sempre null

---

Payment

Campo	Tipo	Descrição
currency	string	Sempre BRL
total	integer | null	Valor total (em centavos)
discount_value	null	Sempre null
shipping_value	integer | null	Valor do frete (em centavos)
total_products_value	null	Sempre null
payment_method	PaymentMethod	Método de pagamento
coupons	Collection	Coleção de cupons

Cupom

Campo	Tipo	Descrição
id	string | null	ID do cupom
code	string | null	Código do cupom
value	integer | null	Valor do desconto (em centavos)
percentage	float | null	Percentual do desconto
incidence	string	Sempre total
incidence_type	string	Tipo de incidência (percentage ou value)
expiration_date	null	Sempre null

---

Product

Campo	Tipo	Descrição
id	string | null	ID do produto
name	string | null	Nome do produto
quantity	integer	Sempre 1
unit_value	integer | null	Valor unitário (em centavos)
total_value	integer | null	Valor total (em centavos)
image_url	null	Sempre null
type	string	Sempre product
offer_type	string	Sempre main

---

Checkout

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

---

Subscription

Campo	Tipo	Descrição
id	string | null	ID da assinatura
name	null	Sempre null
created_at	null	Sempre null
updated_at	null	Sempre null
canceled_at	null	Sempre null
cancellation_reason	null	Sempre null
charged_times	null	Sempre null
current_cycle	null	Sempre null
current_cycle_start	null	Sempre null
current_cycle_end	null	Sempre null
status	string | null	Status normalizado da assinatura

Status Normalizados (SubscriptionStatus)

A Greenn retorna os seguintes valores normalizados para o status da assinatura:

Valor	Descrição
active	Ativa
canceled	Cancelada

---

Shipping (vazio)

Campo	Tipo	Descrição
carrier	null	Sempre null
total_value	null	Sempre null
tracking_url	null	Sempre null
tracking_code	null	Sempre null
method	null	Sempre null
delivery_address	[EmptyAddress]	Endereço vazio
estimated_delivery_date	null	Sempre null
estimated_delivery_time_in_days	null	Sempre null
status	null	Sempre null
raw_status	null	Sempre null

Delivery Address (Vazio)

Campo	Tipo	Descrição
street	null	Sempre null
number	null	Sempre null
complement	null	Sempre null
neighborhood	null	Sempre null
city	null	Sempre null
state	null	Sempre null
country	null	Sempre null
postal_code	null	Sempre null

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

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

---

Lead Tracking (vazio)

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.

---

Charge (vazio)

Campo	Tipo	Descrição
id	null	Sempre null
created_at	null	Sempre null
status	null	Sempre null
type	null	Sempre null
value	null	Sempre null

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

---

Voltar para visão geral da integração