curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/authorizations' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{apiKey}}' \
--header 'IdempotencyKey: {{$guid}}' \
--data '{
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-12-05",
"amount": 99.90,
"beneficiary": { "ispb": "38224857", "document": "11222333000181", "name": "SUA EMPRESA LTDA" },
"payer": { "ispb": "60701190", "type": "NATURAL", "document": "12345678901", "agencyNumber": "1234", "accountNumber": "567890" },
"contractNumber": "CTR-555001",
"contractDescription": "Plano Familia",
"requestExpiresAt": "2026-11-15T23:59:59.000Z"
}'
{
"recurrenceId": "RR3822485720261027B7C8D9E0F1A",
"requestedAt": "2026-10-27T14:32:10.512"
}
{
"code": "REQUEST_ERROR",
"instance": "/api/v1/automatic-pix/authorizations",
"errors": ["Payer.Document: Campo inválido."]
}
Pix Automático
Solicitar autorização
Envia uma solicitação de Pix Automático para a conta do pagador (jornada 1).
POST
/
baas
/
api
/
v1
/
pix
/
automatic
/
authorizations
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/authorizations' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{apiKey}}' \
--header 'IdempotencyKey: {{$guid}}' \
--data '{
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-12-05",
"amount": 99.90,
"beneficiary": { "ispb": "38224857", "document": "11222333000181", "name": "SUA EMPRESA LTDA" },
"payer": { "ispb": "60701190", "type": "NATURAL", "document": "12345678901", "agencyNumber": "1234", "accountNumber": "567890" },
"contractNumber": "CTR-555001",
"contractDescription": "Plano Familia",
"requestExpiresAt": "2026-11-15T23:59:59.000Z"
}'
{
"recurrenceId": "RR3822485720261027B7C8D9E0F1A",
"requestedAt": "2026-10-27T14:32:10.512"
}
{
"code": "REQUEST_ERROR",
"instance": "/api/v1/automatic-pix/authorizations",
"errors": ["Payer.Document: Campo inválido."]
}
Para o passo a passo completo, veja o guia Jornada 1: solicitação no app.
Headers
string
required
Sua API key, sem o prefixo
Bearer.string
required
Chave de idempotência. Use um valor novo a cada solicitação.
Body
string
Identificador da recorrência, 29 caracteres. Gerado pela API se omitido, com prefixo
RR.string
required
WEEKLY, MONTHLY, QUARTERLY, SEMIANNUAL ou ANNUAL. Se omitido, a API assume WEEKLY.string
required
Data da primeira cobrança,
YYYY-MM-DD.string
Data final,
YYYY-MM-DD.number
Valor fixo de cada cobrança. Necessário para as cobranças automáticas.
number
Piso do valor máximo do pagador, para valor variável.
object
required
object
required
object
Devedor, se for diferente do pagador:
type (NATURAL ou LEGAL), document e name.string
required
Identificador do contrato, exibido ao pagador.
string
Descrição exibida ao pagador.
string
required
Data e hora de expiração da solicitação, em UTC (ISO 8601). No máximo 30 dias após o envio.
Response
string
Identificador da recorrência.
string
Data e hora do pedido, em UTC, no formato
yyyy-MM-ddTHH:mm:ss.fff (sem Z).curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/authorizations' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{apiKey}}' \
--header 'IdempotencyKey: {{$guid}}' \
--data '{
"frequencyType": "MONTHLY",
"recurrenceStartDate": "2026-12-05",
"amount": 99.90,
"beneficiary": { "ispb": "38224857", "document": "11222333000181", "name": "SUA EMPRESA LTDA" },
"payer": { "ispb": "60701190", "type": "NATURAL", "document": "12345678901", "agencyNumber": "1234", "accountNumber": "567890" },
"contractNumber": "CTR-555001",
"contractDescription": "Plano Familia",
"requestExpiresAt": "2026-11-15T23:59:59.000Z"
}'
{
"recurrenceId": "RR3822485720261027B7C8D9E0F1A",
"requestedAt": "2026-10-27T14:32:10.512"
}
{
"code": "REQUEST_ERROR",
"instance": "/api/v1/automatic-pix/authorizations",
"errors": ["Payer.Document: Campo inválido."]
}