Ficha técnica

Alcances necesarios

El token para consumir la API de Pagos Recurrentes debe generarse utilizando el Authorization Code.

Es necesario incluir uno de los siguientes alcances:

Alcance	Descripción
brn:btg:empresas:banking:payments	Permite la consulta y emisión de pagos

---

Especificidades

QR CODE

Solo es posible realizar la recurrencia de QR Codes ESTÁTICOS. Los QR Codes dinámicos no están habilitados para realizar la recurrencia.

PIX_AUTOMATIC

La realización del PIX_AUTOMATIC solo es posible cuando el basePayment.type es PIX_QR_CODE y representa la JORNADA 2 del producto de Pix Automático del BACEN Pix Automático.

---

Eventos de webhook

La propiedad "detail" adoptará el formato correspondiente a su "type". Consulte la API Reference de Crear iniciación de pago o transferencia

Eventos posibles

Eventos	Descripción
payments.recurrence-dispatched	Recurrencia enviada
payments.recurrence-created	Recurrencia de pago creada
payments.recurrence-approved	Recurrencia de pago aprobada

Los payloads disponibles a continuación representan el contenido del campo data.

payments.recurrence-dispatched

{
  "eventType": "DISPATCHED_RECURRENCE_EVENT",
  "id": "eb269755-e8d0-4651-ba10-80dcea8f733d",
  "type": "PIX_AUTOMATIC",
  "systemOrigin": "RAPI",
  "status": "DISPATCHED",
  "periodicity": {
    "type": "MONTHLY",
    "detail": {
      "startDate": "2025-06-13"
    }
  },
  "basePayment": {
    "type": "PIX_AUTOMATIC",
    "amount": 889.04,
    "debitParty": {
      "taxId": "37297902000141",
      "name": "VECHI CONSULTORIA E PROJETOS LTDA",
      "account": {
        "type": "CC",
        "number": "003886850",
        "branch": "50",
        "bankCode": "208"
      }
    },
    "detail": {
      "creditParty": {
        "taxId": "99999918999924",
        "name": "Pix Tester 918"
      }
    }
  },
  "detail": {
    "pixRecurrenceId": "RR999999182025061382855162808",
    "ispb": "99999918",
    "recurringChargeId": "25477622",
    "allowOverdraftUsage": false,
    "debtor": {
      "name": "BANCO BTG PACTUAL S.A.",
      "taxId": "30306294000145"
    },
    "shouldNotifyScheduling": true,
    "journey": "ONE"
  }
}

payments.recurrence-approved

{
    "eventType": "APPROVED_RECURRENCE_EVENT",
    "id": "eb269755-e8d0-4651-ba10-80dcea8f733d",
    "type": "PIX_AUTOMATIC",
    "systemOrigin": "RAPI",
    "status": "APPROVED",
    "periodicity": {
        "type": "MONTHLY",
        "detail": {
            "startDate": "2025-06-13"
        }
    },
    "basePayment": {
        "type": "PIX_AUTOMATIC",
        "amount": 889.04,
        "debitParty": {
            "taxId": "37297902000141",
            "name": "VECHI CONSULTORIA E PROJETOS LTDA",
            "account": {
                "type": "CC",
                "number": "003886850",
                "branch": "50",
                "bankCode": "208"
            }
        },
        "detail": {
            "creditParty": {
                "taxId": "99999918999924", //masked taxId
                "name": "Pix Tester 918"
            }
        }
    },
    "detail": {
        "pixRecurrenceId": "RR999999182025061382855162808",
        "ispb": "99999918",
        "recurringChargeId": "25477622",
        "allowOverdraftUsage": false,
        "debtor": {
            "name": "BANCO BTG PACTUAL S.A.",
            "taxId": "30306294000145"
        },
        "shouldNotifyScheduling": true,
        "journey": "ONE"
    }
}

payments.recurrence-created

{
    "eventType": "CREATED_RECURRENCE_EVENT",
    "id": "08357984-2e78-4500-8acf-f2b5eaaf359a",
    "type": "PIX_AUTOMATIC",
    "systemOrigin": "RAPI",
    "status": "CREATED",
    "periodicity": {
        "type": "MONTHLY",
        "detail": {
            "startDate": "2025-06-16",
            "endDate": "2025-07-16"
        }
    },
    "basePayment": {
        "type": "PIX_AUTOMATIC",
        "amount": 0.25,
        "debitParty": {
            "taxId": "37297902000141",
            "name": "VECHI CONSULTORIA E PROJETOS LTDA",
            "account": {
                "type": "CC",
                "number": "003886850",
                "branch": "50",
                "bankCode": "208"
            }
        },
        "detail": {
            "creditParty": {
                "taxId": "47328649000108",
                "name": "INSTITUTO PACTO PELO ESPORTE"
            }
        }
    },
    "detail": {
        "pixRecurrenceId": "RN30306294202506137f5050eefa4",
        "ispb": "30306294",
        "recurringChargeId": "teste sender",
        "allowOverdraftUsage": false,
        "debtor": {
            "name": "vechi",
            "taxId": "37297902000141"
        },
        "shouldNotifyScheduling": true,
        "journey": "ONE"
    }
}