---
title: "Cria uma transação via pix"
method: POST
path: "/api/CriaTransacaoPixSimplesSplit"
tags: ["CriaTransacaoPixSimplesSplit"]
---

# Cria uma transação via pix

`POST /api/CriaTransacaoPixSimplesSplit`

Este método permite criar uma transação do tipo Pix, sendo que o pagamento deverá ser efetuado pelo cliente final abrindo o aplicativo do banco no qual possua conta e efetuando a leitura do QRCode gerado.
<br />
A transação via Pix é criada no estado pendente, e será válida por um determinado tempo definido (SegundosExpiracao). Caso a transação seja paga dentro do prazo proposto, esta será confirmada na URL de confirmação informada pelo integrador, o qual deve consultar o estado da mesma. Caso o tempo máximo seja ultrapassado, a transação terá seu estado alterado para Cancelada e será confirmada na URL de confirmação informada pelo integrador.
<br />
### Requisição
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--|
| SplitValores | TransacaoSplit[] | Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do K8 Fintech, a partir do código de cliente e do valor respectivo | Sim |
| Valor | Numérico com 2 decimais| Valor da compra| Sim |
| SegundosExpiracao | Numérico | Tempo de validade do pagamento via Pix, em segundos. Quando PDV = true: intervalo de 30 a 2.592.000 segundos. Quando PDV = false: intervalo de 300 a 2.592.000 segundos | Sim |
| URLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final | Não | 
| ClienteDescricao | Texto | Descrição da compra | Não |
| ClienteIP | Texto | IP do cliente final da transação | Não |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação | Não |
| ClienteNome | Texto | Nome do cliente final da transação | Não |
| ClienteEMail | Texto | E-mail do cliente final da transação | Não |
| NumeroPedido | Texto | Número interno do pedido | Não |
| Referencia | Texto | Referência para localização futura da transação | Não |
| Pdv | Booleano | Indica se a transação foi realizada em um ponto de venda físico (PDV). Quando definido como true, a transação passa a seguir regras e validações específicas. | Não |
            
### Resposta
| **Campo** | **Tipo** | **Descrição** |
|--|--|--|
|Retorno | Texto | Retorno da chamada, podendo possuir os valores OK ou ERRO |
|DetalhesErro | Texto | Detalhes do erro gerado, caso o retorno seja ERRO |
| Identificador | Texto | Identificador da transação |
| QRCodeTexto | Texto | Texto do QRCode para realizar o pagamento via Pix |
|QRCodeImagem | Texto | URL que gera a imagem do QRCode relacionado a transação |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessCriaTransacaoPixSimplesSplitRequest
  - `SplitValores` BknBankPagamentosBusinessTransacaoSplit[]
    - `ClienteId` string, uuid
    - `Valor` number, double
    - `ValorRoyalties` number, double
    - `Decisao` string
  - `Valor` number, double
  - `SegundosExpiracao` integer
  - `URLConfirmacao` string
  - `ClienteDescricao` string
  - `ClienteIP` string
  - `ClienteCPFCNPJ` string
  - `ClienteNome` string
  - `ClienteEmail` string
  - `NumeroPedido` string
  - `Referencia` string
  - `Pdv` boolean

## Response `200`

Método executado com sucesso

- BknBankPagamentosBusinessCriaTransacaoPixResponse
  - `Retorno` 'OK' | 'ERRO'
  - `DetalhesErro` string
  - `Identificador` string
  - `QRCodeTexto` string
  - `QRCodeImagem` string

## Other responses

- `500` — Erro executando método

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/versions/14db4977f490/schema)