Documentação das APIs

Cria uma transação com pagamentos através de múltiplos cartões de crédito

Uma transação split, também conhecida como pagamento dividido, permite que você divida o valor total de uma compra com cartão em várias partes e pague com até dois cartões. Sendo assim, este endpoint cria uma transação com pagamentos através de múltiplos cartões de crédito.

Caso uma das transações seja reprovada, automaticamente retornará erro, em caso de aprovação cada um dos eventos de pagamento gerados terá uma transação gerada(caso seja necessário cancelar uma ou todas as transações utilize a rota de cancelamento com o Identificador de cada transação retornada).

Requisição

CampoTipoDescrição
NomeImpresso1TextoNome do cliente impresso no cartão.
DataValidade1Ano/Mês no formato AAAAMMData de validade do cartão.
NumeroCartao1Numérico de 16 posiçõesNúmero do cartão.
CodigoSeguranca1Numérico de 3 posiçõesCódigo de segurança no verso do cartão.
Valor1Numérico com 2 decimaisValor da compra
QuantidadeParcelas1Numérico InteiroQuantidade de parcelas, caso a forma de pagamento 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.
TitularCPFCNPJ1TextoCPF/CNPJ do cliente final da transação.
CardToken1TextoO token do cartão para transações de recorrência (opcional)
SplitCartao1TransacaoSplit[]Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do K8Bank. (opcional)
NomeImpresso2TextoNome do cliente impresso no cartão.
DataValidade2Ano/Mês no formato AAAAMMData de validade do cartão.
NumeroCartao2Numérico de 16 posiçõesNúmero do cartão.
CodigoSeguranca2Numérico de 3 posiçõesCódigo de segurança no verso do cartão.
Valor2Numérico com 2 decimaisValor da compra
QuantidadeParcelas2Numérico InteiroQuantidade de parcelas, caso a forma de pagamento 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.
TitularCPFCNPJ2TextoCPF/CNPJ do cliente final da transação.
CardToken2TextoO token do cartão para transações de recorrência (opcional)
SplitCartao2TransacaoSplit[]Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do K8Bank. (opcional)
CartaoFormaPagamentoNumérico Inteiro 1 posiçãoForma de pagamento do cartão, sendo possível os valores:0 = A Vista1 = Parcelado sem juros2 = Parcelado com juros (opcional)
ClienteDescricaoTextoDescrição da compra.
ClienteIPTextoIP do cliente final da transação. (opcional)
ClienteCPFCNPJTextoCPF/CNPJ do cliente final da transação.
ClienteNomeTextoNome do cliente final da transação.
ClienteEmailTextoE-mail do cliente final da transação (opcional).
ClienteSexoTextoSexo do cliente final da compra, podendo ser M (masculino) ou F (feminino) (opcional).
ClienteDDDTextoDDD do telefone do cliente final da compra (opcional).
ClienteNumeroCelularTextoNúmero do telefone do cliente final da compra (opcional).
ClienteEnderecoTextoEndereço do cliente final da compra (opcional).
ClienteComplementoTextoComplemento do endereço do cliente final da compra (opcional).
ClienteNumeroTextoNúmero do endereço do cliente final da compra (opcional).
ClienteBairroTextoBairro do cliente final da compra (opcional).
ClienteCidadeTextoCidade do cliente final da compra (opcional).
ClienteCEPTextoCEP do cliente final da compra (opcional).
ClienteUFTextoUF do cliente final da compra (opcional).
NumeroPedidoTextoNúmero do pedido e/ou carrinho de compras (opcional).
TransacaoSplit { }TransacaoSplit[]Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do K8Bank, a partir do código de cliente, do valor , valor Royalties e Decisão

Resposta

CampoTipoDescrição
RetornoTextoRetorno da chamada, podendo possuir os valores OK ou ERRO
DetalhesErroTextoDetalhes do erro gerado, caso o retorno seja ERRO
Identificador1TextoIdentificador da transação gerada, caso chamada seja exitosa
CodigoAutorizacao1TextoCódigo de autorização da transação(NIT) (caso seja bem sucedida)
NsuOperacao1TextoNúmero de operação da transação(caso seja exitosa)
NumeroAutorizacao1TextoNúmero de autorização da transação
Adquirente1TextoAdquirente responsável pelo processamento da transação
Bandeira 1TextoBandeira do Cartão, podendo ser: Diners, MasterCard, Visa, Outros, AmericanExpress, HiperCard, Aura, Elo
Identificador2TextoIdentificador da transação gerada, caso chamada seja exitosa
CodigoAutorizacao2TextoCódigo de autorização da transação(NIT) (caso seja bem sucedida)
NsuOperacao2TextoNúmero de operação da transação(caso seja exitosa)
NumeroAutorizacao2TextoNúmero de autorização da transação
Adquirente2TextoAdquirente responsável pelo processamento da transação
Bandeira2TextoBandeira do Cartão, podendo ser: Diners, MasterCard, Visa, Outros, AmericanExpress, HiperCard, Aura, Elo
Language
Authorization
OAuth2
Click Try It! to start a request and see the response here!