Skip to content

payments

Descrição

Cobranças geradas via Asaas, com split de pagamentos

Nome da coluna Descrição Tipo Opcional
id Código de identificação do registro integer X
created_at Data de criação do registro timestamp without time zone X
updated_at Data de atualização do registro timestamp without time zone X
deleted_at Data de deleção do registro timestamp without time zone ✅
status Status normalizado do pagamento USER-DEFINED X
billing_type Método de cobrança (PIX/BOLETO/CREDIT_CARD) USER-DEFINED X
gross_value Valor bruto cobrado do cliente (BRL) numeric X
platform_fee_value Valor bruto retido pela plataforma (taxa). Soma de splits PLATFORM. numeric X
provider_net_value Valor bruto destinado ao prestador (antes de taxas Asaas). Soma de splits PROVIDER. numeric X
due_date Vencimento da cobrança date X
description Descrição livre exibida ao pagador character varying ✅
asaas_payment_id ID da cobrança no Asaas (campo id no retorno de /payments) character varying X
invoice_url URL da página de cobrança (boleto, fatura PIX, link de cartão) character varying ✅
pix_payload PIX copia-e-cola, quando billingType=PIX text ✅
bank_slip_url URL para download do boleto (PDF) character varying ✅
external_reference Referência externa repassada ao Asaas (ex.: bookingCode do schedule) character varying ✅
paid_at Quando o pagamento foi confirmado/recebido timestamp without time zone ✅
last_asaas_payload Último payload bruto recebido do Asaas (criação ou webhook). Útil para auditoria. jsonb ✅
client_id Código de identificação do registro integer X
provider_id Código de identificação do registro integer X
schedule_id Código de identificação do registro integer ✅
building_id UUID da edificação no sistema principal Easy Alert, capturado no checkout via query param. Quando presente, o split inclui (ou tentou incluir) a fatia do condomínio. character varying ✅
building_fee_value Valor (BRL) destinado ao condomínio. Quando a config da edificação não pôde ser aplicada, guarda o valor que SERIA repassado, para auditoria. numeric ✅
building_fee_origin_used Modelo aplicado de origem da fatia do condomínio (PLATFORM/PROVIDER/CLIENT_EXTRA). NULL quando não houve split para a edificação. character varying ✅
pix_qr_code_image QR Code do PIX em base64 (PNG) retornado pelo Asaas. Front renderiza direto como . text ✅
internal_notes Observações internas do backoffice (Easy Alert). NÃO exposto ao cliente nem ao prestador — só na tela admin "Easy Serviços". character varying ✅
transfers_managed true = modelo novo (hold + 7 dias, transfers manuais). false = modelo antigo (split direto no Asaas no momento da cobrança). boolean X

Chaves Estrangeiras

Coluna Tabela
client_id clients
provider_id providers
schedule_id schedules

Indexes

Nome do Index Coluna do Index
PK_payments id
UQ_payments_asaas_payment_id asaas_payment_id