--- title: "Cria uma transação com suporte a pagamento via cartao, boleto ou pix." method: POST path: "/api/CriaTransacaoBoletoCartaoPix" tags: ["CriaTransacaoBoletoCartaoPix"] --- # Cria uma transação com suporte a pagamento via cartao, boleto ou pix. `POST /api/CriaTransacaoBoletoCartaoPix` ## Request - Base URL: `https://pagamentos.meuk8.com.br/PagamentosAPI` - URL: `https://pagamentos.meuk8.com.br/PagamentosAPI/api/CriaTransacaoBoletoCartaoPix` - Auth: OAuth 2 - Password - Token URL: `/BknBankPagamentosAPI/token` scopes: `BknBankPagamentosAPI` Este endpoint permite criar uma transação com várias formas de pagamento definidas. 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. 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. **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 . ### Requisição | **Campo** | **Tipo** | **Descrição** | **Obrigatório** | |--|--|--|--| | BoletoValor | Numérico | Valor da compra a ser pago via boleto | Sim | | BoletoDataVencimento | Data | Data de vencimento do boleto | Não(1) | | BoletoURLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final | 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, sendo os valores possíveis: Isento, ValorAoDia ou TaxaMensal | Não | | ValorJuros | Número | Valor do Juros a ser aplicado | 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 | | 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 | Data | 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 | | 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) | | ClienteComplemento | Texto | Complemento do endereço do cliente final da compra | Não | | 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 | | 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 | Data | Data limite para o pagamento | Não | (1) Obrigatório caso a transação para boleto seja 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 | | CartaoNumeroAutorizacao | Texto | Número de autorização da transação | | CartaoAdquirente | Texto | Adquirente responsável pelo processamento da transação | | Bandeira | Texto | Bandeira do cartão | | 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 | | 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 - BknBankPagamentosBusinessCriaTransacaoBoletoCartaoPixRequest - `BoletoValor` number, double - `BoletoDataVencimento` string, date-time - `BoletoURLConfirmacao` string - `TipoMulta` 'NaoTemMulta' | 'ValorFixo' | 'ValorPercentual' - `ValorMulta` number, double - `TipoJuros` 'ValorAoDia' | 'TaxaMensal' | 'Isento' - `ValorJuros` number, double - `CartaoNomeImpresso` string - `CartaoDataValidade` string - `CartaoNumeroCartao` string - `CartaoCodigoSeguranca` string - `CartaoCardToken` string, uuid - `CartaoValor` number, double - `CartaoFormaPagamento` integer - `CartaoQuantidadeParcelas` integer - `PixTipo` string, required - `PixValor` number, double - `PixSegundosExpiracao` integer - `PixDataVencimento` string, date-time - `PixURLConfirmacao` 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 - `Mensagem2` string - `Mensagem3` string - `Mensagem4` string - `Mensagem5` string - `NumeroDocumento` string - `BoletoDataLimitePagamento` string, date-time ## Response `200` Criacao da transacao - BknBankPagamentosBusinessCriaTransacaoBoletoCartaoPixResponse - `Retorno` 'OK' | 'ERRO' - `DetalhesErro` string - `OrigemErro` string - `BoletoNossoNumero` string - `BoletoLinhaDigitavel` string - `BoletoPDF` string - `BoletoIdentificador` string - `BoletoCodigoBarras` string - `CartaoCodigoAutorizacao` string - `CartaoNsuOperacao` string - `CartaoIdentificador` string - `CartaoNumeroAutorizacao` string - `CartaoAdquirente` string - `Bandeira` string - `PixQRCodeTexto` string - `PixQRCodeImagem` string - `PixIdentificador` string ## Other responses - `400`: Erros de validação na requisição - `404`: Contéudo necessário não encontrado ## Changes - **2026-11-03** `a8b4ea0aa298`: 1 info - endpoint added [Operation history](https://skmtc.dev/meuk8/apis/k8-fintech/changes/api/CriaTransacaoBoletoCartaoPix/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)