Pix Automático

Existem 4 jornadas distintas que podem ser feitas para o Pix Automático. Esta página irá servir de guia sobre como cada uma delas funciona e como utilizá-las.

Jornada 1

Esta jornada envolve o beneficiário inserindo as informações do pagador. Após o envio, o pagador analisa e fornece autorização explícita para o Contrato de Pagamento Recorrente.

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

Este endpoint é usado para iniciar o processo de autorização, onde o usuário final receberá as informações do contrato inseridas no corpo deste endpoint.

Request

POST 'https://apisandbox.delbank.com.br/baas/api/v1/píx/automatic/authorizations'

Headers

Name	Description
Authorization	Obrigatório. API key
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.
idempotencyKey	Obrigatório. Guid

Body

{
  "frequencyType": "MONTHLY",
  "recurrenceStartDate": "2025-06-29",
  "recurrenceEndDate": "2025-07-01",
  "amount": 150.75,
  "payer": {
    "ispb": "38224857",
    "type": "NATURAL",
    "document": "07161543584",
    "agencyNumber": "0001",
    "accountNumber": "31747"
  },
  "beneficiary": {
    "ispb": "38224857",
    "document": "12345678901",
    "name": "Fulano Ciclano"
  },
  "recurrenceCreatedAt": "2025-06-15T12:00:00.000Z",
  "requestCreatedAt": "2025-06-15T12:05:00.000Z",
  "requestExpiresAt": "2025-06-15T12:05:00.000Z",
  "contractNumber": "CONTRATO123",
  "contractDescription": "Assinatura Premium"
}

Resposta

O código de status 200 indica sucesso na consulta.

Se a consulta for bem-sucedida, o retorno terá os seguintes campos em formato JSON:

{
    "jdpiRequestId": "01000000-6b39-f007-983f-08ddc0911588",
    "recurrenceId": "RR3822485720250711nDNIOOcVSOr",
    "jdpiRequestDateTime": "2025-07-11T15:39:12.054Z"
}

Respondendo a solicitação de autorização

Este endpoint permite que o usuário final autorize ou não um contrato.

Request

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

Headers

Name	Description
Authorization	Obrigatório. API key
x-delfinance-account-id	Obrigatório. The Delfinance bank account number
idempotencyKey	Obrigatório. Guid

Path Parameters:

Name	Type	Description
identifier	string	Obrigatório. Authorization identifier

Body

{
  "AuthorizationResult": true
}

Resposta

O código de status 200 indica sucesso na consulta.

Se a consulta for bem-sucedida, o retorno terá os seguintes campos em formato JSON:

{
"id":"RR0435879820240605njua7shf40o",
"requestId":"70F945C1-9024-4123-1001-A1DE2A0000D1",
"createdAt":"2025-04-13T10:10:05.025Z"
}

Próximo passo

Após concluir o processo de autorização, o pagador efetuará os pagamentos automáticos na data de vencimento do contrato. Observe que o contrato ainda pode ser cancelado a qualquer momento.

Jornada 2

Nesta jornada, o pagador inicia o processo escaneando um QR code que contém os detalhes do Contrato de Pagamento Recorrente. O pagador então analisa e autoriza o contrato diretamente por meio da interação com o código QR.

QR code Composto

Este endpoint é usado para criar um QR code composto que servirá como contrato de pagamento recorrente.

Request

POST 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences'

Headers

Name	Description
x-delbank-api-key	Required. API key
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.

Body

{
  "responseFormat": "ONLY_PAYLOAD",
  "city": "string",
  "frequencyType": "WEEKLY",
  "recurrenceStartDate": "string",
  "recurrenceEndDate": "string",
  "amount": 0,
  "maxAmountFloor": 0,
  "beneficiary": {
    "ispb": 0,
    "cnpj": 0,
    "name": "string"
  },
  "debtor": {
    "legalType": 0,
    "document": 0,
    "name": "string"
  },
  "contractNumber": "string",
  "contractDescription": "string",
  "retry": "NOT_ALLOWED",
  "beneficiaryConciliationId": "string"
}

Resposta

O código de status 200 indica sucesso na consulta.

Se a consulta for bem-sucedida, o retorno terá os seguintes campos em formato JSON:

