v1
latestOpenAPI 3.0.12026-07-261451591021.8 KBMarketplace
Cria transação para 2 cartões
Cria uma transação com pagamentos através de 2 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. Para cancelar, utilize a rota de cancelamento com o Identificador de cada transação retornada.
Requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| SplitCartao(1/2) | TransacaoSplit[] | Lista de splits financeiros para o cartão | Sim |
| NomeImpresso(1/2) | Texto | Nome do cliente impresso no cartão | Não |
| DataValidade(1/2) | Ano/Mês no formato AAAAMM | Data de validade do cartão | Não |
| NumeroCartao(1/2) | Texto de até 16 dígitos | Número do cartão | Não |
| CodigoSeguranca(1/2) | Texto de 3-4 dígitos | Código de segurança do cartão | Não |
| Valor(1/2) | Numérico com 2 decimais | Valor da transação do cartão | Sim |
| QuantidadeParcelas(1/2) | Numérico Inteiro | Número de parcelas do cartão | Sim |
| TitularCPFCNPJ(1/2) | Texto | CPF/CNPJ do portador do cartão | Não |
| CardToken(1/2) | Texto | Token do cartão | Não |
| CartaoFormaPagamento | Numérico Inteiro | Forma de pagamento | Sim |
| ClienteDescricao | Texto | Descrição da compra | Sim |
| ClienteIP | Texto | IP do cliente final | Sim |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final | Sim |
| ClienteNome | Texto | Nome do cliente final, tamanho máximo de 100 caracteres | Sim |
| ClienteEmail | Texto | E-mail do cliente final | 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 | Não |
| ClienteNumeroCelular | Texto | Número do telefone do cliente | Não |
| ClienteEndereco | Texto | Endereço do cliente | Não |
| ClienteComplemento | Texto | Complemento do endereço | Não |
| ClienteNumero | Texto | Número do endereço | Não |
| ClienteBairro | Texto | Nome do bairro | Não |
| ClienteCidade | Texto | Nome da cidade | Não |
| ClienteCEP | Texto | CEP | Não |
| ClienteUF | Texto | Unidade da federação (UF), ex: SP, RJ | Não |
| NumeroPedido | Texto | Número interno do pedido para controle do marketplace, tamanho máximo de 20 caracteres | Não |
| PreAutorizar | Booleano | Indica se a transação deve ser pré-autorizada | Não |
| Antifraude | Booleano | Indica se a transação deve passar por análise antifraude | Não |
Objeto TransacaoSplit
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| ClienteId | Guid | Identificador do cliente no split | Sim |
| Valor | Numérico com 2 decimais | Valor da transação destinado ao Marketplace ou Seller | Sim |
| ValorRoyalties | Numérico com 2 decimais | Valor da transação destinado ao Marketplace ou Seller, sobre o qual poderão incidir taxas, conforme a configuração prévia definida para o participante do split | Sim |
| Decisao | Texto | Define se o split será autoaprovado | Não |
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| Retorno | Texto | OK ou ERRO |
| DetalhesErro | Texto | Detalhes do erro, se houver |
| Identificador1 | Texto | Identificador da transação do cartão |
| CodigoAutorizacao1 | Texto | Código de autorização da transação |
| NsuOperacao1 | Texto | Número de operação da transação |
| NumeroAutorizacao1 | Texto | Número de autorização da transação |
| Adquirente1 | Texto | Adquirente da transação |
| Bandeira1 | Texto | Bandeira do cartão |
post/api/marketplace/cartoes
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
Criacao da transacao