Confirm a PIX Automatico authorization

curl --request POST \
  --url https://api.example.com/v1/pix-automatico/authorizations/{idRecorrencia}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "authorizedAt": "2024-01-06T10:00:00.000Z",
  "contractNumber": "1234567890ABC",
  "createdDateTime": "2024-01-05T10:00:00.000Z",
  "frequency": 1,
  "journey": 2,
  "payer": {
    "account": "0007654321",
    "accountType": 0,
    "cpfCnpj": "04623217035",
    "ibgeCode": 3550308,
    "ispb": "00038166",
    "name": "Fulano de Tal",
    "personType": 0,
    "agency": "0001"
  },
  "recipient": {
    "cnpj": "61695227000193",
    "ispb": "04358798",
    "name": "Enel"
  },
  "startDate": "2024-01-10",
  "amount": 110001,
  "contractDesc": "Conta de energia",
  "endDate": "2026-01-10",
  "floorMaxAmount": 55000,
  "payerMaxAmount": 200000,
  "settlementConfirmedAt": "2024-01-06T10:05:00.000Z"
}
'

package main

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

func main() {

	url := "https://api.example.com/v1/pix-automatico/authorizations/{idRecorrencia}/confirm"

	payload := strings.NewReader("{\n  \"authorizedAt\": \"2024-01-06T10:00:00.000Z\",\n  \"contractNumber\": \"1234567890ABC\",\n  \"createdDateTime\": \"2024-01-05T10:00:00.000Z\",\n  \"frequency\": 1,\n  \"journey\": 2,\n  \"payer\": {\n    \"account\": \"0007654321\",\n    \"accountType\": 0,\n    \"cpfCnpj\": \"04623217035\",\n    \"ibgeCode\": 3550308,\n    \"ispb\": \"00038166\",\n    \"name\": \"Fulano de Tal\",\n    \"personType\": 0,\n    \"agency\": \"0001\"\n  },\n  \"recipient\": {\n    \"cnpj\": \"61695227000193\",\n    \"ispb\": \"04358798\",\n    \"name\": \"Enel\"\n  },\n  \"startDate\": \"2024-01-10\",\n  \"amount\": 110001,\n  \"contractDesc\": \"Conta de energia\",\n  \"endDate\": \"2026-01-10\",\n  \"floorMaxAmount\": 55000,\n  \"payerMaxAmount\": 200000,\n  \"settlementConfirmedAt\": \"2024-01-06T10:05:00.000Z\"\n}")

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

	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: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    authorizedAt: '2024-01-06T10:00:00.000Z',
    contractNumber: '1234567890ABC',
    createdDateTime: '2024-01-05T10:00:00.000Z',
    frequency: 1,
    journey: 2,
    payer: {
      account: '0007654321',
      accountType: 0,
      cpfCnpj: '04623217035',
      ibgeCode: 3550308,
      ispb: '00038166',
      name: 'Fulano de Tal',
      personType: 0,
      agency: '0001'
    },
    recipient: {cnpj: '61695227000193', ispb: '04358798', name: 'Enel'},
    startDate: '2024-01-10',
    amount: 110001,
    contractDesc: 'Conta de energia',
    endDate: '2026-01-10',
    floorMaxAmount: 55000,
    payerMaxAmount: 200000,
    settlementConfirmedAt: '2024-01-06T10:05:00.000Z'
  })
};

fetch('https://api.example.com/v1/pix-automatico/authorizations/{idRecorrencia}/confirm', 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/authorizations/{idRecorrencia}/confirm"

payload = {
    "authorizedAt": "2024-01-06T10:00:00.000Z",
    "contractNumber": "1234567890ABC",
    "createdDateTime": "2024-01-05T10:00:00.000Z",
    "frequency": 1,
    "journey": 2,
    "payer": {
        "account": "0007654321",
        "accountType": 0,
        "cpfCnpj": "04623217035",
        "ibgeCode": 3550308,
        "ispb": "00038166",
        "name": "Fulano de Tal",
        "personType": 0,
        "agency": "0001"
    },
    "recipient": {
        "cnpj": "61695227000193",
        "ispb": "04358798",
        "name": "Enel"
    },
    "startDate": "2024-01-10",
    "amount": 110001,
    "contractDesc": "Conta de energia",
    "endDate": "2026-01-10",
    "floorMaxAmount": 55000,
    "payerMaxAmount": 200000,
    "settlementConfirmedAt": "2024-01-06T10:05:00.000Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "idRecorrencia": "RR0435879820240605njua7shf40o",
  "recurrenceId": "RR0435879820240605njua7shf40o",
  "requestedAt": "2024-01-06T10:00:01Z",
  "idReqJdPi": "52c43361-caa1-4ddb-9152-708426a25db3",
  "status": "Accepted"
}

{
  "code": "<string>",
  "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": "<string>",
  "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": "<string>",
  "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"
  }
}