{
    "id": "01000000-7337-ce0d-87ae-08dd9249fd05",
    "imagemQRCodeInBase64": "iVBORw0KGgoAAAANSUhEUgAAAVQAAAFUAQAAAABT6fkYAAAFPUlEQVR4nO2bQXLjQAhFuQH3vyU3YPq/T8vOZio7sYgnFcvykyu4afiAJvrXj4o/9o/dx0ZERp2n87IrdXWe8+f1eYrMNrKGTf+UgIxzVVVklU5VgiXIGlZ//zl5LAvhx75joQ50HZ8DsollTerYcqw6B+cNrD0vsjay+sJZBPvIueicimZ1OpaxPSfOiuj7P46vKxLj7OY//Oxt1t7838ePffw2S1xrvnqcvhxJODwmN9Z/xcm32eMwx80xUj7EvhRP3Eu9ZmHWsETo480NWNqi2o28U3Cdm9jCdYh7jXHydiUUWaUrdXH0GlahA+fhZGtBzkEontTsTK3IGhbHEEA4IbiQC/MaG4HLb2H9JiY5/80KKLHEZJioXMPKv3UycRGWIZM1Qi45ydxYsoBNO7P8u9pCA9PSIKZd2zawRJH4bMgkEvIB16dmD+9gKwh+iKHGSiH2ndmYX/z7bLYFchExkEjtEC5kQsv1nQUsFmkFYnaiY53Umz6AUkQKdAs75+UkxDg7kQKJ5b5O19WeC1ifdwbHhrLAcP5D3j++s4IN...",
    "payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJjYWxlbmRhcmlvIjp7ImV4cGlyYWNhbyI6ODY0MDAsImNyaWFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoiLCJhcHJlc2VudGFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoifSwidmFsb3IiOnsib3JpZ2luYWwiOiIxMDAwLjAxIiwibW9kYWxpZGFkZUFsdGVyYWNhbyI6MH0sInJldmlzYW8iOjEsImRldmVkb3IiOnsiY25waiI6IjQzNTg3OTgwMDAxMDciLCJub21lIjoiQ2ljbGFubyBkZSBUYWwifSwiY2hhdmUiOiIwNTg3NjkzMjU4MiIsInR4aWQiOiJ2Y2hhcmdlNTAyNmI1MmIwM2YwNDk2ZTlhMWQ3NjEwZSI...",
    "payloadJwsRecorrencia": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJpZFJlYyI6IlJSMDQzNTg3OTgyMDI0MDYwNW5qdWE3c2hmNDBvIiwidmluY3VsbyI6eyJvYmpldG8iOiJDb250YSBkZSBlbmVyZ2lhIiwiZGV2ZWRvciI6eyJjcGYiOiIwNDYyMzIxNzAzNSIsImNucGoiOiIiLCJub21lIjoiQ2ljbGFubyBkYSBTaWx2YSJ9LCJjb250cmF0byI6IjEyMzQ1Njc4OTBBQkMifSwiY2FsZW5kYXJpbyI6eyJkYXRhSW5pY2lhbCI6IjIwMjQtMDEtMTAiLCJkYXRhRmluYWwiOiIyMDI2LTAxLTEwIiwicGVyaW9kaWNpZGFkZSI6IkFOVUFMIn0sInZhbG9yIjp7InZhbG9yTWluaW1vUmVjZWJl..."
}

Próximo passo

Após concluir o processo de autorização, o pagador efetuará os pagamentos automáticos na data de vencimento do contrato. Observe que o contrato ainda pode ser cancelado a qualquer momento.

Jornada 3

Esta jornada começa com o pagador escaneando um QR code que apresenta o Contrato de Pagamento Recorrente. A autorização é concedida implicitamente por meio da execução do primeiro pagamento. Se o pagamento inicial não for concluído, o contrato será automaticamente cancelado.

QR code Composto Imediato

Este ponto final é usado para criar um QR code composto imediato que, uma vez pago, servirá como autorização para o contrato de pagamento recorrente.

Request

POST 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/immediate-payment'

Headers

Name	Description
x-delbank-api-key	Obrigatório. API key
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.

Body

{
  "responseFormat": "ONLY_PAYLOAD",
  "key": "string",
  "categoryCode": "stri",
  "payerRequest": "string",
  "payerDocument": "stringstrin",
  "payerName": "string",
  "city": "string",
  "zipCode": "string",
  "originalAmount": 0,
  "changeValue": "NOT_ALLOWED",
  "qrExpiration": 0,
  "additionalData": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "reusable": true,
  "recurrenceData": {
    "frequencyType": "WEEKLY",
    "recurrenceStartDate": "0829-80-89",
    "recurrenceEndDate": "string",
    "beneficiary": {
      "ispb": 0,
      "cnpj": 0,
      "name": "string"
    },
    "debtor": {
      "legalType": 0,
      "document": 0,
      "name": "string"
    },
    "amount": 0,
    "maxAmountFloor": 0,
    "contractNumber": "string",
    "contractDescription": "string",
    "retry": "NOT_ALLOWED"
  },
  "beneficiaryConciliationId": "string"
}

