Criar pagamento via PIX

Use este endpoint para cadastrar um pagamento que será feito via PIX.

curl --location --request POST 'https://horizon-api-sb.app.rpe.tech/api/v1/acheron/pagamento/pix?meioPagamento= ' \ --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIwZDI1NmI2MS03Y2RhLTQ5MzItYjVmNS1hZGIxOGUyNzc3MDQifQ.eyJleHAiOjE3NDI1ODE3NTMsImlhdCI6MTc0MjU2Mzc1MywianRpIjoiMDljMmMwMWUtNmMyNS00NTg5LWIyODUtZGZlMzIxZjUzZDhlIiwiaXNzIjoiaHR0cDovL3ZwYy1saW5rLXNiLmFwcC5ycGUudGVjaC9yZWFsbXMvcnBlIiwic3ViIjoiNGY2YmM0ZTgtMTRjYi00YmU4LWI4M2MtOWNiMTNhM2NiOWQwIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoicnBlY2xpZW50Iiwic2Vzc2lvbl9zdGF0ZSI6IjEzMWY5OWNjLWQ1ZjgtNDYzYS1hMDdmLWM0MDYwOTNkYjdjZCIsInNjb3BlIjoicHJvZmlsZSIsInNpZCI6IjEzMWY5OWNjLWQ1ZjgtNDYzYS1hMDdmLWM0MDYwOTNkYjdjZCIsImlzc3VlcmlkIjoxLCJyb2xlcyI6WyJST0xFX1NJU1RFTUEiLCJST0xFX1BBQ09URV9TTVNfQ09OU1VMVEFfTElTVEEiLCJST0xFX0NPTlNVTFRBUl9QT1JUQURPUiIsIlJPTEVfQ0FSVE9FU19BRE1JTiIsIlJPTEVfdGVzdGUtcm9sZSIsIlJPTEVfUEFDT1RFX1NNU19DT05TVUxUQV9QQUNPVEVTX0RJU1BPTklWRUlTIiwiUk9MRV9QQUNPVEVfU01TX0FMVEVSQUNBT19SRUNFQkVfQk9OVVNfQ0VMVUxBUiIsIlJPTEVfdW1hX3Byb3RlY3Rpb24iLCJST0xFX1BBQ09URV9TTVNfQ0FEQVNUUk9fQ09OVFJBVEFDQU9fUEFDT1RFIiwiUk9MRV9QQUNPVEVfU01TX0NBREFTVFJPX0NFTFVMQVJfU01TIiwiUk9MRV9QQUNPVEVfU01TX0NPTlNVTFRBX1BBQ09URVNfQ09OVFJBVEFET1MiLCJST0xFX0FETUlOIiwiUk9MRV9QQUNPVEVfU01TX1JFTU9DQU9fUEFDT1RFIl0sInVzZXJuYW1lIjoicnBlLXNhbmRib3gifQ.DtxNXDEFD4R7hP8XusdDNqGNvI2_NtwR5tZAjbYYEb2SWSANiPx8kRLMzVcqkvCWf57PqEAIEO6uQN9mbcYBwQ' \ --header 'accept: application/json' \ --header 'Content-Type: application/json' \ --data-raw '{ "nsuOrigem": "000001010191010128", "valor": 501, "dataHoraTransacao": "2025-07-18T13:38:16.447Z", "idPortador": 2005, "nomeEmissor": "tvoxcred", "cartaoCliente": "6392000000494861" }'

{ "data": { "statusTransacao": "00", "codigoAutorizacao": "16350", "reprocessamento": { "statusAtual": "CONFIRMADA", "statusAnterior": "NEGADA" }, "idPortador": 2005, "nsuOrigem": "10000007", "meioPagamento": "API", "mensagemTransacao": "TRANSACAO OK", "nsuAutorizacao": "045499296" } }

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Query

meioPagamento

enum<string>

opcional

Meio de pagamento usado na transação.

Para processadora Cards-Acc e transação via Pix, desmarque esta opção ao consumir o endpoint.

Valores permitidos:

AUTTARCABALCLOUDWALKECOMMERCEGOOD_CARDINGENICOIPFT_WEBITAUTECPAY_GORESOMAQSKYTEFURAURA_2VEROMERCISOFTWARE_EXPRESSDIRECAOTEF_NEUSCONDUCTOR_TEFECOMMERCE_CABALECOMMERCE_VTEXECOMMERCE_APITOTEMQRCODEAPITOTEM_EXTERNOSNXPIXPAYFACE

Exemplo:

Parâmetros Header

Authorization

string

opcional

Header HTTP utilizado para autenticação do cliente. O valor deve ser um token JWT válido precedido do prefixo Bearer.

Exemplo:

Bearer eyJhbGciOiJIUzUxMiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIwZDI1NmI2MS03Y2RhLTQ5MzItYjVmNS1hZGIxOGUyNzc3MDQifQ.eyJleHAiOjE3NDI1ODE3NTMsImlhdCI6MTc0MjU2Mzc1MywianRpIjoiMDljMmMwMWUtNmMyNS00NTg5LWIyODUtZGZlMzIxZjUzZDhlIiwiaXNzIjoiaHR0cDovL3ZwYy1saW5rLXNiLmFwcC5ycGUudGVjaC9yZWFsbXMvcnBlIiwic3ViIjoiNGY2YmM0ZTgtMTRjYi00YmU4LWI4M2MtOWNiMTNhM2NiOWQwIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoicnBlY2xpZW50Iiwic2Vzc2lvbl9zdGF0ZSI6IjEzMWY5OWNjLWQ1ZjgtNDYzYS1hMDdmLWM0MDYwOTNkYjdjZCIsInNjb3BlIjoicHJvZmlsZSIsInNpZCI6IjEzMWY5OWNjLWQ1ZjgtNDYzYS1hMDdmLWM0MDYwOTNkYjdjZCIsImlzc3VlcmlkIjoxLCJyb2xlcyI6WyJST0xFX1NJU1RFTUEiLCJST0xFX1BBQ09URV9TTVNfQ09OU1VMVEFfTElTVEEiLCJST0xFX0NPTlNVTFRBUl9QT1JUQURPUiIsIlJPTEVfQ0FSVE9FU19BRE1JTiIsIlJPTEVfdGVzdGUtcm9sZSIsIlJPTEVfUEFDT1RFX1NNU19DT05TVUxUQV9QQUNPVEVTX0RJU1BPTklWRUlTIiwiUk9MRV9QQUNPVEVfU01TX0FMVEVSQUNBT19SRUNFQkVfQk9OVVNfQ0VMVUxBUiIsIlJPTEVfdW1hX3Byb3RlY3Rpb24iLCJST0xFX1BBQ09URV9TTVNfQ0FEQVNUUk9fQ09OVFJBVEFDQU9fUEFDT1RFIiwiUk9MRV9QQUNPVEVfU01TX0NBREFTVFJPX0NFTFVMQVJfU01TIiwiUk9MRV9QQUNPVEVfU01TX0NPTlNVTFRBX1BBQ09URVNfQ09OVFJBVEFET1MiLCJST0xFX0FETUlOIiwiUk9MRV9QQUNPVEVfU01TX1JFTU9DQU9fUEFDT1RFIl0sInVzZXJuYW1lIjoicnBlLXNhbmRib3gifQ.DtxNXDEFD4R7hP8XusdDNqGNvI2_NtwR5tZAjbYYEb2SWSANiPx8kRLMzVcqkvCWf57PqEAIEO6uQN9mbcYBwQ

Content-Type

string

requerido

Tipo de mídia do corpo da solicitação.

Padrão:

application/json

Exemplo:

application/json

string

opcional

Tipo do conteúdo aceito.

Padrão:

*/*

Exemplo:

application/json

Parâmetros Bodyapplication/json

nsuOrigem

string

requerido

Número Sequencial Único (NSU) de origem da transação.

Gere um novo nsuOrigem para cada nova requisição.

<= 255 Caracteres

Exemplo:

000001010191010128

valor

number

requerido

Valor do pagamento.

Exemplo:

501

dataHoraTransacao

string <date-time>

requerido

Data e hora local da transação.

Exemplo:

2025-07-18T13:38:16.447Z

idPortador

integer <int64>

requerido

Identificador do portador.

Exemplo:

2005

nomeEmissor

string

requerido

Nome do emissor.

Exemplo:

tvoxcred

cartaoCliente

string

opcional

Número do cartão do cliente.

Exemplo:

6392000000494861

Examples

Respostas

🟢200OK

application/json

Sucesso

Body

data

object

opcional

statusTransacao

string

opcional

Status da transação.

Exemplo:

00101430

codigoAutorizacao

string

opcional

Código de autorização da transação.

Exemplo:

16350

reprocessamento

object

opcional

Informações sobre reprocessamento. Ocorre quando há um erro de processamento. Utiliza a informação de nsuOrigem para reprocessar a transação.

idPortador

string

opcional

Identificador do portador.

Exemplo:

2005

nsuOrigem

string

opcional

NSU de origem.

<= 255 Caracteres

Exemplo:

10000007

meioPagamento

string

opcional

Meio de pagamento utilizado na transação. Retornado quando cartaoCliente é preenchido.

Exemplo:

API

mensagemTransacao

string

opcional

Mensagem sobre a transação.

Exemplo:

TRANSACAO OK

nsuAutorizacao

string

opcional

NSU da autorização da transação.

<= 255 Caracteres

Exemplo:

045499296

🟠400Pedido inválido

🟠401Não autorizado

🟠403Proibido

🟠404Registro não encontrado

🔴500Erro do servidor