---
title: "Cria uma transação split com suporte a pagamento via cartao, boleto ou pix."
method: POST
path: "/api/CriaTransacaoBoletoCartaoPixSplit"
tags: ["CriaTransacaoBoletoCartaoPixSplit"]
---

# Cria uma transação split com suporte a pagamento via cartao, boleto ou pix.

`POST /api/CriaTransacaoBoletoCartaoPixSplit`

## Request

- Base URL: `https://pagamentos.meuk8.com.br/PagamentosAPI`
- URL: `https://pagamentos.meuk8.com.br/PagamentosAPI/api/CriaTransacaoBoletoCartaoPixSplit`
- Auth: OAuth 2
  - Password
  - Token URL: `/BknBankPagamentosAPI/token` scopes: `BknBankPagamentosAPI`

Este método permite criar uma transação com várias formas de pagamento definidas.
<br /> 

Apenas para esclarecer, esta rota não sobrepõe a rota de criação de transação de boleto híbrida, pois na rota híbrida as formas de pagamento são conectadas (boleto + pix), já nesta rota existe a presença da forma de pagamento cartão de crédito.
<br /> 

Equivale as função de  checkout transparente (implementado dentro do sistema web do comércio) de forma a permitir a transação ser paga através de boleto, cartão ou pix. Na prática, uma chamada para esta rota equivale a realizar 3 chamadas separadas (cada qual para sua forma de pagamento) porém com a vantagem de em único endpoint executar o processo.
<br /> 

**Importante:** como são várias formas de pagamento isoladas sendo criada, cabe ao criador da requisição designar os valores independentes (note que a requisição não possui um valor total), ou seja, se por exemplo desejo criar uma requisição de um total de R$ 500 nas formas de pagamento divido em R$ 100 no cartão, R$ 200 no boleto e R$ 200 no PIX.
<br /> 

