Pular para o conteúdo
Pagamentos

Listar cobranças

v1.0.0
GEThttps://api.growthaisystem.com/api/v1/charges
  • ExigeAuthorization: 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 payerId da 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.

200Deu certoapplication/json

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.