Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Campo

O que foi alterado?

Tipo da Alteração

Antes

Depois

N° Proposta

Data homologação

/info

Alterado - "description"

Alteração

API de Iniciação de Pagamentos, responsável por viabilizar as operações de iniciação de pagamentos para o Open Finance Brasil. Par...

API de Iniciação de Pagamentos, responsável por viabilizar as operações de iniciação de pagamentos para o Open Finance Brasil. Par...

/info

Alterado - "version"

Alteração

3.0.0

4.0.0

/servers/0

Alterado - "url"

Alteração

https://api.banco.com.br/open-banking/payments/v3

https://api.banco.com.br/open-banking/payments/v4

/servers/1

Alterado - "url"

Alteração

https://apih.banco.com.br/open-banking/payments/v3

https://apih.banco.com.br/open-banking/payments/v4

paths

Adicionado - "/pix/payments/consents/{consentId}"

Adição

/info

Alterado - "description"

Alteração

Para o caso de Pix imediato, todas as aprovações necessárias devem ser realizadas nos canais da detentora até às 23:59 (horário de Brasília) da data de solicitação do pagamento. Já para o caso de Pix agendado, todas as aprovações devem ser realizadas até a data/hora limite suportada pela detentora

Para o caso de pagamento imediato, todas as aprovações necessárias devem ser realizadas nos canais da detentora até às 23:59 (horário de Brasília) da data de solicitação do pagamento. Já para o caso de pagamento agendado, todas as aprovações devem ser realizadas até o exato dia anterior à data/hora prevista para primeira liquidação, respeitando a data/hora limite suportada pela detentora. Caso não seja possível aprovação, o consentimento deve ser rejeitado pelo detentor.

PSV196

POST /consents

Request

Campo

O que foi alterado?

Tipo da Alteração

Antes

Depois

N° Proposta

Data homologação

post/parameters/Authorization

Adicionado - "minLength"

Adição

1

post/parameters/x-fapi-interaction-id

Alterado - "description"

Alteração

Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. A detentora deve obrigatoriamente retornar o campo com o mesmo valor recebido da iniciadora.

Um UUID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação entre request e response. Campo de geração e envio obrigatório pela iniciadora (client) e o seu valor deve ser “espelhado” pela detentora (server) no cabeçalho de resposta. Caso não seja recebido ou se for recebido um valor inválido, a detentora deve gerar um x-fapi-interaction-id e retorná-lo na resposta com o HTTP status code 400. A iniciadora deve acatar o valor recebido da detentora.

post/parameters/x-fapi-interaction-id

Alterado - "pattern"

Alteração

^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$

^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

post/parameters/x-fapi-interaction-id

Alterado - "maxLength"

Alteração

100

36

post/parameters/x-fapi-interaction-id

Adicionado - "format"

Adição

uuid

post/parameters/x-fapi-interaction-id

Adicionado - "example"

Adição

d78fc4e5-37ca-4da3-adf2-9b082bf92280

post/parameters/x-idempotency-key

Adicionado - "minLength"

Adição

1

post/requestBody/data

Alterado - "description"

Alteração

Objeto contendo as informações de consentimento para a iniciação de pagamento individual.

Objeto contendo as informações de consentimento para a iniciação de pagamento.

post/requestBody/data/payment/details/localInstrument

Alterado - "description"

Alteração

Especifica a forma de iniciação do pagamento:

  • MANU - Inserção manual de dados da conta transacional

  • DICT - Inserção manual de chave Pix

  • QRDN - QR code dinâmico

  • QRES - QR code estático

  • INIC - Indica que o recebedor (creditor) contratou o Iniciador de Pagamentos especificamente para realizar iniciações de pagamento em que o beneficiário é previamente conhecido.

Especifica a forma de iniciação do pagamento:

  • MANU - Inserção manual de dados da conta transacional

  • DICT - Inserção manual de chave Pix

  • QRDN - QR code dinâmico

  • QRES - QR code estático

  • INIC - Indica que o recebedor (creditor) contratou o Iniciador de Pagamentos especificamente para realizar iniciações de pagamento em que o beneficiário é previamente conhecido.

