Pular para o conteúdo
Pagamentos

Buscar cobrança por id

v1.0.0
GEThttps://api.staging.growthaisystem.com/api/v1/charges/{id}
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escopospayments.read

Lê uma cobrança. Não altera nada nem consulta o provedor.

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

  • idstringobrigatório
    • tamanho mín. 1

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

A cobrança, com o link de checkout e, depois do pagamento, a taxa e o líquido previstos.

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.