Cria uma transação com página de checkout completo
Changed onEste endpoint permite a criação de transações de pagamento por meio de um "checkout completo", oferecendo opções de pagamento via Boleto, Cartão de Crédito e Pix. <br /> Ao utilizar esse método, é possível configurar diferentes modalidades de pagamento para cada uma das 3 opções, permitindo que o cliente escolha sua preferência no momento da compra. <br /> É viável personalizar condições de desconto para pagamentos via boleto ou Pix, e definir se os pagamentos com cartão podem ser à vista, parcelados com juros pela operadora ou parcelados diretamente com o varejista, com a possibilidade de especificar acréscimos nos valores devido ao parcelamento. <br /> Após a chamada do método, os sistemas retornam a URL da página de checkout.O cliente será redirecionado para esta página a fim de efetuar o pagamento e, posteriormente, será redirecionado para uma página específica de retorno da empresa. <br /> Também é possível indicar uma página de confirmação que o sistema acionará assim que a transação for concluída com sucesso. <br />
Requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| Valor | Numérico | Valor da compra | Sim |
| Boleto | Objeto | Dados do boleto a ser gerado | Não (1) |
| DataVencimento | Data | Data de vencimento quando pago via boleto | Não(2) |
| Desconto | Numérico | Desconto para pagar via boleto (0 se não desejado) | Não |
| - | - | - | - |
| Pix | Objeto | Dados do pix a ser gerado | Não (1) |
| SegundosExpiracao | Número | Segundos para realizar o pagamento via Pix. Quando PDV = true: intervalo de 30 a 2.592.000 segundos. Quando PDV = false: intervalo de 300 a 2.592.000 segundos | Sim(3) |
| Desconto | Numérico | Desconto para pagar via pix(0 se não desejado) | Não |
| Tipo | Texto | Informar D = para tipo de pix dinâmico, e E = para tipo de pix estático, se não for especificado, será definido automaticamente como D | Não |
| DataVencimento | Data | Data de vencimento quando pago via pix | Sim(4) |
| Pdv | Booleano | Indicador 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 |
| - | - | - | - |
| Cartao | Objeto | Dados do cartao a ser utilizado | Não (1) |
| FormaPagamento | Número | Forma de pagamento do cartão - "AVista" = 0, "ParceladoSemJuros" = 1, "ParceladoComJuros" = 2, se não for especificado, será definido automaticamente como 0 | Não |
| QuantidadeParcelas | Número | Quantidade de parcelas | Não (5) |
| - | - | - | - |
| ClienteEmail | Texto | E-mail do usuário final da compra | Não |
| ClienteCPFCNPJ | Texto | CPF ou CNPJ do cliente final da compra.Indicar somente os números | Sim |
| ClienteNome | Texto | Nome do cliente final da compra | Sim |
| ClienteEndereco | Texto | Endereço do cliente final da compra | Não (6) |
| ClienteComplemento | Texto | Complemento do endereço do cliente final da compra | Não |
| ClienteNumero | Texto | Número do endereço do cliente final da compra | Não (6) |
| ClienteBairro | Texto | Bairro do cliente final da compra | Não (6) |
| ClienteCidade | Texto | Cidade do cliente final da compra | Não (6) |
| ClienteCEP | Texto | CEP do cliente final da compra | Não (6) |
| ClienteUF | Texto | UF do cliente final da compra | Não (6) |
| ClienteDDD | Texto | DDD do telefone do cliente final da compra | Não |
| ClienteNumeroCelular | Texto | Número do telefone do cliente final da compra | Não |
| ClienteDescricao | Texto | Descrição da compra | Sim |
| ClienteIP | Texto | IP do usuário final da compra | Não |
| ClienteSexo | Texto | Sexo do cliente final da compra, podendo ser M (masculino) ou F (feminino) | Não |
| URLRetorno | Texto | URL de retorno do comércio após a conclusão do pagamento na página de checkout | Sim |
| URLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final | Não |
| NumeroPedido | Texto | Número do pedido no sistema do comércio | Não |
| Referencia | Texto | Referência para localização futura do boleto | Não |
(1) - Ao menos uma forma de pagamento deve ser preenchida. Se mais de uma forma de pagamento for preenchida, o cliente poderá escolher a forma de pagamento desejada no momento do checkout. Caso apenas uma forma de pagamento seja preenchida, esta será a única opção disponível para o cliente no checkout. (2) - Obrigatório caso informado Boleto (3) - Para pagamentos com Pix. Quando PDV = true, DataVencimento não pode ser preenchido (4) - Obrigatório caso seja pagamento Pix e PDV = false (5) - Obrigatório caso a FormaPagamento seja parcelada.Válidos valores de 2 até 12. Caso seja a vista, pode-se não enviar o valor ou enviar 0 ou 1. (6) - Obrigatório caso permita pagamento com boleto, se não for preenchido, o sistema não conseguirá gerar o boleto corretamente
Atualmente, a opção de pagamento Parcelado com Juros está desativada na tela de checkout.
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 gerada, caso chamada seja exitosa |
| URL | Texto | URL para direcionamento do usuário para realizar o pagamento, caso chamada seja exitosa |
Request
- Base URLhttps://pagamentos.meuk8.com.br/PagamentosAPI
- URLhttps://pagamentos.meuk8.com.br/PagamentosAPI/v2/CriaTransacaoCheckout
- AuthOAuth 2PasswordToken URL: /BknBankPagamentosAPI/token scopes: BknBankPagamentosAPI
Headers
Request body
Example request
{
"Valor": 0,
"Boleto": {
"DataVencimento": "2026-09-03T10:15:28.6363238-03:00",
"Desconto": 0
},
"Pix": {
"SegundosExpiracao": 300,
"Desconto": 0,
"Tipo": "E",
"DataVencimento": "2026-08-21T10:15:28.6363238-03:00",
"Pdv": false
},
"Cartao": {
"FormaPagamento": [
"ParceladoSemJuros",
"AVista"
],
"QuantidadeParcelas": 4
},
"ClienteEmail": "renatosamuel@umdominio.com.br",
"ClienteCPFCNPJ": "48455151480",
"ClienteNome": "Renato Samuel Augusto Baptista",
"ClienteEndereco": "Rua Canadá, 257",
"ClienteComplemento": "",
"ClienteNumero": "22",
"ClienteBairro": "Bacacheri",
"ClienteCidade": "Curitiba",
"ClienteCEP": "82510290",
"ClienteUF": "PR",
"ClienteDDD": "41",
"ClienteNumeroCelular": "999293802",
"ClienteDescricao": "Cliente Gold Nivel 25",
"ClienteIP": "127.0.0.1",
"ClienteSexo": "M",
"URLRetorno": "https://www.meusite.com.br/webhook/confirmacao-transacao",
"URLConfirmacao": "https://www.meusite.com.br/webhook/confirmacao-transacao",
"NumeroPedido": "pedido.2026081910",
"Referencia": "pag123"
}Response
Método executado
Changes
- info
api operation id
CriaTransacaoCheckout_CriaTransacaoCheckout_CriaTransacaoCheckout_POSTremoved and replaced withCriaTransacaoCheckout_V2_POST - info
removed the pattern
^(\d)+$from the request property(media type: application/json) - info
removed the pattern
^(\d)+$from the request property(media type: text/json) - info
removed the pattern
^(\d)+$from the request property(media type: application/xml) - info
removed the pattern
^(\d)+$from the request property(media type: text/xml) - info
removed the pattern
^(\d)+$from the request property(media type: application/x-www-form-urlencoded) - info
removed the non-success response with the status
- info