Confirm a PIX Automatico authorization

Confirms, as the PSP Pagador, a recurring-payment authorization read from a QR (JDPI 4.3.3, journeys 2-4). An existing payer-side authorization moves to Active; with none, the confirmation creates it, Active, once the payer agency/account is proved to belong to the payer document and to be bound to a ledger account; contractNumber, payer.cpfCnpj and payer.account are required on every confirmation. createdDateTime and authorizedAt are required on every confirmation, so a retry sends JD the same body.

POST

pix-automatico

authorizations

{idRecorrencia}

confirm

Confirm a PIX Automatico authorization

curl --request POST \
  --url https://api.example.com/v1/pix-automatico/authorizations/{idRecorrencia}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "authorizedAt": "2024-01-06T10:00:00.000Z",
  "contractNumber": "1234567890ABC",
  "createdDateTime": "2024-01-05T10:00:00.000Z",
  "frequency": 1,
  "journey": 2,
  "payer": {
    "account": "0007654321",
    "accountType": 0,
    "cpfCnpj": "04623217035",
    "ibgeCode": 3550308,
    "ispb": "00038166",
    "name": "Fulano de Tal",
    "personType": 0,
    "agency": "0001"
  },
  "recipient": {
    "cnpj": "61695227000193",
    "ispb": "04358798",
    "name": "Enel"
  },
  "startDate": "2024-01-10",
  "amount": 110001,
  "contractDesc": "Conta de energia",
  "endDate": "2026-01-10",
  "floorMaxAmount": 55000,
  "payerMaxAmount": 200000,
  "settlementConfirmedAt": "2024-01-06T10:05:00.000Z"
}
'

package main

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

func main() {

	url := "https://api.example.com/v1/pix-automatico/authorizations/{idRecorrencia}/confirm"

	payload := strings.NewReader("{\n  \"authorizedAt\": \"2024-01-06T10:00:00.000Z\",\n  \"contractNumber\": \"1234567890ABC\",\n  \"createdDateTime\": \"2024-01-05T10:00:00.000Z\",\n  \"frequency\": 1,\n  \"journey\": 2,\n  \"payer\": {\n    \"account\": \"0007654321\",\n    \"accountType\": 0,\n    \"cpfCnpj\": \"04623217035\",\n    \"ibgeCode\": 3550308,\n    \"ispb\": \"00038166\",\n    \"name\": \"Fulano de Tal\",\n    \"personType\": 0,\n    \"agency\": \"0001\"\n  },\n  \"recipient\": {\n    \"cnpj\": \"61695227000193\",\n    \"ispb\": \"04358798\",\n    \"name\": \"Enel\"\n  },\n  \"startDate\": \"2024-01-10\",\n  \"amount\": 110001,\n  \"contractDesc\": \"Conta de energia\",\n  \"endDate\": \"2026-01-10\",\n  \"floorMaxAmount\": 55000,\n  \"payerMaxAmount\": 200000,\n  \"settlementConfirmedAt\": \"2024-01-06T10:05:00.000Z\"\n}")

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

	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: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    authorizedAt: '2024-01-06T10:00:00.000Z',
    contractNumber: '1234567890ABC',
    createdDateTime: '2024-01-05T10:00:00.000Z',
    frequency: 1,
    journey: 2,
    payer: {
      account: '0007654321',
      accountType: 0,
      cpfCnpj: '04623217035',
      ibgeCode: 3550308,
      ispb: '00038166',
      name: 'Fulano de Tal',
      personType: 0,
      agency: '0001'
    },
    recipient: {cnpj: '61695227000193', ispb: '04358798', name: 'Enel'},
    startDate: '2024-01-10',
    amount: 110001,
    contractDesc: 'Conta de energia',
    endDate: '2026-01-10',
    floorMaxAmount: 55000,
    payerMaxAmount: 200000,
    settlementConfirmedAt: '2024-01-06T10:05:00.000Z'
  })
};

