Cadastrar uma nova cobrança (PIX)

Cria uma nova cobrança PIX associada a uma conta escrow específica na Plataforma Celcoin.

A cobrança gerada possui data de vencimento, regras de juros e expiração após o pagamento, permitindo a liquidação via QR Code ou código EMV.

Este endpoint possibilita o registro completo da cobrança, incluindo:

• Valor da cobrança

• Dados do devedor (pagador)

• Data de vencimento

• Regras de juros

• Prazo de expiração após o pagamento

A cobrança criada poderá ser consultada posteriormente e utilizada para pagamento via PIX.

---

Descrição

Este endpoint permite criar uma cobrança PIX vinculada a uma conta escrow específica, identificada pelo account_id.

A operação registra a cobrança na plataforma e retorna todas as informações necessárias para pagamento, como QR Code, código EMV e URL de pagamento.

---

Método HTTP

POST

---

URL

Plain Text

https://sandbox.platform.credit.celcoin.com.br/escrow/api/v1/accounts/{account_id}/pix-charges

---

Path Parameters

---

Headers

---

Body Parameters

Dados da Cobrança

---

Debtor (Objeto)

Dados do pagador da cobrança.

---

Exemplo de Requisição

Plain Text

POST /escrow/api/v1/accounts/123456/pix-charges
Authorization: Bearer {token}
Content-Type: application/json

{
  "amount": 5,
  "debtor": {
    "name": "Não informado",
    "taxpayerId": "32383861820",
    "type": "PERSON"
  },
  "dueDate": "2026-01-15",
  "expirationAfterPayment": 5,
  "interestAmount": 0,
  "interestType": "PERCENTAGE_PER_MONTH_CALENDAR_DAYS"
}

---

Resposta de Sucesso

Status: 201 Created

Retorna os dados completos da cobrança PIX criada, incluindo identificadores, informações de pagamento e dados do devedor.

Exemplo de Resposta

{
  "id": "17f78e3e-0064-4231-8b76-c0a33301d797",
  "amount": "5.00",
  "description": null,
  "due_date": "2026-01-15",
  "expiration_after_payment": "5",
  "status": "ACTIVE",
  "pix_key": "eafccd5d-7df7-4aa2-8b98-38561664f092",
  "pre_signed_url": "https://s3.sa-east-1.amazonaws.com/...",
  "interest_amount": 0,
  "interest_type": "PERCENTAGE_PER_MONTH_CALENDAR_DAYS",
  "discount_amount": null,
  "discount_type": null,
  "fine_amount": null,
  "fine_type": null,
  "emv": "0002010102122698...",
  "url": "qrcode-h.pix.celcoin.com.br/pixqrcode/v2/cobv/...",
  "debtor": {
    "taxpayer_id": "32383861820",
    "name": "Não informado",
    "email_address": null,
    "address": null
  },
  "created_at": "2026-01-15T14:14:26.635Z"
}

---

Códigos de Retorno Padrão