Autorização de Pix Automático

Segurança

📘
BTG Id
O Authorization Server do BTG Empresas se chama BTG Id. Usando o BTG Id, um aplicativo parceiro consegue consentimento e autorização para executar operações nas APIs do BTG em nome do cliente. Para saber mais, acesse a documentação do BTG Id

Escopos necessários

O token para consumir a API de Autorização de pix automático deve ser gerado usando o Authorization Code.

É necessário incluir o seguinte escopo:

Escopo	Descrição
brn:btg:empresas:banking:collections	Permite a consulta e gestão de cobrança

Especificidades

Autorização com valor variável

Para a emissão de autorização de pix automático com valor variável é necessário que o campo amount não seja enviado. Desta maneira, o sistema irá inferir que não um valor fixo.

Eventos de webhook

Os payloads disponíveis abaixo representam o conteúdo do campo data, seguindo o formato do envio descrito em Eventos.

automatic-pix.authorization-created

{
    "authorizationId": "1a34ece5-8ae1-4659-977e-b5bac829c4eb",
    "createdAt": "2025-06-28T01:41:20.901Z",
    "initialDate": "2025-07-30",
    "link": {
        "contract": "270620251040",
        "debtor": {
            "taxId": "***153188**",
            "name": "Nome do Pagador",
            "personType": "F"
        }
    },
    "origin": "DEVELOPERS",
    "payee": {
        "taxId": "00000000000000",
        "name": "Nome da Empresa",
        "personType": "J",
        "account": {
            "number": "000000000",
            "branchCode": "50",
            "status": "PARTIALLY_BLOCKED"
        },
        "desk": "PME"
    },
    "period": "MONTHLY",
    "requests": [],
    "retryPolicy": "ACCEPT_3R_7D",
    "status": "CREATED",
    "updatedAt": "2025-06-28T01:41:20.901Z",
    "useLineOfCredit": true,
    "activation": {
        "journeyType": "WAITING_DEFINITION",
        "txId": "b49adc6480d84eda87b3653cedc2a6fc"
    },
    "externalId": "36daac06-eaeb-4fe7-8088-c59f38d585be",
    "finalDate": "2026-05-30",
    "location": {
        "locationId": "31231abb-c822-43a6-8bfd-7c13c4d9b359",
        "payeeTaxId": "00000000000000",
        "typeCob": "REC",
        "createdAt": "2025-06-28T01:41:23.008Z",
        "externalId": 9082893086585425000,
        "externalUrl": "api.developer.btgpactual.com/pc/p/v2/rec/361be04ccc8a48fe95376bfcfb4bdeec",
        "path": "00000000000000/31231abb-c822-43a6-8bfd-7c13c4d9b359.png",
        "url": "https://static.empresas.btgpactual.com/pix/dynamic/qrcode/00000000000000/31231abb-c822-43a6-8bfd-7c13c4d9b359.png"
    },
    "minimumAmountPayee": 0.01,
    "qrCodeInfo": {
        "emv": "00020101021226910014br.gov.bcb.pix2569api.developer.btgpactual.com/pc/p/v2/3***80950014br.gov.bcb.pix2573api.developer.btgpactual.com/pc/p/v2/rec/361be04ccc8a48fe95376bfcfb4bdeec6304C47B",
        "journeyType": "JOURNEY_3"
    },
    "totalInstallments": 10
}

automatic-pix.scheduling-approved

{
    "authorizationId": "1a34ece5-8ae1-4659-977e-b5bac829c4eb",
    "createdAt": "2025-06-28T01:41:20.901Z",
    "initialDate": "2025-07-30",
    "link": {
        "contract": "270620251040",
        "debtor": {
            "name": "Nome do Pagador",
            "taxId": "***153188**",
            "personType": "F"
        }
    },
    "origin": "DEVELOPERS",
    "payee": {
        "name": "Nome da Empresa",
        "taxId": "00000000000000",
        "personType": "J",
        "account": {
            "branchCode": "50",
            "number": "000000000"
        },
        "desk": "PME"
    },
    "period": "MONTHLY",
    "requests": [],
    "retryPolicy": "ACCEPT_3R_7D",
    "status": "APPROVED",
    "updatedAt": "2025-06-28T01:44:29.716Z",
    "useLineOfCredit": true,
    "activation": {
        "journeyType": "JOURNEY_3",
        "txId": "b49adc6480d84eda87b3653cedc2a6fc"
    },
    "approvedAt": "2025-06-28T01:44:29.716Z",
    "externalId": "36daac06-eaeb-4fe7-8088-c59f38d585be",
    "finalDate": "2026-05-30",
    "location": {
        "locationId": "31231abb-c822-43a6-8bfd-7c13c4d9b359",
        "payeeTaxId": "00000000000000",
        "typeCob": "REC",
        "createdAt": "2025-06-28T01:41:23.000Z",
        "path": "00000000000000/31231abb-c822-43a6-8bfd-7c13c4d9b359.png",
        "url": "https://static.empresas.btgpactual.com/pix/dynamic/qrcode/00000000000000/31231abb-c822-43a6-8bfd-7c13c4d9b359.png"
    },
    "minimumAmountPayee": 0.01,
    "payer": {
        "taxId": "***153188**",
        "personType": "F",
        "account": {
            "number": "000000000",
            "branchCode": "00",
            "ispbParticipant": "00000000"
        }
    },
    "qrCodeInfo": {
        "journeyType": "JOURNEY_3",
        "emv": "00020101021226910014br.gov.bcb.pix2569api.developer.btgpactual.com/pc/p/v2/3***80950014br.gov.bcb.pix2573api.developer.btgpactual.com/pc/p/v2/rec/361be04ccc8a48fe95376bfcfb4bdeec6304C47B"
    },
    "totalInstallments": 10
}