Utilização

Pix QRCode

Nos pagamentos iniciados por QR Code, o processo ocorre em duas fases:

Fase 1: O usuário pagador lê o QR Code de cobrança ou fornece o código copia e cola. A instituição pagadora decodifica essas informações para obter os dados da conta do beneficiário.
Fase 2: Com a confirmação do usuário pagador, a instituição pagadora usa os dados decodificados para criar o pagamento no SPI.

Os QRCodes gerados têm uma duração fixa de 84.000 segundos e são dinâmicos, permitindo que qualquer usuário faça o pagamento.

Etapas do fluxo de CashOut Pix - Decodificação de QR Code.

Etapas do fluxo de CashOut Pix - Confirmação de pagamentoe.

Dados da requisição:

Parametro	valor	Descrição
value‎ *	1000	O valor da transação deve ser inserido em centavos.
pix_key	+5543999999999	A chave pix padrão já é carregada automaticamente no envio da requisição, portanto, não é necessário inserira-la manualmente.
banking_external_id‎*	12n3c4t56	ID da transação dentro do sistema integrado. Deve ser um id aleatório não utilizado anteriormente.

📌

Para a criação de QR Code é necessário possuir ao menos uma chave pix cadastrada na Bankspace.

Ainda não possui uma chave pix padrão?

Bankspace

Estando autenticado no sistema da Bankspace navegue até a área Pix.

Tela inicial da Bankspace

Nova chave pix

Clique no botão para cadastrar uma nova chave pix

Dados da chave

Para cadastrar a chave como padrão só o que precisa fazer é selecionar o campo indicado na imagem, preencher as demais informações e clicar no botão de confirmarmação.

Chave criada

Após estes passos a chave terá sido criada, podendo ser utilizada como padrão nos testes deste endpoint.

INFORMAÇÃO

Caso já possua uma chave padrão, ao criar uma nova também definida como padrão, esta substituirá a anterior.

Fluxo para criar novo QR Code

📌

Certifique-se de incluir o token de autenticação válido ao realizar as requisições. Para orientações sobre como obter o token e como utiliza-lo, consulte o arquivo de autenticação.

Acesse a rota 'Criar novo QRCode'

Você pode acessá-la clicando aqui.

Autenticação

Você precisará de um token para a autenticação. Saiba como aqui.

Preenchendo dados

Após inserir o token retorne a aba 'Body'e preencha os campos com os dados da requisição que deseja realizar e envie.

💡

Lembre-se de substituir os dados de exemplo. Os campos que devem ser inseridos manualmente estão destacados na imagem.

Você receberá alguma das resposta citadas abaixo.

Padrões de resposta

A resposta esperada ao enviar a requisição é um status de sucesso (200).

Na área destacada em vermelho, você pode visualizar uma prévia da resposta esperada da requisição.

Na área destacada em verde, você verá a resposta que será recebida após clicar no botão de enviar.

✔️ Sucesso (200)

Não autorizado (401)

Erro interno do servidor

Pix QRCode#

Dados da requisição:#

Ainda não possui uma chave pix padrão?#

#

Fluxo para criar novo QR Code#

Padrões de resposta#

Pix QRCode

Dados da requisição:

Ainda não possui uma chave pix padrão?

Fluxo para criar novo QR Code

Padrões de resposta