Carteiras > Cobranças

Copy of Cadastrar uma nova cobrança

Este endpoint permite criar cobranças, processar pagamentos, consultar detalhes e receber notificações via Webhook sobre eventos do ciclo de vida de uma cobrança.


Autenticação

Authorization: Bearer {API_TOKEN}
Content-Type: application/json


Criar Cobrança

Cria uma nova cobrança com regras de desconto, juros, multa, split e dados completos do pagador.

POST /charges


Request Body — Parâmetros

Dados principais da cobrança

CampoTipoObrigatórioDescrição
due_datedatetimeSimData de vencimento da cobrança (ISO 8601).
amountfloatSimValor total da cobrança.
finefloatNãoPercentual de multa por atraso.
interestfloatNãoPercentual de juros aplicado após o vencimento.
discount_limit_datedatetimeNãoData limite para aplicação do desconto.
discount_modalitystringNãoModalidade do desconto: FIXED ou PERCENT.
discount_valuefloatNãoValor do desconto, conforme a modalidade definida.

Objeto charge_debtor — Dados do Pagador

CampoTipoObrigatórioDescrição
numberstringNãoNúmero do endereço.
neighborhoodstringNãoBairro.
namestringSimNome completo do pagador.
documentstringSimDocumento do pagador (CPF ou CNPJ).
citystringNãoCidade.
public_areastringNãoLogradouro (rua, avenida, etc.).
statestringNãoEstado (UF).
postal_codestringNãoCEP.
country_codestringNãoCódigo do país (ex: BR).
phone_codestringNãoCódigo do país para telefone (ex: +55).
number_phonestringNãoNúmero do telefone.
emailstringNãoE-mail do pagador.

Objeto charge_split — Split de Pagamento

CampoTipoObrigatórioDescrição
account_destination_idstringSimIdentificador da conta recebedora do split.
split_typestringSimTipo de split: PERCENTAGE ou AMOUNT.
split_percentagefloatNãoPercentual do valor destinado ao split. Obrigatório quando split_type = PERCENTAGE.
split_amountfloatNãoValor fixo destinado ao split. Obrigatório quando split_type = AMOUNT.

Response — Sucesso

{
  "id": "chg_123456"
}

CampoTipoDescrição
idstringIdentificador único da cobrança.

Processamento da Cobrança

Após a criação, a cobrança é processada de forma assíncrona.

O resultado é enviado via Webhook conforme o status do processamento.


Webhook — Cobrança Criada com Sucesso

Evento disparado quando a cobrança é registrada com sucesso.

Event

charge.created

Payload — Parâmetros

CampoTipoDescrição
charge_idstringIdentificador da cobrança.
pix_codestringCódigo PIX para pagamento.
digitable_linestringLinha digitável do boleto.
bank_numberstringCódigo do banco emissor.
pix_base64stringQR Code PIX em Base64.
client_codestringCódigo do cliente.
link_boletostringURL para acesso ao boleto.

Webhook — Erro na Criação da Cobrança

Evento disparado quando ocorre falha no processamento.

Event

charge.error

Payload — Parâmetros

CampoTipoDescrição
charge_idstringIdentificador da cobrança.
client_codestringCódigo do cliente.
statusstringStatus do processamento (ERROR).
errorstringMensagem detalhando o erro ocorrido.

Consultar Detalhes da Cobrança

Retorna todas as informações da cobrança, incluindo pagamento, boleto, PIX e splits.

GET /charges/{charge_id}


Response — Parâmetros

Dados gerais

CampoTipoDescrição
idstringIdentificador da cobrança.
amountnumberValor total da cobrança.
charge_codenumberCódigo interno da cobrança.
due_datedateData de vencimento.
amount_paidnumberValor efetivamente pago.
paid_amountnumberValor liquidado.
feesnumberTaxas aplicadas.
interestnumberJuros aplicados.
discount_modalitystringModalidade do desconto.
discount_valuenumberValor do desconto.
discount_limit_datedateData limite para desconto.
taxes_to_apply_after_paymentnumberTaxas aplicáveis após pagamento.

Dados de pagamento

CampoTipoDescrição
bar_codestringCódigo de barras do boleto.
pix_codestringCódigo PIX.
pix_detailstringDescrição do pagamento PIX.
boleto_detailsobjectInformações adicionais do boleto.
charge_pdf_urlstringURL do PDF do boleto.

Objeto charge_receiver

CampoTipoDescrição
accountstringConta recebedora.
documentstringDocumento do recebedor.

Objeto split (array)

CampoTipoDescrição
accountstringConta beneficiária do split.
documentstringDocumento do beneficiário.
split_typestringTipo do split (PERCENTAGE ou AMOUNT).
split_percentagestringPercentual do split.
split_amountstringValor fixo do split.

Status da Cobrança

StatusDescrição
CREATEDCobrança criada.
PROCESSINGEm processamento.
PAIDCobrança paga.
EXPIREDCobrança vencida.
ERRORErro no processamento.
post/escrow/api/v1/wallets/{wallet_id}/charges-1

Request

  • Base URL
    https://sandbox.platform.credit.celcoin.com.br
  • URL
    https://sandbox.platform.credit.celcoin.com.br/escrow/api/v1/wallets/{wallet_id}/charges-1
  • Auth
    none declared

Path parameters

wallet_idstring required

Headers

Content-Typestring
Acceptstring

Request body

object required

Example request

{
  "dueDate": "2024-08-30",
  "amount": "<number>",
  "fine": "<number>",
  "discountLimitDate": "2024-08-30",
  "discountValue": "<number>",
  "interest": "<number>",
  "chargeDebtor": {
    "number": "<string>",
    "neighborhood": "<string>",
    "name": "<string>",
    "document": "<string>",
    "city": "<string>",
    "publicArea": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "phone": {
      "countryCode": "+200",
      "areaCode": "<string>",
      "number": "<string>"
    },
    "email": "<string>"
  },
  "daysToExpireAfterPayment": "<number>",
  "discountModality": "PERCENT"
}

Response

OK

object required

Changes

No recorded changes to this operation across all 1 revision of this API.