### Requisição 
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** | 
|--|--|--|--| 
| BoletoValor | Numérico com 2 decimais | Valor da compra a ser pago via boleto | Sim | 
| BoletoDataVencimento | Texto | Data de vencimento do boleto | Não | 
| BoletoURLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final | Não | 
| **BoletoSplit** | **TransacaoSplit[]** | **Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas MeuK8**| **Sim** |
| ClienteId | GUID | Identificador único do cliente | Sim |
| Valor | Numérico | Valor da transação destinado ao Marketplace ou Seller | Sim |
| ValorRoyalties | Numérico | Valor da transação destinado ao Marketplace ou Seller, sobre o qual poderão incidir taxas, conforme a configuração prévia definida para o participante do split | Não |
|-|-|-|-|
| CartaoNomeImpresso | Texto | Nome do cliente impresso no cartão | Sim | 
| CartaoDataValidade | Ano/Mês no formato AAAAMM | Data de validade do cartão | Sim | 
| CartaoNumeroCartao | Numérico de 16 posições | Número do cartão | Sim |
| CartaoCodigoSeguranca | Numérico de 3 posições | Código de segurança no verso do cartão | Sim | 
| CartaoCardToken | Guid | O token do cartão para transações de recorrência | Sim | 
| CartaoValor | Numérico com 2 decimais | Valor da compra a ser pago via cartão | Sim | 
| CartaoFormaPagamento | Numérico - Inteiro (1 posição) |Forma de pagamento do cartão, sendo possível os valores: 0 = À vista; 1 = Parcelado sem juros; 2 = Parcelado com juros| Não | 
| CartaoQuantidadeParcelas | Numérico Inteiro | Quantidade de parcelas, caso a forma de pagamento seja parcelada.Válidos valores de 2 até 12. Caso seja à vista, pode-se não enviar o valor ou enviar 0 ou 1 | Sim | 
| **CartaoSplit** | **TransacaoSplit[]**| **Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do meuK8.** | **Sim** | 
| ClienteId | GUID | Identificador único do cliente | Sim |
| Valor | Numérico | Valor da transação destinado ao Marketplace ou Seller | Sim |
| ValorRoyalties | Numérico | Valor da transação destinado ao Marketplace ou Seller, sobre o qual poderão incidir taxas, conforme a configuração prévia definida para o participante do split | Não |
|-|-|-|-|
| PixTipo | Texto | Informar E = Estático | Sim |
| PixValor | Numérico com 2 decimais | Valor da compra a ser pago via pix | Sim |
| PixSegundosExpiracao | Numérico | Tempo de validade do pagamento via Pix, em segundos, sendo aceitos valores de 300  (5 minutos) até 2592000 (30 dias) | Sim |
| PixDataVencimento | Texxto | Somente para PIX estático, uma data de vencimento deve ser informada | Não(2) | 
| PixURLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final | Não |
| **PixSplit** | **TransacaoSplit[]** | **Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas MeuK8.** | **Sim** | 
| ClienteId | GUID | Identificador único do cliente | Sim |
| Valor | Numérico | Valor da transação destinado ao Marketplace ou Seller | Sim |
| ValorRoyalties | Numérico |Valor da transação destinado ao Marketplace ou Seller, sobre o qual poderão incidir taxas, conforme a configuração prévia definida para o participante do split| Não |
|-|-|-|-|
| ClienteDescricao | Texto | Descrição da compra | Sim | 
| ClienteIP | Texto | IP do cliente final da transação | Não | 
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação | Sim | 
| ClienteNome | Texto | Nome do cliente final da transação | Sim | 
| ClienteEMail  | Texto |E-mail do cliente final da transação  | Não | 
| ClienteEndereco | Texto | Endereço do cliente final da transação  | Não(1) | 
| ClienteNumero | Texto | Número do endereço do cliente final da compra | Não(1) |
| ClienteBairro | Texto |Bairro do cliente final da transação  | Não(1) | 
| ClienteCidade | Texto | Cidade do cliente final da transação  | Não(1) | 
| ClienteCEP | Texto | CEP do cliente final da transação  | Não(1) | 
| ClienteUF | Texto | UF do cliente final da transação  | Não(1) | 
| ClienteDDD | Texto | DDD do telefone do cliente final da transação  | Não | 
| ClienteNumeroCelular | Texto |Número do telefone do cliente final da transação  | Não |
| ClienteSexo | Texto | Sexo do cliente final da compra, podendo ser M (masculino) ou F (feminino) | Não | 
| NumeroPedido | Texto | Número do pedido para controles internos | Não | 
| TipoMulta               | Texto    | Tipo da multa a ser aplicada | Não |
| ValorMulta              | Número   | Valor da multa a ser aplicada | Não |
| TipoJuros               | Texto    | Tipo do juro a ser aplicado | Não |
| ValorJuros              | Número   | Valor do Juros a ser aplicado | Não |
| Mensagem2              | Texto    | Mensagem orientativa inserida no boleto  | Não |
| Mensagem3              | Texto    | Mensagem orientativa inserida no boleto | Não |
| Mensagem4              | Texto    | Mensagem orientativa inserida no boleto | Não |
| **Mensagem5**              | **Texto**    | **Este campo não deve ser utilizado** | **Não** |
| NumeroDocumento         | Texto    | Descritivo para localização futura do boleto | Não |
| BoletoDataLimitePagamento | Texto   | Data limite para o pagamento | Não |

(1) Campo se torna obrigatório quando a transação do tipo **boleto** for executada.
(2) - Horário de vencimento: quando enviado o PixDataVencimento o complemento de horário deve ser informado como T23:59:59. Exemplo: "PixDataVencimento": "2025-10-14T23:59:59".

