Skip to main content
POST
/
v1
/
pix
/
charges
curl -X POST https://apisandbox.delbank.com.br/v1/pix/charges \
  --cert ./certificado.crt --key ./chave-privada.key \
  -H "x-delbank-api-key: SUA_API_KEY" \
  -H "x-delfinance-account-id: SUA_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150.75,
    "description": "Pagamento do pedido #9817",
    "customer": {
      "name": "Maria Oliveira",
      "document": "12345678909"
    }
  }'

{
  "id": "chg_981726a",
  "txid": "9c8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c",
  "copia_e_cola": "00020101021226830014br.gov.bcb.pix...",
  "qr_code_url": "https://apisandbox.delbank.com.br/v1/pix/qr/chg_981726a",
  "amount": 150.75,
  "status": "pending",
  "created_at": "2026-07-04T12:00:00Z"
}
Cria uma cobrança Pix associada a um valor específico e a um cliente. A API retorna a string Pix “Copia e Cola” e o link do QR Code para renderização.

​
Corpo da requisição

​
amount
number
required
Valor da cobrança em reais (ex: 150.75).
​
description
string
Descrição ou nota da cobrança visível ao pagador (ex: Pagamento do pedido #9817).
​
expires_in
integer
default:"86400"
Tempo de expiração da cobrança em segundos (padrão 24 horas).
​
customer
object
required
Objeto contendo os dados do cliente (pagador).

​
Resposta

​
id
string
required
ID único da cobrança gerada na Delfinance.
​
txid
string
required
Identificador único da transação Pix (Transaction ID).
​
copia_e_cola
string
required
Payload da cobrança Pix para ser copiado e colado pelo cliente.
​
qr_code_url
string
required
URL contendo a imagem do QR Code para ser exibida no front-end.
​
amount
number
required
Valor original da cobrança.
​
status
string
required
Status atual da cobrança (pending, paid, expired).
​
created_at
string
required
Data de criação em formato ISO 8601.
curl -X POST https://apisandbox.delbank.com.br/v1/pix/charges \
  --cert ./certificado.crt --key ./chave-privada.key \
  -H "x-delbank-api-key: SUA_API_KEY" \
  -H "x-delfinance-account-id: SUA_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150.75,
    "description": "Pagamento do pedido #9817",
    "customer": {
      "name": "Maria Oliveira",
      "document": "12345678909"
    }
  }'

{
  "id": "chg_981726a",
  "txid": "9c8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c",
  "copia_e_cola": "00020101021226830014br.gov.bcb.pix...",
  "qr_code_url": "https://apisandbox.delbank.com.br/v1/pix/qr/chg_981726a",
  "amount": 150.75,
  "status": "pending",
  "created_at": "2026-07-04T12:00:00Z"
}