Receive a PIX Automatico payer-side authorization registration event

curl --request POST \
  --url https://api.example.com/v1/pix-automatico/events/authorization-payer-registered \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DataHoraEvento: <x-datahoraevento>' \
  --header 'X-NomeEvento: <x-nomeevento>' \
  --data '
{
  "dtHrCriacaoRecorrencia": "2024-06-05T14:25:49.025Z",
  "dtHrCriacaoSolicitacao": "2024-06-05T14:25:49.025Z",
  "dtHrExpiracaoSolicitacao": "2024-06-15T14:25:49.025Z",
  "dtInicialRecorrencia": "2024-01-10",
  "idRecorrencia": "RR0435879820240920njua7shf40o",
  "idReqJdPi": "45F763C6-7487-4363-9406-A1DE2A9636D3",
  "jornada": 1,
  "nrContrato": "1234567890ABC",
  "pagador": {
    "cpfCnpj": "11111111111",
    "ispb": "99999004",
    "nrConta": "12345678",
    "tpPessoa": 0,
    "codMunIbge": 3550308,
    "nrAgencia": "1234"
  },
  "recebedor": {
    "cnpj": "61695227000193",
    "ispb": "04358798",
    "nome": "Enel"
  },
  "retentativa": 1,
  "tpFrequencia": 4,
  "descContrato": "Conta de energia",
  "dtFinalRecorrencia": "2026-01-10",
  "idSolicitacaoRecorrencia": "IS0435879820240605abcd1234567",
  "pisoValorMaximo": 10.5,
  "valor": 550
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/pix-automatico/events/authorization-payer-registered"

	payload := strings.NewReader("{\n  \"dtHrCriacaoRecorrencia\": \"2024-06-05T14:25:49.025Z\",\n  \"dtHrCriacaoSolicitacao\": \"2024-06-05T14:25:49.025Z\",\n  \"dtHrExpiracaoSolicitacao\": \"2024-06-15T14:25:49.025Z\",\n  \"dtInicialRecorrencia\": \"2024-01-10\",\n  \"idRecorrencia\": \"RR0435879820240920njua7shf40o\",\n  \"idReqJdPi\": \"45F763C6-7487-4363-9406-A1DE2A9636D3\",\n  \"jornada\": 1,\n  \"nrContrato\": \"1234567890ABC\",\n  \"pagador\": {\n    \"cpfCnpj\": \"11111111111\",\n    \"ispb\": \"99999004\",\n    \"nrConta\": \"12345678\",\n    \"tpPessoa\": 0,\n    \"codMunIbge\": 3550308,\n    \"nrAgencia\": \"1234\"\n  },\n  \"recebedor\": {\n    \"cnpj\": \"61695227000193\",\n    \"ispb\": \"04358798\",\n    \"nome\": \"Enel\"\n  },\n  \"retentativa\": 1,\n  \"tpFrequencia\": 4,\n  \"descContrato\": \"Conta de energia\",\n  \"dtFinalRecorrencia\": \"2026-01-10\",\n  \"idSolicitacaoRecorrencia\": \"IS0435879820240605abcd1234567\",\n  \"pisoValorMaximo\": 10.5,\n  \"valor\": 550\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DataHoraEvento", "<x-datahoraevento>")
	req.Header.Add("X-NomeEvento", "<x-nomeevento>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-DataHoraEvento': '<x-datahoraevento>',
    'X-NomeEvento': '<x-nomeevento>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dtHrCriacaoRecorrencia: '2024-06-05T14:25:49.025Z',
    dtHrCriacaoSolicitacao: '2024-06-05T14:25:49.025Z',
    dtHrExpiracaoSolicitacao: '2024-06-15T14:25:49.025Z',
    dtInicialRecorrencia: '2024-01-10',
    idRecorrencia: 'RR0435879820240920njua7shf40o',
    idReqJdPi: '45F763C6-7487-4363-9406-A1DE2A9636D3',
    jornada: 1,
    nrContrato: '1234567890ABC',
    pagador: {
      cpfCnpj: '11111111111',
      ispb: '99999004',
      nrConta: '12345678',
      tpPessoa: 0,
      codMunIbge: 3550308,
      nrAgencia: '1234'
    },
    recebedor: {cnpj: '61695227000193', ispb: '04358798', nome: 'Enel'},
    retentativa: 1,
    tpFrequencia: 4,
    descContrato: 'Conta de energia',
    dtFinalRecorrencia: '2026-01-10',
    idSolicitacaoRecorrencia: 'IS0435879820240605abcd1234567',
    pisoValorMaximo: 10.5,
    valor: 550
  })
};

