Create Authorization Journey 1

Esta página irá guiá-lo através das solicitações de autorização usadas pela jornada 1.

Solicitação de autorização para pagamento recorrente

Requisição

POST 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/authorizations'

Cabeçalhos

Nome	Descrição
Authorization	Obrigatório. Chave da API
idempotencyKey	Obrigatório. Guid

Corpo

Nome	Tipo	Descrição
recurrenceId	string	Opcional. Identificador da recorrência
frequencyType	enum	Obrigatório. Tipo de frequência. Domínios: WEEKLY, MONTHLY, QUARTERLY, SEMIANNUALLY, ANNUALLY
recurrenceStartDate	string	Obrigatório. Data de início da recorrência
recurrenceEndDate	string	Opcional. Data de fim da recorrência
amount	number	Opcional. Valor da transação
minPayerMaxAmount	number	Opcional. Valor mínimo permitido para o valor máximo do pagador
beneficiary	object	Obrigatório. Objeto contendo todas as informações do beneficiário
beneficiary.ispb	string	Obrigatório. Código ISPB do beneficiário
beneficiary.document	string	Obrigatório. Documento do beneficiário (CPF/CNPJ)
beneficiary.name	string	Obrigatório. Nome completo do beneficiário
beneficiary.agencyNumber	string	Opcional. Agência do beneficiário
beneficiary.accountType	enum	Opcional. Tipo de conta do beneficiário. Domínios: CURRENT, WAGE, SAVINGS, PAYMENT
beneficiary.accountNumber	string	Opcional. Número da conta do beneficiário
payer	object	Obrigatório. Objeto contendo todas as informações do pagador
payer.ispb	string	Obrigatório. Código ISPB do pagador
payer.type	enum	Obrigatório. Tipo do documento do pagador. Domínios: NATURAL - Pessoa Física LEGAL - Pessoa Jurídica
payer.document	string	Obrigatório. Documento do pagador (CPF/CNPJ)
payer.name	string	Opcional. Nome completo do pagador
payer.agencyNumber	string	Opcional. Agência do pagador
payer.accountType	enum	Opcional. Tipo de conta do pagador. Domínios: CURRENT, WAGE, SAVINGS, PAYMENT
payer.accountNumber	string	Opcional. Número da conta do pagador
payer.municipalityIbgeCode	number	Opcional. Código IBGE do município do pagador
debtor	object	Opcional. Objeto contendo todas as informações do devedor
debtor.type	enum	Obrigatório. Tipo do documento do devedor. Domínios: NATURAL - Pessoa Física LEGAL - Pessoa Jurídica
debtor.document	string	Obrigatório. Documento do devedor (CPF/CNPJ)
debtor.name	string	Obrigatório. Nome completo do devedor
contractNumber	string	Obrigatório. Número do contrato
contractDescription	string	Opcional. Descrição do contrato
requestExpiresAt	string	Obrigatório. Data/hora de expiração da solicitação

{
  "recurrenceId": "RR3822485720250711nDNIOOcVSOr",
  "frequencyType": "MONTHLY",
  "recurrenceStartDate": "2025-06-29",
  "recurrenceEndDate": "2026-06-29",
  "amount": 150.75,
  "minPayerMaxAmount": 150.75,
  "beneficiary": {
    "ispb": "38224857",
    "document": "12345678901",
    "name": "Fulano Ciclano",
    "agencyNumber": "0001",
    "accountType": "CURRENT",
    "accountNumber": "31747"
  },
  "payer": {
    "ispb": "38224857",
    "type": "NATURAL",
    "document": "07161543584",
    "name": "Beltrano",
    "agencyNumber": "0001",
    "accountType": "CURRENT",
    "accountNumber": "12345"
  },
  "debtor": {
    "type": "NATURAL",
    "document": "07161543584",
    "name": "Beltrano"
  },
  "contractNumber": "CONTRATO123",
  "contractDescription": "Assinatura Premium",
  "requestExpiresAt": "2025-06-15T12:05:00.000Z"
}

Resposta

O status code 200 indica sucesso na consulta.

Em caso de sucesso, o retorno terá os seguintes campos em formato JSON:

{
  "recurrenceId": "RR3822485720250711nDNIOOcVSOr",
  "requestAt": "2025-07-11T15:39:12.054"
}