Resposta

O código de status 200 indica sucesso na consulta.

Se a consulta for bem-sucedida, o retorno terá os seguintes campos em formato JSON:

{
    "idDocumento": "01000000-7337-ce0d-87ae-08dd9249fd05",
    "imagemQRCodeInBase64": "iVBORw0KGgoAAAANSUhEUgAAAVQAAAFUAQAAAABT6fkYAAAFPUlEQVR4nO2bQXLjQAhFuQH3vyU3YPq/T8vOZio7sYgnFcvykyu4afiAJvrXj4o/9o/dx0ZERp2n87IrdXWe8+f1eYrMNrKGTf+UgIxzVVVklU5VgiXIGlZ//zl5LAvhx75joQ50HZ8DsollTerYcqw6B+cNrD0vsjay+sJZBPvIueicimZ1OpaxPSfOiuj7P46vKxLj7OY//Oxt1t7838ePffw2S1xrvnqcvhxJODwmN9Z/xcm32eMwx80xUj7EvhRP3Eu9ZmHWsETo480NWNqi2o28U3Cdm9jCdYh7jXHydiUUWaUrdXH0GlahA+fhZGtBzkEontTsTK3IGhbHEEA4IbiQC/MaG4HLb2H9JiY5/80KKLHEZJioXMPKv3UycRGWIZM1Qi45ydxYsoBNO7P8u9pCA9PSIKZd2zawRJH4bMgkEvIB16dmD+9gKwh+iKHGSiH2ndmYX/z7bLYFchExkEjtEC5kQsv1nQUsFmkFYnaiY53Umz6AUkQKdAs75+UkxDg7kQKJ5b5O19WeC1ifdwbHhrLAcP5D3j++s4INnCcU4xwCXTUFm7PqVlBb2LQKkgLSIohvrsaftD1Va+caVk5O3hs5Z7exzPC7Lqf3sEmZX0g6Eku7lKY2dfy7vZUFbKKUw5qYOokAQsHaRMIkly9ixz2onYh3aP2pnUbhrWGbil9ouRxBbzqfe6vyeg1roSGnCZpWgYgrJBx7c/xrC2tNoRWQeXzz3qEO3qi6z7q9z1oQl7uY5BhlksmDk8K79rA4uCnWg4IpJp6AuLJew8qmpIYeJ2nHEiXtm8a/89DLrKU8/W1kED9K3E6H+cN3FrA6CodrelbhRKN61d0AfuUatpwA0Rrh4n8EvntYpJavPsHbLMUTKo6yz5naGZtdqoV5+gQL2NEZ+Me4DJ9A1erJTX7V/q+znJ36351hzGyaLCzCdAW2sMp6dhx6bngKfQBGYjWjhTVsuE/FP29QN2Jreirs01rE2qlJLYrM0kXKjp5zqISKJ7dsYJWeqaDxGQv8SSk1IQY9uoWlmclwjsBNFie6RLtFkR9tv4F1bVS3fG7X+x7KMGou55otbM9wvGbGFSQUSlIn9vqqAxawlEnEEI6C2VFc+emzcfP8Ava6t0W+7JupF0/eAnlz9wLWzUAHY2dEmvAY5PHBJ/atYGlbeeYpc8L9CnwnudnDb29hGXM5PAdj0WaShNCgaMp6tNEGdu6VIByPiKcnX14bR8CnN/g+2zWTDVWoOcLN8y7WZaTyGhbz6EtQQk1/jWVBjc6tKmtYd6vIfgnvrptvVHICf2a3G9iaapo7fZh48GIkaU+C6TUslT3fvkfK7r7SYnM73lObNaybrKTAGJFEFLF6njnp0wt6n+XPt0C2ziRAu6cZvo8qntp/AdvelG5SEKEp/R2w3fnG/bewMwd1IdK+nS48+8pwByDz+R7eZwnGlBtXbSp0MKLD9dst+TWssb7jpOkSl7ejs0re3LKBjRi3dtcNP48nKIalR+xhLYR1GHZxp/F+RBwD0lzD1m2i9IwKsIb9WrNpH220ge3ZjGkFGjGjRguNZnbw6KgFrOfJNQOvrJypBz7FG9/a/n2W7E3mVpbJ6V5F9l2Z/tROG1hK/wZg3Dx9eV3EQnjr9hrWShN972rPiSWtPcsN+qc2XcDSnCKjjN6kFxi+9aeY1Hz1Vlawntn6Ijs/t0z4JsEpUTex8hWhFkGMmGlZZU3q2cS6UiKKuLHJPT9c+ZnN7GGDgEeYy/n/ME7e7mAVc/Pcw/728cf+sevYf9YBpg0XyvTXAAAAAElFTkSuQmCC",
    "payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJjYWxlbmRhcmlvIjp7ImV4cGlyYWNhbyI6ODY0MDAsImNyaWFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoiLCJhcHJlc2VudGFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoifSwidmFsb3IiOnsib3JpZ2luYWwiOiIxMDAwLjAxIiwibW9kYWxpZGFkZUFsdGVyYWNhbyI6MH0sInJldmlzYW8iOjEsImRldmVkb3IiOnsiY25waiI6IjQzNTg3OTgwMDAxMDciLCJub21lIjoiQ2ljbGFubyBkZSBUYWwifSwiY2hhdmUiOiIwNTg3NjkzMjU4MiIsInR4aWQiOiJ2Y2hhcmdlNTAyNmI1MmIwM2YwNDk2ZTlhMWQ3NjEwZSIsInNvbGljaXRhY2FvUGFnYWRvciI6IlBlc3F1aXNhIGRlIHNhdGlzZmHDp8OjbyIsImluZm9BZGljaW9uYWlzIjpbeyJub21lIjoiRGV0YWxoZXMgZG8gUGFnYW1lbnRvIiwidmFsb3IiOiJJbmZvcm1hw6fDo28gQWRpY2lvbmFsIGRvIFBTUCBkbyBSZWNlYmVkb3IifV0sInN0YXR1cyI6IkFUSVZBIn0.dpBOamofQSKwfHTFQNxCCcAG2UPaFu4EQkoNXjcUqV7BkhvLiC9TwbPFzCw-r6qhTHouO-F4tAh_xzmH3gC-1rR1RQ_zALoLQ8-CgnhuTtoHCXEOX3wLR8jC-YTcwxWTw82RNgfUnUtZRys2zZWM4bqnWhQiMXcjTGdo__aAUHVH1zwRQM1cV1LIfWMOits-7gupdhqSmLoDAQjr0DqEgL7lXfoRaJazTbfCFCN0v0Hc_CPHLWJycn_xhqHIADqb22-9aV0T95HxEobVFemXVBeZoGeDcXJkmjdUqhrYWQnXgLxwOKKwPfJYMJ_K9Ll1f0SaMOMZ7wZHECZgvFETug",
    "payloadJwsRecorrencia": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJpZFJlYyI6IlJSMDQzNTg3OTgyMDI0MDYwNW5qdWE3c2hmNDBvIiwidmluY3VsbyI6eyJvYmpldG8iOiJDb250YSBkZSBlbmVyZ2lhIiwiZGV2ZWRvciI6eyJjcGYiOiIwNDYyMzIxNzAzNSIsImNucGoiOiIiLCJub21lIjoiQ2ljbGFubyBkYSBTaWx2YSJ9LCJjb250cmF0byI6IjEyMzQ1Njc4OTBBQkMifSwiY2FsZW5kYXJpbyI6eyJkYXRhSW5pY2lhbCI6IjIwMjQtMDEtMTAiLCJkYXRhRmluYWwiOiIyMDI2LTAxLTEwIiwicGVyaW9kaWNpZGFkZSI6IkFOVUFMIn0sInZhbG9yIjp7InZhbG9yTWluaW1vUmVjZWJlZG9yIjoiMTAwMC4wMCJ9LCJyZWNlYmVkb3IiOnsiY25waiI6IjU4NzY5MzI1ODIiLCJub21lIjoiQWxpc3NvbiBPbGl2ZWlyYSBOZXZlcyAiLCJpc3BiUGFydGljaXBhbnRlIjoiMzgyMjQ4NTcifSwicG9saXRpY2FSZXRlbnRhdGl2YSI6IlBFUk1JVEVfM1JfN0QiLCJhdHVhbGl6YWNhbyI6W3sic3RhdHVzIjoiQ1JJQURBIiwiZGF0YSI6IjIwMjUtMDUtMTNUMTg6MTQ6MjMuMTc0WiJ9XX0.jR6WOfYR4nQNWGYmhTyfK9PQkd03IjT4bpRDoXy1KMX2mNhpRGISAoAnLBg5IaQ8g7dm0c27TrwLJ97O9m1GLgLzmjQxYYPWyG0bs16yXkBrUH4MhmjREUgXs3bvSPLbPlWVAHPQTSCENm0CmtODF6RIE-UVWxAlqgl8WvRCFq_2N3i2LPa4r8r1W02nIC5y2S72k_BYYbmDHKlHBzR8DDqrZiqpbE7ny6N8HetGLOZpWD7gO7bRa2XKOuAv7tq6dRPRtL6woNnCdAXRoiTR_M2av2ak7bMdJ_T5aPHnlk-7RFSVRrhRxH1z8Beb-EdUMK5602hKmeiDK_rYeK-rsw"
}

