Cria uma transação com pagamentos através de dois 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.

Em caso de necessidade de cancelamento (total ou parcial), utilize a rota de cancelamento informando o identificador de cada transação retornada

Requisição

CampoTipoDescriçãoObrigatório
NomeImpresso1TextoNome do cliente impresso no cartãoSim(1)(3)
DataValidade1DataData de validade do cartãoSim(1)
NumeroCartao1TextoNúmero do cartãoSim(1)
CodigoSeguranca1TextoCódigo de segurança no verso do cartãoSim(1)(3)
Valor1NuméricoValor da compraSim
QuantidadeParcelas1NúmeroQuantidade 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 1Não
TituloCPFCNPJ1TextoCPF/CNPJ do titular do cartão 1Não
CardToken1GUIDIdentificador único do token do cartão para transações de recorrênciaNão(2)
SplitCartao1Array de ObjetoArray de objetos contendo os dados de split para a transação do cartão 1. O valor total dos splits deve ser igual ao valor total da transação do cartão 1.Não
ClienteIdGUIDIdentificador do ClienteSim
ValorNúmeroValor da TransaçãoSim
ValorRoyatiesNúmeroValor da parte da transação referente ao seller ou marketplaceNão
DecisaoTextoInforma se o split já está aprovado ou não para efetivação da transferência para o recebedorNão
NomeImpresso2TextoNome do cliente impresso no cartãoSim(1)(3)
DataValidade2DataData de validade do cartãoSim(1)
NumeroCartao2TextoNúmero do cartãoSim(1)
CodigoSeguranca2TextoCódigo de segurança no verso do cartãoSim(1)(3)
Valor2NuméricoValor da compraSim
QuantidadeParcelas2NúmeroQuantidade 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 1Não
TituloCPFCNPJ2TextoCPF/CNPJ do titular do cartão 1Não
CardToken2GUIDIdentificador único do token do cartão para transações de recorrênciaNão(2)
SplitCartao2Array de ObjetoArray de objetos contendo os dados de split para a transação do cartão 1. O valor total dos splits deve ser igual ao valor total da transação do cartão 1.Não
ClienteIdGUIDIdentificador do ClienteSim
ValorNúmeroValor da TransaçãoSim
ValorRoyatiesNúmeroValor da parte da transação referente ao seller ou marketplaceNão
DecisaoTextoInforma se o split já está aprovado ou não para efetivação da transferência para o recebedorNão
CartaoFormaPagamentoNúmeroForma de pagamento do cartão, sendo possível os valores: 0 = À vista; 1 = Parcelado sem juros; 2 = Parcelado com jurosNão(4)
ClienteDescricaoTextoDescrição da compraSim
ClienteIPTextoIP do cliente final da transaçãoNão
ClienteCPFCNPJTextoCPF/CNPJ do cliente final da transaçãoSim
ClienteNomeTextoNome do cliente final da transaçãoSim
ClienteEmailTextoE-mail do cliente final da transaçãoNão
ClienteSexoTextoSexo do cliente final da compra - M (masculino) ou F (feminino)Não
ClienteDDDTextoDDD do telefone do cliente final da compraNão
ClienteNumeroCelularTextoNúmero do telefone do cliente final da compraNão
ClienteEnderecoTextoEndereço do cliente final da compraNão
ClienteComplementoTextoComplemento do endereço do cliente final da compraNão
ClienteNumeroTextoNúmero do endereço do cliente final da compraNão
ClienteBairroTextoBairro do cliente final da compraNão
ClienteCidadeTextoCidade do cliente final da compraNão
ClienteCEPTextoCEP do cliente final da compraNão
ClienteUFTextoUF do cliente final da compraNão
NumeroPedidoTextoNúmero do pedido e/ou carrinho de comprasNão
PreAutorizarBooleanoIndica se a transação deve ser pré-autorizada. Enviando como true a transacao fica com o Status de CartaoPreAutorizadoNão

(1) - Não se torna obrigatório caso o CardToken for informado
(2) - Obrigatório se número e código de segurança não forem informados
(3) - É obrigatório se o provedor de pagamento for a Valorem, mesmo se tiver informando o cardToken
(4) - Obrigatório informar 1(Parcelado sem juros) ou 2(Parcelado com juros) caso QuantidadeParcelas seja maior ou igual a 2.

Resposta

CampoTipoDescrição
RetornoTextoRetorno da chamada, podendo possuir os valores OK, ERRO, PENDENTEANTIFRAUDE ou CARTAOPREAUTORIZADO
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
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
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

requisição de entrada

string
string
^20[0-4]\d(0[1-9]|1[0-2])$
string
^(\d)+$
string
^(\d)+$
double
≤ 2147483647
int32
0 to 12
string
uuid
SplitCartao1
array of objects
SplitCartao1
string
string
^20[0-4]\d(0[1-9]|1[0-2])$
string
^(\d)+$
string
^(\d)+$
double
≤ 2147483647
int32
0 to 12
string
required
uuid
SplitCartao2
array of objects
SplitCartao2
int32
0 to 2
string
required
string
string
required
string
required
string
string
length between 1 and 1
M|F
string
^(\d)+$
string
^(\d)+$
string
string
string
^(\d)+$
string
string
string
^(\d)+$
string
string
boolean
Headers
string
required
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json