[Restrição] Se /data/payment/schedule enviado com valor diferente de single durante a criação do consentimento, apenas os métodos MANU, DICT ou QRES são permitidos.

post/requestBody/data/payment/schedule

Adicionado - "description"

Adição

[Restrição] Mutuamente excludente com o campo date.
Este campo é obrigatório no caso de agendamento.
Neste caso, o campo date não deverá ser informado.
O prazo máximo para o consentimento deverá ser de dois anos, contando a partir da data de criação do consentimento retornada na criação do mesmo (campo /data/creationDateTime).
Agendamento de pagamento único deve utilizar exclusivamente o objeto "single".

post/requestBody/data/payment/schedule/oneOf

Alterado - "length"

Alteração

1

5

post/requestBody/data/payment/schedule/oneOf

Adicionado - "1"

Adição

post/requestBody/data/payment/schedule/oneOf

Adicionado - "2"

Adição

post/requestBody/data/payment/schedule/oneOf

Adicionado - "3"

Adição

post/requestBody/data/payment/schedule/oneOf

Adicionado - "4"

Adição

post/requestBody/data/payment/schedule/oneOf/0

Removido - "description"

Remoção

[Restrição] Mutuamente excludente com o campo date.

Este campo é obrigatório no caso de agendamento.

Neste caso, o campo date não deve ser informado.

post/requestBody/data/payment/schedule/oneOf/0/single/date

Alterado - "example"

Alteração

01/01/2021

23/08/2023

post/requestBody/data/payment/schedule/oneOf/0/single/date

Alterado - "description"

Alteração

Define a data alvo da liquidação do pagamento.

O fuso horário de Brasília deve ser utilizado para criação e racionalização sobre os dados deste campo.

Observação: Esse campo deverá sempre ser no mínimo D+1 corrido, ou seja, a data imediatamente posterior em relação a data do consentimento considerando o fuso horário de Brasília e deverá ser no máximo D+365 corridos a partir da data do consentimento considerando o fuso horário de Brasília

Define a data alvo da liquidação do pagamento.
O fuso horário de Brasília deve ser utilizado para criação e racionalização sobre os dados deste campo.

[Restrição] Esse campo deverá sempre ser no mínimo D+1 corrido, ou seja, a data imediatamente posterior em
relação a data do consentimento considerando o fuso horário de Brasília e deverá ser no máximo D+730 corridos a
partir da data do consentimento, também considerando o fuso horário de Brasília.

/data/payment/schedule/daily /startDate

Adicionado - “description”

Adição

Define o início da vigência da recorrência.

PSV187

/data/payment/schedule/Weekly/startDate

Adicionado - “description”

Adição

Define o início da vigência da recorrência.

PSV187

/data/payment/schedule/monthly/startDate

Adicionado - “description”

Adição

Define o início da vigência da recorrência.

PSV187

/data/payment/schedule/weekly/dayOfWeek

Adicionado - “description”

Adição

Define o dia da semana planejado para a ocorrência das liquidações.

PSV187

/data/payment/schedule/monthly/dayOfMonth

Adicionado - “description”

Adição

Define o dia do mês planejado para a ocorrência das liquidações.

PSV187

/data/payment/schedule/monthly/quantity

Adicionado - “description”

Adição

Define a quantidade de pagamentos que serão enviados para liquidação.

PSV187

/data/payment/schedule/custom/dates

Adicionado - “description”

Adição

Define os dias em que estão planejadas as ocorrências das liquidações.

PSV187

/data/payment/schedule/daily/quantity

Alterado - maximum

Alteração

730

60

PSV191

/data/payment/schedule/weekly/quantity

Alterado - maximum

Alteração

104

60

PSV191

/data/payment/schedule/custom/dates

Alterado - MaxItens

Alteração

730

60

PSV191

...