Próximo passo

Após concluir o processo de pagamento, o pagador fará os pagamentos automáticos na próxima data de vencimento do contrato. Observe que o contrato ainda pode ser cancelado a qualquer momento.

Jornada 4

Neste cenário, o pagador escaneia um QR code com "Data de Vencimento" ou "Estático" para revisar o Contrato de Pagamento Recorrente. A autorização é fornecida efetuando o primeiro pagamento imediatamente ou agendando-o. Esta ação de pagamento inicial serve como confirmação da autorização do contrato pelo pagador.

QR Code Composto Estático

Uma das duas opções que você pode usar é um QR code estático. Neste formato, o pagador pode efetuar o primeiro pagamento imediatamente ou agendá-lo, autorizando assim o contrato de pagamento recorrente.

Request

POST 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/static'

Headers

Name	Description
x-delbank-api-key	Obrigatório. API key
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.

Body

{
  "responseFormat": "ONLY_PAYLOAD",
  "key": "string",
  "categoryCode": "string",
  "amount": 0,
  "city": "string",
  "zipCode": "string",
  "beneficiaryConciliationId": "string",
  "additionalData": "string",
  "ispbFss": "string",
  "recurrenceData": {
    "frequencyType": "WEEKLY",
    "recurrenceStartDate": "1191-81-52",
    "recurrenceEndDate": "string",
    "beneficiary": {
      "ispb": 0,
      "cnpj": 0,
      "name": "string"
    },
    "debtor": {
      "legalType": 0,
      "document": 0,
      "name": "string"
    },
    "amount": 0,
    "maxAmountFloor": 0,
    "contractNumber": "string",
    "contractDescription": "string",
    "retry": "NOT_ALLOWED"
  }
}

