v1
latestOpenAPI 3.0.12026-07-261451591021.8 KBCriaTransacaoCartao
Cria uma transação via cartão de crédito
Este método permite criar uma transação de cartão de crédito, suportando pagamento a vista, parcelado sem juros (lojista) ou parcelado com juros (emissor). Notar que os pagamentos realizados com cartão de crédito são “síncronos”, ou seja, o estado final (Aprovado/Rejeitado) é obtido durante a própria chamada do método, não havendo necessidade de confirmação posterior. <br />
Requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| NomeImpresso | Texto | Nome do cliente impresso no cartão | Sim(1)(3) |
| DataValidade | Ano/Mês no formato AAAAMM | Data de validade do cartão | Sim(1) |
| NumeroCartao | Numérico de 16 posições | Número do cartão | Sim(1) |
| CodigoSeguranca | Numérico de 3 posições | Código de segurança no verso do cartão | Sim(1)(3) |
| CardToken | Texto | O token do cartão para transações de recorrência | Não(2) |
| Valor | Numérico com 2 decimais | Valor da compra | Sim |
| CartaoFormaPagamento | Numérico - Inteiro (1 posição) | Forma de pagamento do cartão, sendo possível os valores: 0 = À vista; 1 = Parcelado sem juros; 2 = Parcelado com juros | Não |
| QuantidadeParcelas | Numérico Inteiro | Quantidade 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 1 | Não |
| ClienteDescricao | Texto | Descrição da compra | Sim |
| ClienteIP | Texto | IP do cliente final da transação | Não |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação | Sim |
| ClienteNome | Texto | Nome do cliente final da transação | Sim |
| ClienteEMail | Texto | E-mail do cliente final da transação | 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 final da compra | Não |
| ClienteNumeroCelular | Texto | Número do telefone do cliente final da compra | Não |
| ClienteEndereco | Texto | Endereço do cliente final da compra | Não |
| ClienteComplemento | Texto | Complemento do endereço do cliente final da compra | Não |
| ClienteNumero | Texto | Número do endereço do cliente final da compra | Não |
| ClienteBairro | Texto | Bairro do cliente final da compra | Não |
| ClienteCidade | Texto | Cidade do cliente final da compra | Não |
| ClienteCEP | Texto | CEP do cliente final da compra | Não |
| ClienteUF | Texto | UF do cliente final da compra | Não |
| NumeroPedido | Texto | Número do pedido e/ou carrinho de compras | Não |
| Referencia | Texto | Referência para localização futura da transação | Não |
| PreAutorizar | Booleano | Aceita os valores true ou false. Enviando como true a transacao fica com o Status de CartaoPreAutorizado | Não |
| AntiFraude | Booleano | Aceita os valores true ou false. Enviando como true a transacao fica com o Status de PendenteAntifraude | Não |
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| Retorno | Texto | Retorno da chamada, podendo possuir os valores OK, ERRO, PENDENTEANTIFRAUDE ou CARTAOPREAUTORIZADO |
| DetalhesErro | Texto | Detalhes do erro gerado, caso o retorno seja ERRO |
| Identificador | Texto | Identificador da transação |
| CodigoAutorizacao | Texto | Código de autorização da transação (NIT) (caso seja bem sucedida) |
| NsuOperacao | Texto | Número de operação da transação(caso seja bem sucedida) |
| Adquirente | Texto | Adquirente responsável pelo processamento da transação |
| NumeroAutorizacao | Texto | Número de autorização da transação |
post/api/CriaTransacaoCartao
Headers
Aeskeystring required
Request body
Example request
{
"NomeImpresso": "Renato Samuel Augusto Baptista",
"DataValidade": "203005",
"NumeroCartao": "4024007105862618",
"CodigoSeguranca": "131",
"CardToken": "f5687222-40b6-41cf-a9df-041413695979",
"Valor": 150.77,
"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.2026052109",
"Referencia": "2112513",
"PreAutorizar": false,
"AntiFraude": false
}Response
Método executado com sucesso