Listar cobranças
v1.0.0https://api.growthaisystem.com/api/v1/charges- Exige
Authorization: Bearer gos_…— Chave de API (gos_…)· escopospayments.read
Paginação por cursor. Filtros por status, method, paymentLinkId, externalReference, contato/negócio/pagador (contactId, opportunityId, payerId), período de criação (createdFrom/createdTo), de pagamento (paidFrom/paidTo) e alteração (updatedFrom, para leitura incremental), todos ISO-8601. Com externalReference ou payerId opaco (pyr_…) a página pode vir com menos itens e ainda ter nextCursor. Valores em centavos (BRL).
Parâmetros de consulta
Vão na querystring, depois do ?.
- statusstringopcional
- um de"open""processing""pending""paid""failed""expired""canceled""refunded""partially_refunded""chargeback""reconciliation_required"
- methodstringopcional
Pix, cartão de crédito (1–12x) ou débito à vista.
- um de"pix""card""debit"
- paymentLinkIdstringopcional
- externalReferencestringopcional
- createdFromstringopcional
- createdTostringopcional
- paidFromstringopcional
Pagas a partir desta data/hora (ISO-8601).
- paidTostringopcional
Pagas até esta data/hora (ISO-8601).
- updatedFromstringopcional
Só as que mudaram desde esta data/hora (ISO-8601): leitura incremental.
- contactIdstringopcional
Todas as cobranças de um contato do CRM.
- opportunityIdstringopcional
Todas as cobranças de um negócio do CRM.
- payerIdstringopcional
Todas as cobranças de um pagador (o
payerIdda cobrança). - cursorstringopcional
- limitintegeropcional
- padrão 25
- faixa 1–100
Respostas
6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.
Página de cobranças do workspace, da mais nova para a mais antiga. data: [] também é sucesso. Com externalReference, a página pode trazer menos itens que limit e ainda ter nextCursor: siga o cursor até null.
Cada item — V1Charge
- idstring
- statusstring
- um de"open""processing""pending""paid""failed""expired""canceled""refunded""partially_refunded""chargeback""reconciliation_required"
- amountinteger
Principal em centavos (BRL).
- amountPaidinteger | null
Bruto pago em centavos, com juros do comprador quando houver.
- currency"BRL"
- sempre "BRL"
- descriptionstring
- methodstring | null
Pix, cartão de crédito (1–12x), débito à vista ou BolePix (boleto com Pix).
- um de"pix""card""debit""bolepix"
- installmentsinteger | null
- sourcestring
- um de"link""api""crm_deal""manual""subscription"
- paymentLinkIdstring | null
- externalReferencestring | null
- chave string
- valor string | number | boolean | null
Uma destas formas
- string
- number
- boolean
- namestring | null
- emailstring | null
- taxIdLast4string | null
- phonestring | null
Telefone do pagador, só dígitos, como foi informado.
- contactIdstring | null
Contato do CRM que pagou; null quando a cobrança não está ligada a um contato.
- opportunityIdstring | null
Negócio do CRM de origem; null fora do CRM.
- payerIdstring | null
Id estável do pagador, o mesmo em todas as cobranças dele:
crm_<contactId>quando há contato; senão um código opaco (pyr_…) derivado do documento ou do e-mail, que não revela nenhum dos dois. null sem nenhum dado do pagador. - checkoutUrlstring (uri)
- checkoutExpiresAtstring
- platformFeeinteger | null
Taxa da plataforma esperada em centavos (null antes do pagamento).
- netAmountinteger | null
Líquido previsto ao recebedor em centavos.
- reconciliationstring
- um de"pending""matched""divergent""not_applicable"
- createdAtstring
- paidAtstring | null
- refundedAtstring | null
- subscriptionIdstring | null
Assinatura de que esta cobrança é a fatura do ciclo; null fora de assinatura.
- dueDatestring | null
Vencimento (YYYY-MM-DD): o do BolePix, o da parcela de proposta ou o da fatura de assinatura; null sem prazo.
- overdueboolean
Passou o
dueDate(horário de Brasília) sem pagamento. Cartão parcelado nunca fica vencido: o comprador já pagou. - amountRefundedinteger
Total estornado e confirmado pelo processador, em centavos.
O crédito na conta, pela agenda do processador. null antes do pagamento ou enquanto a agenda não chegou.
- statusstring
pending_credit: pago, nada creditado ainda;partially_credited: parte das parcelas já caiu;credited: tudo creditado.- um de"pending_credit""partially_credited""credited"
- installmentsinteger
Parcelas de crédito na agenda do processador (1 no Pix e no cartão à vista).
- grossAmountinteger
Bruto das parcelas na agenda, em centavos.
- platformFeeinteger | null
Taxas REAIS da agenda do processador, em centavos (positivo). null enquanto o processador não informou.
- netAmountinteger
Líquido real:
grossAmount − platformFee. - creditedAmountinteger
Já creditado na conta, em centavos.
- pendingAmountinteger
Ainda a creditar, em centavos.
- nextCreditDatestring | null
Próxima data prevista de crédito (YYYY-MM-DD); null quando tudo já caiu.
- lastCreditAtstring | null
Último crédito (ISO); null antes do primeiro.
- nextCursorstring | null
Cursor opaco da PRÓXIMA página — passe em
?cursor=.null= acabou a lista.