--- title: "Cria transação para 2 cartões" method: POST path: "/api/marketplace/cartoes" tags: ["Marketplace"] --- # Cria transação para 2 cartões `POST /api/marketplace/cartoes` 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 | ## Headers - `Aeskey` string, required ## Request body - BknBankPagamentosBusinessCriaTransacaoCartoesSplitRequest - `NomeImpresso1` string - `DataValidade1` string - `NumeroCartao1` string - `CodigoSeguranca1` string - `Valor1` number, double - `QuantidadeParcelas1` integer - `TitularCPFCNPJ1` string - `CardToken1` string, uuid - `SplitCartao1` BknBankPagamentosBusinessTransacaoSplit[] - `ClienteId` string, uuid - `Valor` number, double - `ValorRoyalties` number, double - `Decisao` string - `NomeImpresso2` string - `DataValidade2` string - `NumeroCartao2` string - `CodigoSeguranca2` string - `Valor2` number, double - `QuantidadeParcelas2` integer - `TitularCPFCNPJ2` string - `CardToken2` string, uuid - `SplitCartao2` BknBankPagamentosBusinessTransacaoSplit[] - `ClienteId` string, uuid - `Valor` number, double - `ValorRoyalties` number, double - `Decisao` string - `CartaoFormaPagamento` integer - `ClienteDescricao` string, required - `ClienteIP` string - `ClienteCPFCNPJ` string, required - `ClienteNome` string, required - `ClienteEmail` string - `ClienteSexo` string - `ClienteDDD` string - `ClienteNumeroCelular` string - `ClienteEndereco` string - `ClienteComplemento` string - `ClienteNumero` string - `ClienteBairro` string - `ClienteCidade` string - `ClienteCEP` string - `ClienteUF` string - `NumeroPedido` string - `PreAutorizar` boolean ## Response `200` Criacao da transacao - BknBankPagamentosBusinessCriaTransacaoCartoesSplitResponse - `Retorno` 'OK' | 'ERRO' - `DetalhesErro` string - `Identificador1` string - `CodigoAutorizacao1` string - `NsuOperacao1` string - `NumeroAutorizacao1` string - `Adquirente1` string - `Bandeira1` string - `Identificador2` string - `CodigoAutorizacao2` string - `NsuOperacao2` string - `NumeroAutorizacao2` string - `Adquirente2` string - `Bandeira2` string ## Other responses - `400` — Erros de validação na requisição - `500` — Erro interno ao processar a transação --- [API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)