### Resposta
| **Campo** | **Tipo** | **Descrição** | 
|--|--|--| 
| Retorno | Texto | Retorno da chamada, podendo possuir os valores OK, ERRO, PENDENTEANTIFRAUDE ou CARTAOPREAUTORIZADO | 
| DetalhesErro | Texto |Detalhes do erro gerado, caso o retorno seja ERRO | 
| OrigemErro | Texto | Identifica qual das formas de pagamento gerou erros (Boleto, Cartão ou PIX) | 
| BoletoNossoNumero | Texto | Nosso Número do Boleto Gerado | 
| BoletoLinhaDigitavel | Texto | Linha digitável do boleto gerado | 
| BoletoPDF | Texto | PDF do boleto codificado em texto formato Base64 | 
| BoletoIdentificador | Texto  | Id do boleto gerado | 
| BoletoCodigoBarras  | Texto | Código equivalente ao binário do código de barras do boleto gerado | 
| CartaoCodigoAutorizacao | Texto | Código de autorização da transação | 
| CartaoNsuOperacao | Texto | Código de NSU da transação | 
| CartaoIdentificador | Texto | Id do cartão gerado | 
| CartaoAdquirente        | Texto    | Adquirente responsável pelo processamento da transação |
| CartaoNumeroAutorizacao | Texto    | Número de autorização da transação |
| PixQRCodeTexto | Texto | Texto do QRCode para realizar o pagamento via Pix | 
| PixQRCodeImagem | Texto | URL que gera a imagem do QRCode relacionado a transação | 
| PixIdentificador | Texto | Id do pix gerado |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessCriaTransacaoBoletoCartaoPixSplitRequest
  - `BoletoValor` number, double
  - `BoletoDataVencimento` string, date-time
  - `BoletoURLConfirmacao` string
  - `BoletoSplit` BknBankPagamentosBusinessTransacaoSplit[]
    - `ClienteId` string, uuid
    - `Valor` number, double
    - `ValorRoyalties` number, double
    - `Decisao` string
  - `CartaoNomeImpresso` string
  - `CartaoDataValidade` string
  - `CartaoNumeroCartao` string
  - `CartaoCodigoSeguranca` string
  - `CartaoCardToken` string, uuid
  - `CartaoValor` number, double
  - `CartaoFormaPagamento` integer
  - `CartaoQuantidadeParcelas` integer, required
  - `CartaoSplit` BknBankPagamentosBusinessTransacaoSplit[]
    - `ClienteId` string, uuid
    - `Valor` number, double
    - `ValorRoyalties` number, double
    - `Decisao` string
  - `PixTipo` string
  - `PixValor` number, double
  - `PixSegundosExpiracao` integer
  - `PixDataVencimento` string, date-time
  - `PixURLConfirmacao` string
  - `PixSplit` BknBankPagamentosBusinessTransacaoSplit[]
    - `ClienteId` string, uuid
    - `Valor` number, double
    - `ValorRoyalties` number, double
    - `Decisao` string
  - `ClienteDescricao` string, required
  - `ClienteIP` string
  - `ClienteCPFCNPJ` string, required
  - `ClienteNome` string, required
  - `ClienteEmail` string
  - `ClienteEndereco` string
  - `ClienteNumero` string
  - `ClienteBairro` string
  - `ClienteCidade` string
  - `ClienteComplemento` string
  - `ClienteCEP` string
  - `ClienteUF` string
  - `ClienteDDD` string
  - `ClienteNumeroCelular` string
  - `ClienteSexo` string
  - `NumeroPedido` string
  - `TipoMulta` 'NaoTemMulta' | 'ValorFixo' | 'ValorPercentual'
  - `ValorMulta` number, double
  - `TipoJuros` 'ValorAoDia' | 'TaxaMensal' | 'Isento'
  - `ValorJuros` number, double
  - `Mensagem2` string
  - `Mensagem3` string
  - `Mensagem4` string
  - `Mensagem5` string
  - `NumeroDocumento` string
  - `BoletoDataLimitePagamento` string, date-time

## Response `200`

Criacao da transacao

- BknBankPagamentosBusinessCriaTransacaoBoletoCartaoPixSplitResponse
  - `Retorno` 'OK' | 'ERRO'
  - `DetalhesErro` string
  - `OrigemErro` string
  - `BoletoNossoNumero` string
  - `BoletoLinhaDigitavel` string
  - `BoletoPDF` string
  - `BoletoIdentificador` string
  - `BoletoCodigoBarras` string
  - `CartaoCodigoAutorizacao` string
  - `CartaoNsuOperacao` string
  - `CartaoIdentificador` string
  - `CartaoAdquirente` string
  - `CartaoNumeroAutorizacao` string
  - `Bandeira` string
  - `PixQRCodeTexto` string
  - `PixQRCodeImagem` string
  - `PixIdentificador` string

## Other responses

- `500`: Erro executando método

## Changes

- **2026-11-03** `a8b4ea0aa298`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meuk8/apis/k8-fintech/changes/api/CriaTransacaoBoletoCartaoPixSplit/post.md)

---

[API](https://skmtc.dev/meuk8/apis/k8-fintech.md) - [All operations](https://skmtc.dev/meuk8/apis/k8-fintech/llms.txt) - [OpenAPI document](https://skmtc.dev/meuk8/apis/k8-fintech/revisions/a8b4ea0aa298?raw)