Resposta

O código de status 200 indica sucesso na consulta.

Se a consulta for bem-sucedida, o retorno terá os seguintes campos em formato JSON:

{
    "payloadBase64": "MDAwMjAxMjYzMzAwMTRici5nb3YuYmNiLnBpeDAxMTEwNTg3NjkzMjU4MjUyMDQwMDAwNTMwMzk4NjU0MDcxMTAwLjAxNTgwMkJSNTkyM0FsaXNzb24gT2xpdmVpcmEgTmV2ZXMgNjAwOVNhbyBQYXVsbzYxMDkwMTIyNy0yMDA2MjI1MDUyMXZjaGFyZ2U0YmYxMGQzNzljNTU0ZjgwNzEwMDE0YnIuZ292LmJjYi5waXgyNTQ5cGl4LWguZGVsYmFuay5jb20uYnIvdjEvcmVjL3ZjaGFyZ2U0YmYxMGQzNzljNTU0ZjYzMDQyOTFB",
    "payloadJwsRecorrencia": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJpZFJlYyI6IlJSMDQzNTg3OTgyMDI0MDYwNW5qdWE3c2hmNDBvIiwidmluY3VsbyI6eyJvYmpldG8iOiJDb250YSBkZSBlbmVyZ2lhIiwiZGV2ZWRvciI6eyJjcGYiOiIwNDYyMzIxNzAzNSIsImNucGoiOiIiLCJub21lIjoiQ2ljbGFubyBkYSBTaWx2YSJ9LCJjb250cmF0byI6IjEyMzQ1Njc4OTBBQkMifSwiY2FsZW5kYXJpbyI6eyJkYXRhSW5pY2lhbCI6IjIwMjQtMDEtMTAiLCJkYXRhRmluYWwiOiIyMDI2LTAxLTEwIiwicGVyaW9kaWNpZGFkZSI6IkFOVUFMIn0sInZhbG9yIjp7InZhbG9yTWluaW1vUmVjZWJlZG9yIjoiNTUwLjAwIn0sInJlY2ViZWRvciI6eyJjbnBqIjoiNTg3NjkzMjU4MiIsIm5vbWUiOiJBbGlzc29uIE9saXZlaXJhIE5ldmVzICIsImlzcGJQYXJ0aWNpcGFudGUiOiIzODIyNDg1NyJ9LCJwb2xpdGljYVJldGVudGF0aXZhIjoiUEVSTUlURV8zUl83RCIsImF0dWFsaXphY2FvIjpbeyJzdGF0dXMiOiJDUklBREEiLCJkYXRhIjoiMjAyNS0wNS0xM1QxODoyNzowOC45OThaIn1dfQ.gNyJtYD6if9spB91AT8vY__CqtOK6Yww3umwdVjKeP4SQqHdxr1hVMj0Iz5e328cjhaQA3krPcgeXRmOaS-CZyP2tUjvZ-6dpDe6KS8rWU5TNZwnI4LB2sL0dIDxT7lVE1YJ2RtcJrc_N-npnGy7x2jX4RSHNjmGi06347ufOBOV-OW_ycw3sNosFLyFIKzVl52ewT3ro4eEPvJfCkD8WKVwpypeKjvc1dwiBWm4CTQxj9soWkxcBxKD-dAppas15Ejq1aQlPA6WSsgVliC6e5W28QAy2ydxsuRnDlquxMTPbotZyp6lSZxlX7gtDmP8WTjhjX77iyJpfQyaQWeYNg"
}

