v1
latestOpenAPI 3.0.12026-07-261451591021.8 KBCriaTransacaoCartoesSplit
Cria uma transação com pagamentos através de múltiplos cartões de crédito
Este endpoint permite a criação de uma transação do tipo split (pagamento dividido), na qual o valor total de uma compra pode ser parcelado entre até dois cartões de crédito. Se ambas as transações forem aprovadas, será gerada uma transação individual para cada pagamento.Caso uma das transações seja recusada, a operação será automaticamente interrompida e um erro será retornado. <br /> Em caso de necessidade de cancelamento (total ou parcial), utilize a rota de cancelamento informando o identificador de cada transação retornada
Requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| SplitCartao(1/2) | TransacaoSplit[] | Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do MeuK8 | Sim |
| NomeImpresso(1/2) | Texto | Nome do cliente impresso no cartão | Sim |
| DataValidade(1/2) | Ano/Mês no formato AAAAMM | Data de validade do cartão | Sim |
| NumeroCartao(1/2) | Numérico de até 16 posições | Número do cartão | Sim |
| CodigoSeguranca(1/2) | Numérico de até 4 posições | Código de segurança no verso do cartão | Sim |
| Valor(1/2) | Numérico com 2 decimais | Valor da compra | Sim |
| QuantidadeParcelas(1/2) | 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 | Não |
| TitularCPFCNPJ(1/2) | Texto | CPF/CNPJ do cliente final da transação | Sim |
| CardToken(1/2) | Texto | O token do cartão para transações de recorrência | Não |
| 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 |
| 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 |
| ClienteSexo | Texto | Sexo do cliente final da compra, podendo ser M (masculino) ou F (feminino) | Não |
| 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 |
| ClienteEndereco | Texto | Endereço do cliente final da compra | Não |
| 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 |
| ClienteBairro | Texto | Bairro do cliente final da compra | Não |
| ClienteCidade | Texto | Cidade do cliente final da compra | Não |
| ClienteCEP | Texto | CEP do cliente final da compra | Não |
| ClienteUF | Texto | UF do cliente final da compra | Não |
| NumeroPedido | Texto | Número do pedido e/ou carrinho de compras | Não |
| PreAutorizar | Booleano | Aceita os valores true ou false. Enviando como true a transacao fica com o Status de CartaoPreAutorizado | Não |
| AntiFraude | Booleano | Aceita os valores true ou false. Enviando como true a transacao fica com o Status de PendenteAntifraude | Não |
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 |
| Identificador1 | Texto | Identificador da transação gerada, caso chamada seja exitosa |
| CodigoAutorizacao1 | Texto | Código de autorização da transação(NIT) (caso seja bem sucedida) |
| NsuOperacao1 | Texto | Número de operação da transação(caso seja exitosa) |
| NumeroAutorizacao1 | Texto | Número de autorização da transação |
| Adquirente1 | Texto | Adquirente responsável pelo processamento da transação |
| Bandeira 1 | Texto | Bandeira do Cartão |
| Identificador2 | Texto | Identificador da transação gerada, caso chamada seja exitosa |
| CodigoAutorizacao2 | Texto | Código de autorização da transação(NIT) (caso seja bem sucedida) |
| NsuOperacao2 | Texto | Número de operação da transação(caso seja exitosa) |
| NumeroAutorizacao2 | Texto | Número de autorização da transação |
| Adquirente2 | Texto | Adquirente responsável pelo processamento da transação |
| Bandeira2 | Texto | Bandeira do Cartão |
post/api/CriaTransacaoCartoesSplit
Headers
Aeskeystring required
Request body
Example request
{
"NomeImpresso1": "Renato Samuel Augusto Baptista",
"DataValidade1": "202905",
"NumeroCartao1": "4024007105862618",
"CodigoSeguranca1": "3234",
"Valor1": 60,
"QuantidadeParcelas1": 1,
"CardToken1": "cd3e5141-088c-41e4-8f45-3b916bcfc309",
"SplitCartao1": [
{
"ClienteId": "66f09d97-1321-4254-9bdd-222f8709a984",
"Valor": 45,
"ValorRoyalties": 0
},
{
"ClienteId": "e981d9ab-396a-42e0-96eb-9843ea9f9eaa",
"Valor": 15,
"ValorRoyalties": 0
}
],
"NomeImpresso2": "Renato Samuel Augusto Baptista",
"DataValidade2": "203005",
"NumeroCartao2": "5277749043667861",
"CodigoSeguranca2": "0879",
"Valor2": 125,
"QuantidadeParcelas2": 1,
"CardToken2": "8b9b2327-443b-4a0a-91c5-135af2749c49",
"SplitCartao2": [
{
"ClienteId": "18d31c45-9bba-4d5f-a3bf-608b4363c495",
"Valor": 95,
"ValorRoyalties": 0
},
{
"ClienteId": "85cd0421-c5e3-44f5-8689-f4e29d065379",
"Valor": 30,
"ValorRoyalties": 0
}
],
"CartaoFormaPagamento": 0,
"ClienteDescricao": "Cliente Gold Nivel 25",
"ClienteIP": "127.0.0.1",
"ClienteCPFCNPJ": "48455151480",
"ClienteNome": "Renato Samuel Augusto Baptista",
"ClienteEmail": "renatosamuel@umdominio.com.br",
"ClienteSexo": "M",
"ClienteDDD": "41",
"ClienteNumeroCelular": "999293802",
"ClienteEndereco": "Rua Canadá, 257",
"ClienteComplemento": "",
"ClienteNumero": "22",
"ClienteBairro": "Bacacheri",
"ClienteCidade": "Curitiba",
"ClienteCEP": "82510290",
"ClienteUF": "PR",
"NumeroPedido": "pedido.2026052109",
"PreAutorizar": false
}Response
Método executado com sucesso