fetch('https://api.example.com/v1/pix-automatico/events/authorization-payer-registered', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/pix-automatico/events/authorization-payer-registered"

payload = {
    "dtHrCriacaoRecorrencia": "2024-06-05T14:25:49.025Z",
    "dtHrCriacaoSolicitacao": "2024-06-05T14:25:49.025Z",
    "dtHrExpiracaoSolicitacao": "2024-06-15T14:25:49.025Z",
    "dtInicialRecorrencia": "2024-01-10",
    "idRecorrencia": "RR0435879820240920njua7shf40o",
    "idReqJdPi": "45F763C6-7487-4363-9406-A1DE2A9636D3",
    "jornada": 1,
    "nrContrato": "1234567890ABC",
    "pagador": {
        "cpfCnpj": "11111111111",
        "ispb": "99999004",
        "nrConta": "12345678",
        "tpPessoa": 0,
        "codMunIbge": 3550308,
        "nrAgencia": "1234"
    },
    "recebedor": {
        "cnpj": "61695227000193",
        "ispb": "04358798",
        "nome": "Enel"
    },
    "retentativa": 1,
    "tpFrequencia": 4,
    "descContrato": "Conta de energia",
    "dtFinalRecorrencia": "2026-01-10",
    "idSolicitacaoRecorrencia": "IS0435879820240605abcd1234567",
    "pisoValorMaximo": 10.5,
    "valor": 550
}
headers = {
    "X-DataHoraEvento": "<x-datahoraevento>",
    "X-NomeEvento": "<x-nomeevento>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

POST

pix-automatico

events

authorization-payer-registered

Receive a PIX Automatico payer-side authorization registration event

curl --request POST \
  --url https://api.example.com/v1/pix-automatico/events/authorization-payer-registered \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DataHoraEvento: <x-datahoraevento>' \
  --header 'X-NomeEvento: <x-nomeevento>' \
  --data '
{
  "dtHrCriacaoRecorrencia": "2024-06-05T14:25:49.025Z",
  "dtHrCriacaoSolicitacao": "2024-06-05T14:25:49.025Z",
  "dtHrExpiracaoSolicitacao": "2024-06-15T14:25:49.025Z",
  "dtInicialRecorrencia": "2024-01-10",
  "idRecorrencia": "RR0435879820240920njua7shf40o",
  "idReqJdPi": "45F763C6-7487-4363-9406-A1DE2A9636D3",
  "jornada": 1,
  "nrContrato": "1234567890ABC",
  "pagador": {
    "cpfCnpj": "11111111111",
    "ispb": "99999004",
    "nrConta": "12345678",
    "tpPessoa": 0,
    "codMunIbge": 3550308,
    "nrAgencia": "1234"
  },
  "recebedor": {
    "cnpj": "61695227000193",
    "ispb": "04358798",
    "nome": "Enel"
  },
  "retentativa": 1,
  "tpFrequencia": 4,
  "descContrato": "Conta de energia",
  "dtFinalRecorrencia": "2026-01-10",
  "idSolicitacaoRecorrencia": "IS0435879820240605abcd1234567",
  "pisoValorMaximo": 10.5,
  "valor": 550
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/pix-automatico/events/authorization-payer-registered"

	payload := strings.NewReader("{\n  \"dtHrCriacaoRecorrencia\": \"2024-06-05T14:25:49.025Z\",\n  \"dtHrCriacaoSolicitacao\": \"2024-06-05T14:25:49.025Z\",\n  \"dtHrExpiracaoSolicitacao\": \"2024-06-15T14:25:49.025Z\",\n  \"dtInicialRecorrencia\": \"2024-01-10\",\n  \"idRecorrencia\": \"RR0435879820240920njua7shf40o\",\n  \"idReqJdPi\": \"45F763C6-7487-4363-9406-A1DE2A9636D3\",\n  \"jornada\": 1,\n  \"nrContrato\": \"1234567890ABC\",\n  \"pagador\": {\n    \"cpfCnpj\": \"11111111111\",\n    \"ispb\": \"99999004\",\n    \"nrConta\": \"12345678\",\n    \"tpPessoa\": 0,\n    \"codMunIbge\": 3550308,\n    \"nrAgencia\": \"1234\"\n  },\n  \"recebedor\": {\n    \"cnpj\": \"61695227000193\",\n    \"ispb\": \"04358798\",\n    \"nome\": \"Enel\"\n  },\n  \"retentativa\": 1,\n  \"tpFrequencia\": 4,\n  \"descContrato\": \"Conta de energia\",\n  \"dtFinalRecorrencia\": \"2026-01-10\",\n  \"idSolicitacaoRecorrencia\": \"IS0435879820240605abcd1234567\",\n  \"pisoValorMaximo\": 10.5,\n  \"valor\": 550\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DataHoraEvento", "<x-datahoraevento>")
	req.Header.Add("X-NomeEvento", "<x-nomeevento>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-DataHoraEvento': '<x-datahoraevento>',
    'X-NomeEvento': '<x-nomeevento>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dtHrCriacaoRecorrencia: '2024-06-05T14:25:49.025Z',
    dtHrCriacaoSolicitacao: '2024-06-05T14:25:49.025Z',
    dtHrExpiracaoSolicitacao: '2024-06-15T14:25:49.025Z',
    dtInicialRecorrencia: '2024-01-10',
    idRecorrencia: 'RR0435879820240920njua7shf40o',
    idReqJdPi: '45F763C6-7487-4363-9406-A1DE2A9636D3',
    jornada: 1,
    nrContrato: '1234567890ABC',
    pagador: {
      cpfCnpj: '11111111111',
      ispb: '99999004',
      nrConta: '12345678',
      tpPessoa: 0,
      codMunIbge: 3550308,
      nrAgencia: '1234'
    },
    recebedor: {cnpj: '61695227000193', ispb: '04358798', nome: 'Enel'},
    retentativa: 1,
    tpFrequencia: 4,
    descContrato: 'Conta de energia',
    dtFinalRecorrencia: '2026-01-10',
    idSolicitacaoRecorrencia: 'IS0435879820240605abcd1234567',
    pisoValorMaximo: 10.5,
    valor: 550
  })
};

fetch('https://api.example.com/v1/pix-automatico/events/authorization-payer-registered', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/pix-automatico/events/authorization-payer-registered"

payload = {
    "dtHrCriacaoRecorrencia": "2024-06-05T14:25:49.025Z",
    "dtHrCriacaoSolicitacao": "2024-06-05T14:25:49.025Z",
    "dtHrExpiracaoSolicitacao": "2024-06-15T14:25:49.025Z",
    "dtInicialRecorrencia": "2024-01-10",
    "idRecorrencia": "RR0435879820240920njua7shf40o",
    "idReqJdPi": "45F763C6-7487-4363-9406-A1DE2A9636D3",
    "jornada": 1,
    "nrContrato": "1234567890ABC",
    "pagador": {
        "cpfCnpj": "11111111111",
        "ispb": "99999004",
        "nrConta": "12345678",
        "tpPessoa": 0,
        "codMunIbge": 3550308,
        "nrAgencia": "1234"
    },
    "recebedor": {
        "cnpj": "61695227000193",
        "ispb": "04358798",
        "nome": "Enel"
    },
    "retentativa": 1,
    "tpFrequencia": 4,
    "descContrato": "Conta de energia",
    "dtFinalRecorrencia": "2026-01-10",
    "idSolicitacaoRecorrencia": "IS0435879820240605abcd1234567",
    "pisoValorMaximo": 10.5,
    "valor": 550
}
headers = {
    "X-DataHoraEvento": "<x-datahoraevento>",
    "X-NomeEvento": "<x-nomeevento>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Headers

Authorization

string

Bearer access token (the financial-ingress gate; the handler fails closed with PIX-0082 when absent).

Example:

"Bearer eyJ..."

X-DataHoraEvento

string

required

Event registration instant (UTC: aaaa-mm-ddTHH:mm:ss.sssZ). Mandatory per §6.1.

Example:

"2024-06-05T10:10:05.025Z"

X-NomeEvento

string

required

Event name (see §6.3.1 catalog). Mandatory per §6.1; informational passthrough.

Example:

"situacao-autorizacao-callback"

Body

application/json

dtHrCriacaoRecorrencia

string

required

Recurrence creation timestamp (UTC).

Example:

"2024-06-05T14:25:49.025Z"

dtHrCriacaoSolicitacao

string

required

Solicitation creation timestamp (UTC).

Example:

"2024-06-05T14:25:49.025Z"

dtHrExpiracaoSolicitacao

string

required

Solicitation expiration timestamp (UTC).

Example:

"2024-06-15T14:25:49.025Z"

dtInicialRecorrencia

string

required

First payment date (aaaa-mm-dd).

Example:

"2024-01-10"

idRecorrencia

string

required

Unique recurrence id (29-char, RR...).

Example:

"RR0435879820240920njua7shf40o"

idReqJdPi

string

required

JDPI request id (36-char GUID).

Example:

"45F763C6-7487-4363-9406-A1DE2A9636D3"

jornada

integer<int64>

required

Authorization journey (1 only on the PSP Pagador genesis).

Example:

1

nrContrato

string

required

Contract/order identifier (35-char).

Example:

"1234567890ABC"

pagador

object

required

The recurrence pagador.

Show child attributes

recebedor

object

required

The recurrence recebedor.

Show child attributes

retentativa

integer<int64>

required

Retry policy (0=none, 1=up to 3 in 7 days).

Example:

1

tpFrequencia

integer<int64>

required

Recurrence periodicity (0..4).

Example:

4

descContrato

string

Free-text contract description (35-char).

Example:

"Conta de energia"

devedor

object

The devedor, sent only when it differs from the payer.

Show child attributes

dtFinalRecorrencia

string

Last payment date (aaaa-mm-dd).

Example:

"2026-01-10"

idSolicitacaoRecorrencia

string

Confirmation-solicitation id (29-char, IS...).

Example:

"IS0435879820240605abcd1234567"

pisoValorMaximo

number<double>

Receiver floor in reais (a JSON number).

Example:

10.5

valor

number<double>

Fixed payment amount in reais (a JSON number).

Example:

550

Response

No Content

Key DICT API

Key Claims API

Banks API

Indirect participants API

Transactions API

Transaction Limits API

QR Codes API

Refunds API

Pix Automático · Authorization requests

Pix Automático · Authorization management

Pix Automático · Composite QR codes

Pix Automático · Authorization events

Pix Automático · Schedule events

Pix Automático · Schedules and payment instructions

Pix Automático · Settlement

MED · Refunds

MED · Fraud markers

MED · Infractions

MED · Value recovery

Webhooks API

Error handling

Events

Receive a PIX Automatico payer-side authorization registration event

Authorizations

Headers

Body

Response