QR code Composto com Data de Vencimento

A última das duas opções que você pode usar é um QR code com Data de Vencimento Dinâmica, que permite o uso de juros, multas e taxas de atraso. Neste formato, o pagador pode efetuar o primeiro pagamento imediatamente ou agendá-lo, autorizando assim o contrato de pagamento recorrente.

Request

POST 'https://apisandbox.delbank.com.br/baas/api/v1/pix/qrcode/recurrences/due-date'

Headers

Name	Description
x-delbank-api-key	Obrigatório. API key
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.

Body

{
  "responseFormat": "ONLY_PAYLOAD",
  "key": "string",
  "categoryCode": "stri",
  "beneficiaryFantasyName": "string",
  "beneficiaryConciliationId": "stringstringstringstringst",
  "beneficiaryAddress": "string",
  "city": "string",
  "state": "st",
  "zipCode": "string",
  "payerRequest": "string",
  "payerDocument": "stringstrin",
  "beneficiaryDocument": "stringstrin",
  "payerName": "string",
  "originalAmount": 0,
  "rebate": 0,
  "discount": 0,
  "interest": 0,
  "fine": 0,
  "finalAmount": 0,
  "dueDate": "1047-19-51",
  "daysAfterDue": 999999,
  "additionalData": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "reusable": true,
  "recurrenceData": {
    "frequencyType": "WEEKLY",
    "recurrenceStartDate": "7351-48-61",
    "recurrenceEndDate": "string",
    "beneficiary": {
      "ispb": 0,
      "cnpj": 0,
      "name": "string"
    },
    "debtor": {
      "legalType": 0,
      "document": 0,
      "name": "string"
    },
    "amount": 0,
    "maxAmountFloor": 0,
    "contractNumber": "string",
    "contractDescription": "string",
    "retry": "NOT_ALLOWED"
  }
}

Resposta

O código de status 200 indica sucesso na consulta.

Se a consulta for bem-sucedida, o retorno terá os seguintes campos em formato JSON:

{
"idDocumento":"52c43361-caa1-4ddb-9152-708426ª25db3",
"imagemQRCodeInBase64":"SkQuUElYLlFSQ29kZS5EaW5hbWljbw==……",
"payloadJws":"eyJhbGciOiJQUzUxMiIsImtpZCI6Ijg1MUI5ODdBNzEwQTk3MkM0QkIxODVFRUY4ODg1RTI4MzQzRUI1MDYi...",
"payloadJwsRecorrencia":"eyJhbGciOiJQUzUxMiIsImtpZCI6IjUwQTM5Qzc0MUE0RTFDQjQxN0Y2OEM2Q0MwMkY2M0JFO..."
}

Próximo passo

Após a conclusão do processo de pagamento, o pagador efetuará os pagamentos automáticos na próxima data de vencimento do contrato. Observe que o contrato ainda pode ser cancelado a qualquer momento.