curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/immediate-payment' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"key": "e7c3d5f2-4a1b-4c3d-9d15-1b2c3d4e5f60",
"city": "Sao Paulo",
"originalAmount": 49.90,
"qrExpiration": 3600,
"recurrenceData": {
"recurrenceId": "RR3822485720261027F6E5D4C3B2A",
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-11-27",
"debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
"amount": 49.90,
"contractNumber": "CTR-123456",
"contractDescription": "Plano Premium",
"retry": "ALLOWED"
}
}'
{
"documentId": "01000000-3353-6e2c-12c9-08de9f179024",
"revision": "0",
"qrCodeImageBase64": "iVBORw0KGgoAAAANSUhEUgAAASQAAAEkAQAAAACugnFBAAAD60lEQVR4nO2a...",
"payloadBase64": "MDAwMjAxMjYxODAwMTRici5nb3YuYmNiLnBpeDUyMDQwMDAw...",
"payloadPix": "00020101021226...80...6304A1B2",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6...",
"compositePayloadJws": null,
"recurrencePayloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjE0NzhFNDZB..."
}
Pix Automático
Criar QR Code com pagamento imediato
Cria um QR Code composto com uma cobrança imediata e a recorrência (jornada 3). Pagar a cobrança autoriza o Pix Automático.
POST
/
baas
/
api
/
v1
/
pix
/
qrcode
/
recurrences
/
immediate-payment
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/immediate-payment' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"key": "e7c3d5f2-4a1b-4c3d-9d15-1b2c3d4e5f60",
"city": "Sao Paulo",
"originalAmount": 49.90,
"qrExpiration": 3600,
"recurrenceData": {
"recurrenceId": "RR3822485720261027F6E5D4C3B2A",
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-11-27",
"debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
"amount": 49.90,
"contractNumber": "CTR-123456",
"contractDescription": "Plano Premium",
"retry": "ALLOWED"
}
}'
{
"documentId": "01000000-3353-6e2c-12c9-08de9f179024",
"revision": "0",
"qrCodeImageBase64": "iVBORw0KGgoAAAANSUhEUgAAASQAAAEkAQAAAACugnFBAAAD60lEQVR4nO2a...",
"payloadBase64": "MDAwMjAxMjYxODAwMTRici5nb3YuYmNiLnBpeDUyMDQwMDAw...",
"payloadPix": "00020101021226...80...6304A1B2",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6...",
"compositePayloadJws": null,
"recurrencePayloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjE0NzhFNDZB..."
}
Para o passo a passo completo, veja o guia Jornada 3: pagamento imediato e autorização.
Headers
string
required
Sua API key.
string
required
Número da conta Delfinance do recebedor.
Body
string
default:"PAYLOAD_AND_QRCODE"
ONLY_PAYLOAD ou PAYLOAD_AND_QRCODE.string
required
Chave Pix da sua conta que recebe o pagamento imediato. Até 77 caracteres.
number
required
Valor do pagamento imediato.
string
required
Cidade do recebedor, até 15 caracteres.
string
CEP do recebedor.
string
default:"0000"
Código de categoria (MCC), até 4 caracteres.
string
Mensagem exibida ao pagador, até 140 caracteres.
string
CPF (11 dígitos) ou CNPJ (14 dígitos) do pagador.
string
Nome do pagador, até 25 caracteres.
string
default:"NOT_ALLOWED"
Se o pagador pode alterar o valor:
NOT_ALLOWED ou ALLOWED. Não envie null.number
default:"86400"
Validade da cobrança, em segundos. É também o prazo para o pagador autorizar.
object[]
boolean
default:"false"
Se o QR Code pode ser pago mais de uma vez. Mantenha
false no Pix Automático.object
required
Dados da recorrência. Envie todos os campos obrigatórios: neste endpoint, a falta de um deles retorna
500.Show recurrenceData
Show recurrenceData
string
Identificador da recorrência, 29 caracteres. Gerado pela API se omitido.
string
required
WEEKLY, MONTHLY, QUARTERLY, SEMIANNUAL ou ANNUAL.string
required
Data da primeira cobrança recorrente,
YYYY-MM-DD.string
Data final,
YYYY-MM-DD.number
Valor fixo de cada cobrança. Não envie junto com
minPayerMaxAmount.number
Piso do valor máximo do pagador, para valor variável.
object
required
Devedor:
type (NATURAL ou LEGAL), document e name, todos obrigatórios.string
required
Identificador do contrato, até 35 caracteres.
string
Descrição exibida ao pagador, até 35 caracteres.
string
required
NOT_ALLOWED ou ALLOWED.Response
201 Created. Os mesmos campos de Criar QR Code de autorização, com payloadJws preenchido com a cobrança imediata.
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/immediate-payment' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"key": "e7c3d5f2-4a1b-4c3d-9d15-1b2c3d4e5f60",
"city": "Sao Paulo",
"originalAmount": 49.90,
"qrExpiration": 3600,
"recurrenceData": {
"recurrenceId": "RR3822485720261027F6E5D4C3B2A",
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-11-27",
"debtor": { "type": "NATURAL", "document": "12345678901", "name": "Joao da Silva" },
"amount": 49.90,
"contractNumber": "CTR-123456",
"contractDescription": "Plano Premium",
"retry": "ALLOWED"
}
}'
{
"documentId": "01000000-3353-6e2c-12c9-08de9f179024",
"revision": "0",
"qrCodeImageBase64": "iVBORw0KGgoAAAANSUhEUgAAASQAAAEkAQAAAACugnFBAAAD60lEQVR4nO2a...",
"payloadBase64": "MDAwMjAxMjYxODAwMTRici5nb3YuYmNiLnBpeDUyMDQwMDAw...",
"payloadPix": "00020101021226...80...6304A1B2",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6...",
"compositePayloadJws": null,
"recurrencePayloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjE0NzhFNDZB..."
}