Pular para o conteúdo
xFlow Payments

Glossário

O que é SPI

SPI é o Sistema de Pagamentos Instantâneos, a infraestrutura centralizada do Banco Central que liquida os Pix entre instituições diferentes. Cada transação é liquidada individualmente nas Contas PI dos participantes diretos, e a liquidação não pode ser desfeita.

Atualizado em · Equipe xFlow Payments

Quando pagador e recebedor têm conta na mesma instituição, o Pix é liquidado nos sistemas dela. Quando as contas estão em instituições diferentes, o dinheiro precisa passar de uma para a outra. Esse é o papel do SPI.

Como o SPI funciona

Os pontos abaixo vêm da página do SPI no site do Banco Central e do Regulamento do SPI, aprovado pela Resolução BCB nº 195, de 03/03/2022, em vigor desde 01/04/2022:

Ponto Como é
Quem opera O Banco Central. A operação começou em novembro de 2020.
Como liquida Liquidação bruta: cada transação é processada e liquidada uma a uma.
Onde fica o dinheiro Nas Contas PI, que os participantes diretos mantêm no Banco Central. Não se admite saldo negativo.
Quem participa Participantes diretos, com Conta PI e conexão própria, e indiretos, que liquidam por meio de um participante direto.
Depois de liquidado A liquidação é irrevogável e incondicional (art. 40). O momento fica registrado em UTC.

Cada instituição aparece no sistema pelo seu ISPB.

O que isso muda para quem integra

Irrevogável quer dizer que um Pix liquidado não é cancelado. Para devolver o dinheiro existe outra ordem: o regulamento define a devolução de pagamento instantâneo como uma ordem de crédito usada exclusivamente para devolver um Pix liquidado antes (art. 2º, V). Por isso um estorno é sempre um movimento novo, com resultado próprio, e pode ser recusado.

Na API da xFlow

A documentação da xFlow descreve o pix.endToEnd como o identificador único da liquidação no SPI. Ele vem na cobrança paga e no webhook transaction.paid. Veja o End-to-end ID.

O estorno, pedido em POST /api/v1/charges/{id}/refund, é assíncrono. A resposta 202 com status: "pending" quer dizer que o PSP aceitou o pedido. O desfecho chega pelos webhooks transaction.refunded ou transaction.refund_failed. Se o pagador está na mesma instituição, a devolução pode concluir na hora, e a resposta já vem 200 com status: "completed".

Exemplo

json
{
  "event": "transaction.refunded",
  "data": { "id": "clx...", "status": "refunded", "external_reference": "pedido-1234" }
}

O código completo para pedir e acompanhar a devolução está em estorno Pix por API.

Termos relacionados

  • ISPB: o código de cada instituição no SPI.
  • End-to-end ID: o identificador da liquidação.
  • PSP: as instituições que trocam as ordens pelo SPI.

Conteúdo informativo, atualizado em 25/10/2026. Não substitui orientação jurídica.

Continue lendo