fetch('https://api.example.com/v1/pix-automatico/authorizations/{idRecorrencia}/confirm', 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/authorizations/{idRecorrencia}/confirm"

payload = {
    "authorizedAt": "2024-01-06T10:00:00.000Z",
    "contractNumber": "1234567890ABC",
    "createdDateTime": "2024-01-05T10:00:00.000Z",
    "frequency": 1,
    "journey": 2,
    "payer": {
        "account": "0007654321",
        "accountType": 0,
        "cpfCnpj": "04623217035",
        "ibgeCode": 3550308,
        "ispb": "00038166",
        "name": "Fulano de Tal",
        "personType": 0,
        "agency": "0001"
    },
    "recipient": {
        "cnpj": "61695227000193",
        "ispb": "04358798",
        "name": "Enel"
    },
    "startDate": "2024-01-10",
    "amount": 110001,
    "contractDesc": "Conta de energia",
    "endDate": "2026-01-10",
    "floorMaxAmount": 55000,
    "payerMaxAmount": 200000,
    "settlementConfirmedAt": "2024-01-06T10:05:00.000Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "idRecorrencia": "RR0435879820240605njua7shf40o",
  "recurrenceId": "RR0435879820240605njua7shf40o",
  "requestedAt": "2024-01-06T10:00:01Z",
  "idReqJdPi": "52c43361-caa1-4ddb-9152-708426a25db3",
  "status": "Accepted"
}

{
  "code": "<string>",
  "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": "<string>",
  "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": "<string>",
  "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.

Path Parameters

idRecorrencia

string

required

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

Example:

"RR0435879820240605njua7shf40o"

Body

application/json

authorizedAt

string<date-time>

required

Authorization timestamp (dtHrAutorizacaoRecorrencia, an RFC 3339 date-time). No row stores it, so a retry must resend the same value for JD to replay the confirmation.

Pattern: \S

Example:

"2024-01-06T10:00:00.000Z"

contractNumber

string

required

Contract/order identifier (nrContrato). Blank is 400 PIX-0061.

Example:

"1234567890ABC"

createdDateTime

string<date-time>

required

Recurrence creation timestamp (dtHrCriacaoRecorrencia, an RFC 3339 date-time). No row stores it, so a retry must resend the same value for JD to replay the confirmation.

Pattern: \S

Example:

"2024-01-05T10:00:00.000Z"

frequency

integer<int64>

required

tpFrequencia (0..4).

Example:

1

journey

integer<int64>

required

jornada (2..4).

Example:

2

payer

object

required

The recurrence pagador (incl. name, accountType, ibgeCode).

Show child attributes

recipient

object

required

The recurrence recebedor.

Show child attributes

startDate

string

required

First payment date (dtInicialRecorrencia; aaaa-mm-dd).

Example:

"2024-01-10"

amount

integer<int64>

Fixed payment amount in centavos (valor).

Example:

110001

contractDesc

string

Free-text contract description.

Example:

"Conta de energia"

debtor

object

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

Show child attributes

endDate

string

Last payment date (dtFinalRecorrencia).

Example:

"2026-01-10"

floorMaxAmount

integer<int64>

Receiver floor in centavos (pisoValorMaximo).

Example:

55000

payerMaxAmount

integer<int64>

Payer max cap in centavos (vlrMaxPagador).

Example:

200000

settlementConfirmedAt

string

Settlement confirmation timestamp (dtHrConfirmacaoLiquidacao, an RFC 3339 date-time). Required when journey=3 and not allowed otherwise; either violation is 400 PIX-0061.

Example:

"2024-01-06T10:05:00.000Z"

Response

Accepted

idRecorrencia

string

required

deprecated

Deprecated: read recurrenceId, which carries the same value. The recurrence id.

Example:

"RR0435879820240605njua7shf40o"

recurrenceId

string

required

The recurrence id.

Example:

"RR0435879820240605njua7shf40o"

requestedAt

string

required

JDPI request timestamp (dtHrReqJdPi, UTC).

Example:

"2024-01-06T10:00:01Z"

idReqJdPi

string

The JDPI request id (36-char GUID; omitted by 4.3.10).

Example:

"52c43361-caa1-4ddb-9152-708426a25db3"

status

string

The resulting local authorization status.

Example:

"Accepted"

Direct participant APIs

Indirect participant APIs

Confirm a PIX Automatico authorization

Authorizations

Path Parameters

Body

Response