Cria uma transação via cartão
Changed onEste método permite criar uma transação de cartão de crédito, suportando pagamento à vista, parcelado sem juros (lojista) ou parcelado com juros (emissor). Os pagamentos são síncronos, ou seja, o estado final (Aprovado/Rejeitado) é obtido durante a chamada do método.
A versão “split” permite distribuir automaticamente os créditos do pagamento em diversas contas MeuK8, ideal para receitas rateadas, sem necessidade de repasses posteriores. É preciso ter em mãos os IDs dos clientes participantes do split.
Requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| SplitValores | TransacaoSplit[] | Lista de splits financeiros para distribuição da receita | Sim |
| NomeImpresso | Texto | Nome do cliente impresso no cartão | Não |
| DataValidade | Data | Data de validade do cartão | Não |
| NumeroCartao | Texto | Número do cartão | Não |
| CodigoSeguranca | Texto | Código de segurança do cartão | Não |
| CardToken | Texto | Token do cartão para transações de recorrência | Não |
| Valor | Numérico | Valor da compra | Sim |
| CartaoFormaPagamento | Numérico | Forma de pagamento | Sim |
| QuantidadeParcelas | Numérico | Parcelas do cartão; válido de 2 a 12, ou 0/1 para à vista | 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 | 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 do cliente | Não |
| ClienteNumero | Texto | Número do endereço | Não |
| ClienteBairro | Texto | Bairro do cliente | Não |
| ClienteCidade | Texto | Cidade do cliente | Não |
| ClienteCEP | Texto | CEP do cliente | 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 |
| Referencia | Texto | Referência para localização futura do boleto | 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 | Valor da transação destinado ao Marketplace ou Seller | Sim |
| ValorRoyalties | Numérico | 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 |
| Identificador | Texto | Identificador da transação |
| CodigoAutorizacao | Texto | Código de autorização da transação (NIT) |
| NsuOperacao | Texto | NSU da operação da transação |
| Adquirente | Texto | Adquirente responsável pelo processamento |
| NumeroAutorizacao | Texto | Número de autorização |
| Bandeira | Texto | Bandeira do cartão |
Request
- Base URLhttps://pagamentos.meuk8.com.br/PagamentosAPI
- URLhttps://pagamentos.meuk8.com.br/PagamentosAPI/api/marketplace/cartao
- AuthOAuth 2PasswordToken URL: /BknBankPagamentosAPI/token scopes: BknBankPagamentosAPI
Headers
Request body
Example request
{
"SplitValores": [
{
"ClienteId": "ee1afd53-19fa-44c5-a856-8190ef59b3a8",
"Valor": 150,
"ValorRoyalties": 0
},
{
"ClienteId": "eeeacd76-4192-4ab1-af70-1300bb3e29f8",
"Valor": 80,
"ValorRoyalties": 0
}
],
"NomeImpresso": "Renato Samuel Augusto Baptista",
"DataValidade": "203008",
"NumeroCartao": "4024007105862618",
"CodigoSeguranca": "1234",
"CardToken": "34c413d1-04bd-4f6a-a966-4d53d9a587d8",
"Valor": 230,
"CartaoFormaPagamento": 0,
"QuantidadeParcelas": 1,
"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",
"Referencia": "2112513",
"PreAutorizar": false,
"AntiFraude": false
}Response
Criacao da transacao
Changes
- 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