Criar pagamento com cartão de crédito

Cria uma transação de cartão de crédito

AmbienteMétodoEndpoint
Sandboxhttps://apisandbox.braspag.com.br/v2/sales/
Produçãohttps://api.braspag.com.br/v2/sales/

ℹ️

Saiba mais sobre essa funcionalidade na documentação.

Atenção

  • Se as suas transações forem uma chamada conjunta com o Antifraude, os tamanhos de campos podem ser diferentes. Consulte o tópico Pagamento com Análise de Fraude;

  • O campo ServiceTaxAmount é exclusivo para empresas aéreas;

  • As bandeiras JCB e Diners são estrangeiras e não permitem parcelamento no cartão de crédito;

  • Os parâmetros contidos dentro dos nós Address e DeliveryAddress são de preenchimento obrigatório quando a transação é submetida ao Antifraude ou à análise do Velocity.


Autenticação 3DS nas transações de cartão de crédito

A autenticação 3DS é opcional para as transações de cartão crédito.

Se a sua loja tem integração com o protocolo 3DS para autenticação do portador do cartão, atente-se aos parâmetros que devem ser informados na requisição:

  • Envie o parâmetro Payment.Authenticate = "true";
  • Informe os dados recebidos na saída do script do 3DS no nó Payment.ExternalAuthentication;
  • Em transações com autenticação 3DS Data Only, informe o parâmetro ExternalAuthentication.DataOnly como true.

Resposta da transação de cartão de crédito

A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na criação de um pagamento com cartão de crédito.

PropriedadeDescriçãoTipoTamanho
AcquirerTransactionIdId da transação no provedor de meio de pagamento.string40
ProofOfSaleNúmero do comprovante de venda, idêntico ao NSU (Número Sequencial Único).string20
AuthorizationCodeCódigo de autorização.string300
PaymentIdCampo identificador do pagamento. O PaymentId será usado em futuras operações como consulta, captura e cancelamento.string36
ReceivedDateData em que a transação foi recebida pela Cielo.datetime19
CapturedDateData em que a transação foi capturada.string19
CapturedAmountValor capturado, sem pontuação.integer15
ECIElectronic Commerce Indicator. Representa o resultado da autenticação.string2
ReasonCodeCódigo de retorno da API para indicar sucesso ou erro na operação.string32
ReasonMessageMensagem correspondente ao ReasonCode.string512
StatusStatus da transação. Veja a lista completa de Status da Transação.byte2
ProviderReturnCodeCódigo retornado pelo provedor do meio de pagamento (adquirente ou emissor).string32
ProviderReturnMessageMensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).string512
Payment.MerchantAdviceCodeCódigo de retorno da bandeira que define período para retentativa. Válido para bandeira Mastercard e Hipercard. Saiba mais em Programa de Retentativa das Bandeirasstring2
Language
Click Try It! to start a request and see the response here!