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.

Requisição

CampoTipoDescriçãoObrigatório
NomeImpressoTextoNome do cliente impresso no cartãoSim(1)(3)
DataValidadeAno/Mês no formato AAAAMMData de validade do cartãoSim(1)
NumeroCartaoNumérico de 16 posiçõesNúmero do cartãoSim(1)
CodigoSegurancaNumérico de 3 posiçõesCódigo de segurança no verso do cartãoSim(1)(3)
CardTokenTextoO token do cartão para transações de recorrênciaNão(2)
ValorNumérico com 2 decimaisValor da compraSim
CartaoFormaPagamentoNumé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 jurosNão
QuantidadeParcelasNumérico InteiroQuantidade 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 1Não
ClienteDescricaoTextoDescrição da compraSim
ClienteIPTextoIP do cliente final da transaçãoNão
ClienteCPFCNPJTextoCPF/CNPJ do cliente final da transaçãoSim
ClienteNomeTextoNome do cliente final da transaçãoSim
ClienteEMailTextoE-mail do cliente final da transaçãoNão
ClienteSexoTextoSexo do cliente final da compra, podendo ser M (masculino) ou F (feminino)Não
ClienteDDDTextoDDD do telefone do cliente final da compraNão
ClienteNumeroCelularTextoNúmero do telefone do cliente final da compraNão
ClienteEnderecoTextoEndereço do cliente final da compraNão
ClienteComplementoTextoComplemento do endereço do cliente final da compraNão
ClienteNumeroTextoNúmero do endereço do cliente final da compraNão
ClienteBairroTextoBairro do cliente final da compraNão
ClienteCidadeTextoCidade do cliente final da compraNão
ClienteCEPTextoCEP do cliente final da compraNão
ClienteUFTextoUF do cliente final da compraNão
NumeroPedidoTextoNúmero do pedido e/ou carrinho de comprasNão
ReferenciaTextoReferência para localização futura da transaçãoNão
PreAutorizarBooleanoAceita os valores true ou false. Enviando como true a transacao fica com o Status de CartaoPreAutorizadoNão
AntiFraudeBooleanoAceita os valores true ou false. Enviando como true a transacao fica com o Status de PendenteAntifraudeNão

(1) Não se torna obrigatório caso o cardToken for informado
(2) Obrigatório se número e código de segurança não forem informados
(3) É obrigatório se o provedor de pagamento for a Valorem, mesmo se tiver informando o cardToken

Resposta

CampoTipoDescrição
RetornoTextoRetorno da chamada, podendo possuir os valores OK, ERRO, PENDENTEANTIFRAUDE ou CARTAOPREAUTORIZADO
DetalhesErroTextoDetalhes do erro gerado, caso o retorno seja ERRO
IdentificadorTextoIdentificador da transação
CodigoAutorizacaoTextoCódigo de autorização da transação (NIT) (caso seja bem sucedida)
NsuOperacaoTextoNúmero de operação da transação(caso seja bem sucedida)
AdquirenteTextoAdquirente responsável pelo processamento da transação
NumeroAutorizacaoTextoNúmero de autorização da transação
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

requisição de entrada

string
string
^20[0-4]\d(0[1-9]|1[0-2])$
string
^(\d)+$
string
^(\d)+$
uuid
double
≤ 2147483647
int32
0 to 2
int32
0 to 12
string
required
string
string
required
^(\d)+$
string
required
string
string
length between 1 and 1
M|F
string
^(\d)+$
string
^(\d)+$
string
string
string
^(\d)+$
string
string
string
^(\d)+$
string
string
string
boolean
boolean
Headers
string
required
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

500

Erro executando método

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json