Pular para o conteúdo
xFlow Payments
EntrarCriar conta

Glossário

O que é PSP

PSP é a sigla de Prestador de Serviços de Pagamento: no Pix, a instituição participante em que o pagador ou o recebedor tem a conta transacional. Em todo Pix há o PSP do pagador e o PSP do recebedor, que podem ser a mesma instituição.

Atualizado em · Equipe xFlow Payments · 2 min de leitura

Quando alguém paga um Pix, o dinheiro sai de uma conta em uma instituição e entra em uma conta em outra, ou na mesma. Cada uma dessas instituições é um PSP. O termo aparece o tempo todo na documentação do Pix e nas respostas de qualquer API de pagamento.

PSP do pagador e PSP do recebedor

O Manual de Padrões para Iniciação do Pix do Banco Central (versão 2.10.0, de 19/08/2026) define os dois papéis:

Papel Definição do manual O que faz no fluxo
PSP pagador Participante do Pix no qual o usuário pagador possui uma conta transacional. Lê o QR Code ou a chave, consulta o DICT quando o pagador usa uma chave e envia a ordem de pagamento.
PSP recebedor Participante do Pix no qual o usuário recebedor possui a conta usada para receber. Apresenta o QR Code, recebe o txid na liquidação e avisa o recebedor.

Quando os dois estão em instituições diferentes, as mensagens passam pelo SPI, o Sistema de Pagamentos Instantâneos. O manual também diz que o PSP recebedor que oferece integração automatizada aos clientes deve fazê-lo pela API Pix, seguindo as especificações do Banco Central.

Onde o PSP aparece na API da xFlow

A documentação da xFlow cita o PSP em pontos que afetam o seu código:

  • Dados do pagador. O objeto payer (nome, CPF ou CNPJ e banco de quem de fato pagou) e o pix.endToEnd são informados pelo PSP na confirmação. Enquanto a cobrança está pendente, ou se o PSP não informar, payer vem null.
  • Estorno aceito. A resposta 202 do estorno significa que o PSP aceitou o pedido. O dinheiro ainda não voltou.
  • Estorno recusado. O webhook transaction.refund_failed avisa que o PSP recusou. O erro 502 refund_failed indica que o PSP recusou ou não respondeu.

Exemplo

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

Esse evento resume a diferença entre pedir e concluir: a API registrou o pedido, mas quem decide a devolução é o PSP. Por isso o estorno Pix por API é assíncrono e o seu sistema precisa ouvir os dois desfechos.

Termos relacionados

  • DICT: o diretório que o PSP do pagador consulta para achar a conta pela chave.
  • End-to-end ID: o identificador do Pix que o PSP informa na confirmação.
  • txid: o identificador da cobrança que chega ao PSP do recebedor.
  • Webhook: como a API repassa ao seu sistema o que o PSP confirmou.

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

Continue lendo

GlossárioO que é DICTDICT é o Diretório de Identificadores de Contas Transacionais, o serviço do Pix que guarda as chaves Pix e devolve os dados da conta de quem vai receber. É ele que permite pagar com CPF, CNPJ, telefone, e-mail ou chave aleatória, sem digitar agência e conta.GlossárioO que é End-to-end IDEnd-to-end ID (EndToEndId) é o identificador único de uma transação Pix na liquidação. Na API da xFlow, ele aparece no campo pix.endToEnd das cobranças pagas e serve, junto com os dados do pagador, para conciliar o recebimento com o extrato.GlossárioO que é txidtxid (transactionId) é o identificador da transação na perspectiva de quem recebe: o código que o recebedor atribui a uma cobrança Pix para conciliar o pagamento. Ele viaja com o Pix até o PSP do recebedor, que o usa para avisar que aquela cobrança foi liquidada.BlogEstorno Pix por APINa API da xFlow, o estorno Pix é um POST /api/v1/charges/{id}/refund que devolve ao pagador o valor total de uma cobrança paga, uma vez por cobrança e até 90 dias após o pagamento. A devolução é assíncrona: a resposta 202 diz que o PSP aceitou o pedido, e a conclusão chega pelo webhook transaction.refunded.