MEmeuk8
Marketplace

Cria transação para 2 cartões

Changed on

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

CampoTipoDescriçãoObrigatório
SplitCartao(1/2)TransacaoSplit[]Lista de splits financeiros para o cartãoSim
NomeImpresso(1/2)TextoNome do cliente impresso no cartãoNão
DataValidade(1/2)DataData de validade do cartãoNão
NumeroCartao(1/2)TextoNúmero do cartãoNão
CodigoSeguranca(1/2)TextoCódigo de segurança do cartãoNão
Valor(1/2)NuméricoValor da transação do cartãoSim
QuantidadeParcelas(1/2)NuméricoNúmero de parcelas do cartãoSim
TitularCPFCNPJ(1/2)TextoCPF/CNPJ do portador do cartãoNão
CardToken(1/2)TextoToken do cartãoNão
CartaoFormaPagamentoNuméricoForma de pagamentoSim
ClienteDescricaoTextoDescrição da compraSim
ClienteIPTextoIP do cliente finalSim
ClienteCPFCNPJTextoCPF/CNPJ do cliente finalSim
ClienteNomeTextoNome do cliente final, tamanho máximo de 100 caracteresSim
ClienteEmailTextoE-mail do cliente finalNão
ClienteSexoTextoSexo do cliente final da compra, podendo ser M (masculino) ou F (feminino)Não
ClienteDDDTextoDDD do telefone do clienteNão
ClienteNumeroCelularTextoNúmero do telefone do clienteNão
ClienteEnderecoTextoEndereço do clienteNão
ClienteComplementoTextoComplemento do endereçoNão
ClienteNumeroTextoNúmero do endereçoNão
ClienteBairroTextoNome do bairroNão
ClienteCidadeTextoNome da cidadeNão
ClienteCEPTextoCEPNão
ClienteUFTextoUnidade da federação (UF), ex: SP, RJNão
NumeroPedidoTextoNúmero interno do pedido para controle do marketplace, tamanho máximo de 20 caracteresNão
PreAutorizarBooleanoIndica se a transação deve ser pré-autorizadaNão
AntifraudeBooleanoIndica se a transação deve passar por análise antifraudeNão

Objeto TransacaoSplit

CampoTipoDescriçãoObrigatório
ClienteIdGuidIdentificador do cliente no splitSim
ValorNuméricoValor da transação destinado ao Marketplace ou SellerSim
ValorRoyaltiesNuméricoValor 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 splitSim
DecisaoTextoDefine se o split será autoaprovadoNão

Resposta

CampoTipoDescrição
RetornoTextoOK ou ERRO
DetalhesErroTextoDetalhes do erro, se houver
Identificador1TextoIdentificador da transação do cartão
CodigoAutorizacao1TextoCódigo de autorização da transação
NsuOperacao1TextoNúmero de operação da transação
NumeroAutorizacao1TextoNúmero de autorização da transação
Adquirente1TextoAdquirente da transação
Bandeira1TextoBandeira do cartão
post/api/marketplace/cartoes

Request

  • Base URL
    https://pagamentos.meuk8.com.br/PagamentosAPI
  • URL
    https://pagamentos.meuk8.com.br/PagamentosAPI/api/marketplace/cartoes
  • Auth
    OAuth 2
    Password
    Token URL: /BknBankPagamentosAPI/token scopes: BknBankPagamentosAPI

Headers

Aeskeystring required

Request body

NomeImpresso1string
DataValidade1string
NumeroCartao1string
CodigoSeguranca1string
Valor1number double
QuantidadeParcelas1integer
TitularCPFCNPJ1string
CardToken1string uuid
NomeImpresso2string
DataValidade2string
NumeroCartao2string
CodigoSeguranca2string
Valor2number double
QuantidadeParcelas2integer
TitularCPFCNPJ2string required
CardToken2string uuid
CartaoFormaPagamentointeger
ClienteDescricaostring required
ClienteIPstring
ClienteCPFCNPJstring required
ClienteNomestring required
ClienteEmailstring
ClienteSexostring
ClienteDDDstring
ClienteNumeroCelularstring
ClienteEnderecostring
ClienteComplementostring
ClienteNumerostring
ClienteBairrostring
ClienteCidadestring
ClienteCEPstring
ClienteUFstring
NumeroPedidostring
PreAutorizarboolean

Example request

{
  "NomeImpresso1": "Renato Samuel Augusto Baptista",
  "DataValidade1": "202908",
  "NumeroCartao1": "4024007105862618",
  "CodigoSeguranca1": "3234",
  "Valor1": 60,
  "QuantidadeParcelas1": 1,
  "CardToken1": "aeb7274a-5db3-4bf1-858c-532a5825b19d",
  "SplitCartao1": [
    {
      "ClienteId": "61d070d0-0747-4c8a-bb5e-bc262f8ca128",
      "Valor": 45,
      "ValorRoyalties": 0
    },
    {
      "ClienteId": "d000f385-b84d-48a7-a0cf-46436cb742cd",
      "Valor": 15,
      "ValorRoyalties": 0
    }
  ],
  "NomeImpresso2": "Renato Samuel Augusto Baptista",
  "DataValidade2": "203008",
  "NumeroCartao2": "5277749043667861",
  "CodigoSeguranca2": "0879",
  "Valor2": 125,
  "QuantidadeParcelas2": 1,
  "CardToken2": "cd511ae1-6c8f-4ef5-8047-9fbd39e986c6",
  "SplitCartao2": [
    {
      "ClienteId": "4544fea1-5a24-4079-b6c5-539be12e50c8",
      "Valor": 95,
      "ValorRoyalties": 0
    },
    {
      "ClienteId": "d01401e4-14b9-4dd5-b52f-f868967e5940",
      "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.2026081910",
  "PreAutorizar": false
}

Response

Criacao da transacao

Retorno'OK' | 'ERRO'
DetalhesErrostring
Identificador1string
CodigoAutorizacao1string
NsuOperacao1string
NumeroAutorizacao1string
Adquirente1string
Bandeira1string
Identificador2string
CodigoAutorizacao2string
NsuOperacao2string
NumeroAutorizacao2string
Adquirente2string
Bandeira2string

Changes

  • a8b4ea0aa298Revision changes
    • breaking

      the request property became required (media type: application/json)

    • breaking

      the request property became required (media type: text/json)

    • breaking

      the request property became required (media type: application/xml)

    • breaking

      the request property became required (media type: text/xml)

    • breaking

      the request property became required (media type: application/x-www-form-urlencoded)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/json)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: text/json)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/xml)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: text/xml)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/x-www-form-urlencoded)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/json)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: text/json)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/xml)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: text/xml)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/x-www-form-urlencoded)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/json)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: text/json)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/xml)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: text/xml)

    • info

      removed the pattern ^(\d)+$ from the request property (media type: application/x-www-form-urlencoded)