Manual de Integração - API Rest

Redirecionando para https://docs.cielo.com.br/gateway/docs/gateway ...

As documentações do Gateway de Pagamentos estão em um novo portal

Acesse o novo portal de desenvolvedores E-commerce docs.cielo.com.br.

Atenção: O conteúdo desta página está sendo descontinuado e não receberá atualizações a partir de 14/08/2024. Visite a nova documentação em docs.cielo.br.

Introdução à API do Pagador

O objetivo desta documentação é orientar o desenvolvedor sobre como integrar o seu e-commerce com a API do Pagador, gateway de pagamentos da Braspag, descrevendo os serviços disponíveis com exemplos de requisição e resposta.

Principais Benefícios

A solução API Pagador foi desenvolvida com a tecnologia REST, que é padrão de mercado e independe da tecnologia utilizada por nossos clientes. Desta forma, é possível integrar-se utilizando as mais variadas linguagens de programação, tais como: ASP, ASP.Net, Java, PHP, Ruby e Python.

Conheça alguns dos atributos que se destacam no Gateway de Pagamentos:

Ausência de aplicativos proprietários: não é necessário instalar aplicativos no ambiente da loja virtual em nenhuma hipótese.
Simplicidade: o protocolo utilizado é puramente o HTTPS.
Facilidade de testes: a plataforma Braspag oferece um ambiente Sandbox publicamente acessível, que permite ao desenvolvedor a criação de uma conta de testes sem a necessidade de credenciamento, facilitando e agilizando o início da integração.
Credenciais: as credenciais do cliente (número de afiliação e chave de acesso) trafegam no cabeçalho da requisição HTTP.
Segurança: a troca de informações se dá sempre entre o servidor da loja e o servidor da Braspag, ou seja, sem o browser do comprador.
Integração multiplataforma: a integração é realizada através de APIs REST, que permitem a utilização de diferentes aplicações.

Arquitetura da Integração

O modelo empregado na integração das APIs é simples e se baseia na utilização de duas URLs:

URL transacional - específica para operações como autorização, captura e cancelamento de transações.
URL de consulta - para operações consultivas, como uma pesquisa de transações.

Para executar uma operação:

Combine a base da URL do ambiente com o endpoint da operação desejada. Ex.: https://api.braspag.com.br/v2/sales/.
Envie a requisição para a URL utilizando o método HTTP adequado à operação.

Método HTTP	Descrição
GET	Retorna recursos já existentes, ex.: consulta de transações.
POST	Cria um novo recurso, ex.: criação de uma transação.
PUT	Atualiza um recurso existente, ex.: captura ou cancelamento de uma transação previamente autorizada.

Todas a operações requerem as credenciais de acesso “Merchant ID” e “Merchant Key”, que devem ser enviadas no cabeçalho (header) da requisição.
Cada envio de requisição irá retornar um código de Status HTTP, indicando se ela foi realizada com sucesso ou não.

Ambientes de Teste e Produção

Utilize o ambiente Sandbox para realizar testes dos nossos produtos e serviços antes de disponibilizar sua solução no ambiente de Produção.

Ambiente Sandbox

Para a fase de testes, crie uma conta em nosso sandbox e experimente as nossas APIs sem compromisso.

Informação	Descrição
Credenciais de acesso	`MerchantId` e `MerchantKey` recebidos após criação da conta de testes em Cadastro do Sandbox.
Base da URL transacional	https://apisandbox.braspag.com.br/
Base da URL para consultas	https://apiquerysandbox.braspag.com.br/

Ambiente de Produção

Realizados os testes, disponibilize sua solução em ambiente de produção.

Informação	Descrição
Credenciais de acesso	`MerchantId` e `MerchantKey` fornecidos pela Braspag. Para mais informações, entre em contato com o Suporte Braspag.
Base da URL transacional	https://api.braspag.com.br/
Base da URL para consultas	https://apiquery.braspag.com.br/

Termos Transacionais

Para que possa aproveitar melhor todos os recursos disponíveis em nossa API, é importante você antes conhecer os seguintes conceitos envolvidos no processamento de uma transação de cartão de crédito:

Etapa	Descrição
Autorização	Operação que viabiliza o processamento de uma venda com um cartão de crédito. A autorização (também chamada pré-autorização) irá sensibilizar o limite do cliente, mas ainda não irá gerar cobrança em sua fatura
Captura	Confirmação necessária para que a cobrança seja efetivada. O tempo limite para capturar uma transação pré-autorizada varia entre adquirentes, mas pode ser de até 5 dias após a data da pré-autorização.
Captura Automática	Opção que permite que a transação possa ser autorizada e capturada num mesmo momento, isentando o lojista de enviar a confirmação.
Cancelamento	Recurso de cancelamento de compra aplicável no dia em que a transação foi autorizada/capturada. No caso de uma transação apenas autorizada, o cancelamento irá liberar o limite do cartão que foi sensibilizado. Se a transação já tiver sido capturada, o cancelamento irá desfazer a venda, mas somente quando executado até às 23:59:59 da data da autorização/captura.
Estorno	Recurso de cancelamento de compra aplicável no dia seguite ao da captura da transação. Neste caso, a transação será submetida ao processo de estorno pela adquirente.

Os seguintes recursos são oferecidos, podendo ser aplicados em diferentes momentos do seu fluxo transacional:

Termo	Descrição
Antifraude	Plataforma de prevenção à fraude que fornece uma análise de risco detalhada das compras on-line. Este processo é totalmente transparente para o portador do cartão. De acordo com os critérios preestabelecidos, o pedido pode ser automaticamente aceito, recusado ou encaminhado para análise manual. Leia mais na seção Pagamentos com Análise de Fraude ou consulte o manual Antifraude.
Autenticação	Processo que possibilita passagem da venda por autenticação do emissor do cartão, trazendo com isso mais segurança para a venda e transferindo para o emissor o risco de fraude. Leia mais na seção Autenticação 3DS ou consulte o manual Autenticação 3DS 2.2.
Cartão Protegido	Plataforma que permite o armazenamento seguro de dados sensíveis de cartão de crédito no formato de token. Com a plataforma, a loja poderá oferecer recursos como “Compra com 1 clique” e “Retentativa” de envio de transação, sempre preservando a integridade e a confidencialidade das informações. Leia mais na seção Salvando e Reutilizando Cartões ou consulte o manual Cartão Protegido.

Suporte Braspag

Acesse nossa ferramenta de atendimento web Zendesk e consulte o nosso artigo Atendimento Braspag para mais informações sobre nosso serviço de suporte.

Meios de Pagamento

A API do Pagador trabalha com transações referentes às seguintes formas de pagamento: cartão de crédito, cartão de débito, Pix, QR Code, boleto bancário, transferência eletrônica, Buy Now Pay Later (BNPL), e-wallet e voucher. O fluxo da transação depende dos serviços utilizados e das configurações escolhidas pela loja.

Veja abaixo a representação de um fluxo transacional padrão seguida de uma pequena descrição das principais partes envolvidas:

Fluxo Transacional

Plataforma de e-commerce: provê solução técnica para lojistas construírem toda a infraestrutura e processos necessários para sua operação de e-commerce.
Gateway: conecta e-commerces com os serviços de pagamento (adquirente, boleto, emissor), facilitando a gestão dos fornecedores de pagamento pelos lojistas.
Adquirente: faz a conexão da transação com as bandeiras e liquida a transação para os lojistas.
Bandeira: faz a comunicação com o emissor do cartão da transação e liquida a transação para os adquirentes.
Emissor: dá crédito e armazena o dinheiro do comprador. Na transação, aprova ou nega por razões de saldo, validade do cartão ou fraude. Liquida a transação para a bandeira.

Nota: Para evitar que a duplicidade de pedidos ocorra durante uma transação, o Pagador possui a opção de bloqueio de pedidos duplicados que, quando habilitado, retorna o código de erro “302”, informando que o MerchantOrderId enviado está duplicado. Para saber mais detalhes sobre essa feature, consulte este artigo.

Cartões de Crédito e Débito

Criando uma Transação de Crédito

Veja abaixo a representação de um fluxo transacional padrão na criação de uma transação de crédito: Fluxo Cartão de Crédito

Ao solicitar a autorização de uma transação de crédito, é necessário seguir o contrato abaixo. Os dados referentes à sua afiliação são enviados no nó Payment.Credentials e devem ser enviados sempre que uma nova requisição de autorização for submetida para aprovação.

Caso a sua loja utilize os serviços de Retentativa ou Loadbalance, as afiliações devem ser cadastradas pela equipe de suporte ao cliente. Para solicitar o cadastro de afiliações, clique aqui e envie sua requisição.

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. Na tabela de parâmetros, mais abaixo, esses parâmetros aparecem marcados com um * na coluna de obrigatoriedade.

Transações de crédito Mastercard e Hipercard com credenciais armazenadas: a bandeira Mastercard e Hipercard exige o envio do Indicador de Início da Transação para compras de cartão de crédito e débito que usam os dados armazenados de um cartão. O objetivo é indicar se a transação foi iniciada pelo comprador (titular do cartão) ou pela loja. Nesse cenário é obrigatório o envio do nó InitiatedTransactionIndicator com os parâmetros Category e SubCategory para transações Mastercard e Hipercard, dentro do nó Payment. Confira a lista de categorias na descrição do parâmetro Category e a tabela completa de subcategorias em Indicador de Início da Transação.

Seguem exemplos de envio de requisição e resposta para criar uma transação de crédito:

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "Tip":false,
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":"false",
         "Alias":"",
         "CardOnFile":{
            "Usage": "Used",
            "Reason":"Unscheduled"
         }
      },
      "InitiatedTransactionIndicator": {
            "Category": "C1",
            "Subcategory": "Standingorder"
         },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051002",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "Tip":false,
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":"false",
         "Alias":"",
         "CardOnFile":{
            "Usage":"Used",
            "Reason":"Unscheduled"
         }
      },
      "InitiatedTransactionIndicator": {
            "Category": "C1",
            "Subcategory": "Standingorder"
         },      
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na Braspag.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na Braspag.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`MerchantOrderId`	Número de identificação do pedido.	texto	50	Sim
`Customer.Name`	Nome do comprador.	texto	255	Sim
`Customer.Identity`	Número do CPF ou CNPJ do cliente.	texto	14	Não
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF ou CNPJ).	texto	255	Não
`Customer.Email`	Email do comprador.	texto	255	Não
`Customer.Birthdate`	Data de nascimento do comprador no formato AAAA-MM-DD.	data	10	Não
`Customer.IpAddress`	Endereço de IP do comprador. Suporte a IPv4 e IPv6.	texto	45	Não
`Customer.Address.Street`	Endereço de contato do comprador.	texto	255	Não*
`Customer.Address.Number`	Número do endereço de contato do comprador.	texto	15	Não*
`Customer.Address.Complement`	Complemento do endereço de contato do comprador.	texto	50	Não*
`Customer.Address.ZipCode`	CEP do endereço de contato do comprador.	texto	9	Não*
`Customer.Address.City`	Cidade do endereço de contato do comprador.	texto	50	Não*
`Customer.Address.State`	Estado do endereço de contato do comprador.	texto	2	Não*
`Customer.Address.Country`	País do endereço de contato do comprador.	texto	35	Não*
`Customer.Address.District`	Bairro do endereço de contato do comprador.	texto	50	Não*
`Customer.DeliveryAddress.Street`	Endereço de entrega do comprador.	texto	255	Não*
`Customer.DeliveryAddress.Number`	Número do endereço de entrega.	texto	15	Não*
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega.	texto	50	Não*
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega.	texto	9	Não*
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega.	texto	50	Não*
`Customer.DeliveryAddress.State`	Estado do endereço de entrega.	texto	2	Não*
`Customer.DeliveryAddress.Country`	País do endereço de entrega.	texto	35	Não*
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega.	texto	50	Não*
`Payment.Provider`	Nome do provedor do meio de pagamento. Clique aqui para acessar a lista de provedores.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Neste caso, “CreditCard”.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.ServiceTaxAmount`	Aplicável apenas para empresas aéreas. Montante do valor da autorização que deve ser destinado à taxa de serviço. Obs.: Esse valor não é adicionado ao valor da autorização.	número	15	Não
`Payment.Currency`	Moeda em que o pagamento será feito (BRL / USD / MXN / COP / CLP / ARS / PEN / EUR / PYN / UYU / VEB / VEF / GBP).	texto	3	Não
`Payment.Country`	País em que o pagamento será feito.	texto	3	Não
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.Interest`	Tipo de parcelamento - Loja (“ByMerchant”) ou Emissor (“ByIssuer”).	texto	10	Não
`Payment.Capture`	Indica se a autorização deve ser com captura automática (“true”) ou não (“false”). Deverá verificar junto à adquirente a disponibilidade desta funcionalidade.	booleano	—	Não (default “false”)
`Payment.Authenticate`	Indica se a transação deve ser autenticada (“true”) ou não (“false”). Deverá verificar junto à adquirente a disponibilidade desta funcionalidade.	booleano	—	Não (default “false”)
`Payment.Recurrent`	Indica se a transação é do tipo recorrente (“true”) ou não (“false”). O valor “true” não originará uma nova recorrência, apenas permitirá a realização de uma transação sem a necessidade de envio do CVV. `Authenticate` deve ser “false” quando `Recurrent` é “true”. Somente para transações Cielo, Cielo30 e Rede2.	booleano	—	Não (default “false”)
`Payment.SoftDescriptor`	Valor que será concatenado com o valor de cadastro na adquirente para identificação na fatura.	texto	13	Não
`Payment.DoSplit`	Indica se a transação será dividida entre várias contas (“true”) ou não (“false”).	booleano	—	Não (default “false”)
`Payment.Tip`	As gorjetas são um tipo de transação que funcionam para cartão de crédito ou débito, tokenizados ou não. Se o valor for true, a transação é identificada como gorjeta, caso contrário, o valor deverá ser false.	booleano	—	Não (default “false”)
`Payment.CreditCard.CardNumber`	Número do cartão do comprador.	texto	19	Sim
`Payment.CreditCard.Holder`	Nome do portador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`Payment.CreditCard.ExpirationDate`	Data de validade impressa no cartão.	texto	7	Sim
`Payment.CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`Payment.CreditCard.Brand`	Bandeira do cartão.	texto	10	Sim
`Payment.CreditCard.SaveCard`	Identifica se o cartão será salvo para gerar o token (CardToken).	booleano	—	Não (default “false”)
`Payment.CreditCard.Alias`	Nome atribuído pelo lojista ao cartão salvo como CardToken.	texto	64	Não
`Payment.CreditCard.CardOnFile.Usage`	“First” se o cartão foi armazenado e é seu primeiro uso. “Used” se o cartão foi armazenado e já utilizado em outra transação. Aplicável para Cielo30 e Rede2.	texto	-	Não
`Payment.CreditCard.CardOnFile.Reason`	Indica o propósito de armazenamento de cartões, caso o campo `Usage` seja “Used”. “Recurring” - Compra recorrente programada, ex.: assinaturas. “Unscheduled” - Compra recorrente sem agendamento, ex.: aplicativos de serviços. “Installments” - Parcelamento através da recorrência. Aplicável para Cielo30 e Rede2.	texto	-	Condicional
`Payment.InitiatedTransactionIndicator.Category`	Categoria do indicador de início da transação. Válido para bandeira Mastercard e Hipercard. Valores possíveis: - “C1”: transação inciada pelo portador do cartão; - “M1”: transação recorrente ou parcelada iniciada pela loja; - “M2”: transação iniciada pela loja.	string	2	Condicional. Obrigatório para bandeira Mastercard e Hipercard
`Payment.InitiatedTransactionIndicator.Subcategory`	Subcategoria do indicador. Válido para bandeira Mastercard e Hipercard. Valores possíveis: Se `InitiatedTransactionIndicator.Category` = “C1” ou “M1” CredentialsOnFile StandingOrder Subscription Installment Se `InitiatedTransactionIndicator.Category` = “M2” PartialShipment RelatedOrDelayedCharge NoShow Resubmission Consulte a tabela com a descrição das subcategorias em Indicador de Início da Transação.	string	-	Condicional. Obrigatório para bandeira Mastercard e Hipercard
`Payment.Credentials.Code`	Afiliação gerada pela adquirente.	texto	100	Condicional**
`Payment.Credentials.Key`	Chave de afiliação/token gerado pela adquirente.	texto	100	Condicional**
`Payment.Credentials.Username`	Usuário gerado no credenciamento com a adquirente Getnet (envio obrigatório se a transação é direcionada para Getnet).	texto	50	Condicional**
`Payment.Credentials.Password`	Senha gerada no credenciamento com a adquirente Getnet (envio obrigatório se a transação é direcionada para Getnet).	texto	50	Condicional**
`Payment.Credentials.Signature`	Envio do TerminalID da adquirente Global Payments, ex.: “001”. Para Safra colocar o nome do estabelecimento, cidade e o estado concatenados com ponto-e-vírgula (;), ex.: “NomedaLoja;São Paulo;SP”.	texto	–	Condicional**
`Payment.ExtraDataCollection.Name`	Nome do campo que será gravado como dado extra.	texto	50	Não
`Payment.ExtraDataCollection.Value`	Valor do campo que será gravado como dado extra.	texto	1024	Não

**Obrigatório caso não estejam pré configurados nos meios de pagamento do MerchantID utilizado.

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

Resposta

{
    "MerchantOrderId": "2017051002",
    "Customer": {
       "Name": "Nome do Comprador",
       "Identity": "12345678909",
       "IdentityType": "CPF",
       "Email": "comprador@braspag.com.br",
       "Birthdate": "1991-01-02",
       "Address": {
          "Street": "Alameda Xingu",
          "Number": "512",
          "Complement": "27 andar",
          "ZipCode": "12345987",
          "City": "São Paulo",
          "State": "SP",
          "Country": "BRA",
          "District": "Alphaville"
       },
       "DeliveryAddress": {
          "Street": "Alameda Xingu",
          "Number": "512",
          "Complement": "27 andar",
          "ZipCode": "12345987",
          "City": "São Paulo",
          "State": "SP",
          "Country": "BRA",
          "District": "Alphaville"
    },
    "Payment": {
       "ServiceTaxAmount": 0,
       "Installments": 1,
       "Interest": "ByMerchant",
       "Capture": true,
       "Authenticate": false,
       "Recurrent": false,
       "DoSplit":false,
       "Tip":false,
       "CreditCard": {
          "CardNumber": "455187******0181",
          "Holder": "Nome do Portador",
          "ExpirationDate": "12/2021",
          "SaveCard": false,
          "Brand": "Visa"
          "Alias": "",
          "CardOnFile":{
             "Usage": "Used",
             "Reason":"Unscheduled"
          }
       },
       "InitiatedTransactionIndicator": {
          "Category": "C1",
          "Subcategory": "Standingorder"
       },      
       "Credentials": {
          "Code": "9999999",
          "Key": "D8888888",
          "Password": "LOJA9999999",
          "Username": "#Braspag2018@NOMEDALOJA#"
       },
         "ProofOfSale": "20170510053219433",
         "AcquirerTransactionId": "0510053219433",
         "AuthorizationCode": "936403",
         "SoftDescriptor": "Mensagem",
         "VelocityAnalysis": {
            "Id": "c374099e-c474-4916-9f5c-f2598fec2925",
            "ResultMessage": "Accept",
            "Score": 0
         },
         "PaymentId": "c374099e-c474-4916-9f5c-f2598fec2925",
         "Type": "CreditCard",
         "Amount": 10000,
         "ReceivedDate": "2017-05-10 17:32:19",
         "CapturedAmount": 10000,
         "CapturedDate": "2017-05-10 17:32:19",
         "Currency": "BRL",
         "Country": "BRA",
         "Provider": "Simulado",
         "ExtraDataCollection": [{
             "Name": "NomeDoCampo",
             "Value": "ValorDoCampo"
         }],
         "ReasonCode": 0,
         "ReasonMessage": "Successful",
         "Payment.MerchantAdviceCode":"1",
         "Status": 2,
         "ProviderReturnCode": "6",
         "ProviderReturnMessage": "Operation Successful",
         "Links": [{
                 "Method": "GET",
                 "Rel": "self",
                 "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"
             },
             {
                 "Method": "PUT",
                 "Rel": "void",
                 "Href": "https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"
             }
         ]
     }
 }

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    "MerchantOrderId": "2017051002",
        "Customer": {
            "Name": "Nome do Comprador",
            "Identity": "12345678909",
            "IdentityType": "CPF",
            "Email": "comprador@braspag.com.br",
            "Birthdate": "1991-01-02",
            "Address": {
                "Street": "Alameda Xingu",
                "Number": "512",
                "Complement": "27 andar",
                "ZipCode": "12345987",
                "City": "São Paulo",
                "State": "SP",
                "Country": "BRA",
                "District": "Alphaville"
            },
            "DeliveryAddress": {
                "Street": "Alameda Xingu",
                "Number": "512",
                "Complement": "27 andar",
                "ZipCode": "12345987",
                "City": "São Paulo",
                "State": "SP",
                "Country": "BRA",
                "District": "Alphaville"
        },
        "Payment": {
            "ServiceTaxAmount": 0,
            "Installments": 1,
            "Interest": "ByMerchant",
            "Capture": true,
            "Authenticate": false,
            "Recurrent": false,
            "DoSplit":false,
            "Tip":false,
            "CreditCard": {
                "CardNumber": "455187******0181",
                "Holder": "Nome do Portador",
                "ExpirationDate": "12/2021",
                "SaveCard": false,
                "Brand": "Visa"
                "Alias": "",
             "CardOnFile":{
                "Usage": "Used",
                "Reason":"Unscheduled"
             }
            },
          "InitiatedTransactionIndicator": {
             "Category": "C1",
             "Subcategory": "Standingorder"
          },
            "Credentials": {
                "Code": "9999999",
                "Key": "D8888888",
                "Password": "LOJA9999999",
                "Username": "#Braspag2018@NOMEDALOJA#"
            },
            "ProofOfSale": "20170510053219433",
            "AcquirerTransactionId": "0510053219433",
            "AuthorizationCode": "936403",
            "SoftDescriptor": "Mensagem",
            "VelocityAnalysis": {
                "Id": "c374099e-c474-4916-9f5c-f2598fec2925",
                "ResultMessage": "Accept",
                "Score": 0
            },
            "PaymentId": "c374099e-c474-4916-9f5c-f2598fec2925",
            "Type": "CreditCard",
            "Amount": 10000,
            "ReceivedDate": "2017-05-10 17:32:19",
            "CapturedAmount": 10000,
            "CapturedDate": "2017-05-10 17:32:19",
            "Currency": "BRL",
            "Country": "BRA",
            "Provider": "Simulado",
            "ExtraDataCollection": [{
                "Name": "NomeDoCampo",
                "Value": "ValorDoCampo"
            }],
            "ReasonCode": 0,
            "ReasonMessage": "Successful",
            "Status": 2,
            "ProviderReturnCode": "6",
            "ProviderReturnMessage": "Operation Successful",
            "Links": [{
                    "Method": "GET",
                    "Rel": "self",
                    "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"
                },
                {
                    "Method": "PUT",
                    "Rel": "void",
                    "Href": "https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"
                }
            ]
        }
    }

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`AuthorizationCode`	Código de autorização.	texto	300	texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`CapturedDate`	Data em que a transação foi capturada.	texto	19	AAAA-MM-DD HH:mm:SS
`CapturedAmount`	Valor capturado, sem pontuação.	número	15	100 equivale a R$ 1,00
`ECI`	Electronic Commerce Indicator. Representa o resultado da autenticação.	texto	2	Ex.: 5
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 1
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Transação Aprovada
`Payment.MerchantAdviceCode`	Có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 Bandeiras	texto	2	Numérico

Criando uma Transação de Débito

Uma transação com cartão de débito se efetua de forma semelhante à com cartão de crédito. É obrigatório, porém, submetê-la ao processo de autenticação.

Todas as transações de débito devem ser autenticadas por exigência dos bancos emissores e bandeiras, com o objetivo de promover maior segurança. Para autenticar uma transação de débito, usamos o protocolo EMV 3DS 2.2. Esse protocolo é um script integrado ao website do e-commerce que verifica a identidade do portador do cartão enquanto mantém uma boa experiência de compra ao consumidor e reduz o risco de fraude.

Para integrar o método de autenticação, consulte a documentação do 3DS 2.2.

Veja abaixo a representação de um fluxo transacional padrão na criação de uma transação de débito, com as etapas de autenticação e autorização: Fluxo 3DS 2.2

Transações de débito Mastercard e Hipercard com credenciais armazenadas: a bandeira Mastercard e Hipercard exige o envio do Indicador de Início da Transação para compras de cartão de crédito e débito que usam os dados armazenados de um cartão. O objetivo é indicar se a transação foi iniciada pelo comprador (titular do cartão) ou pela loja. Nesse cenário é obrigatório o envio do nó InitiatedTransactionIndicator com os parâmetros Category e SubCategory para transações Mastercard e Hipercard, dentro do nó Payment. Confira a lista de categorias na descrição do parâmetro Category e a tabela completa de subcategorias em Indicador de Início da Transação.

Requisição

{
    "MerchantOrderId":"202301131052",
    "Customer":{
       "Name":"Nome do Comprador",
       "Identity":"12345678900",
       "IdentityType":"CPF",
       "Email":"comprador@email.com.br",
       "Birthdate":"1991-01-02",
       "IpAddress":"127.0.0.1",
       "Address":{  
          "Street":"Alameda Xingu",
          "Number":"512",
          "Complement":"27 andar",
          "ZipCode":"12345987",
          "City":"São Paulo",
          "State":"SP",
          "Country":"BRA",
          "District":"Alphaville"
       },
       "DeliveryAddress":{  
          "Street":"Alameda Xingu",
          "Number":"512",
          "Complement":"27 andar",
          "ZipCode":"12345987",
          "City":"São Paulo",
          "State":"SP",
          "Country":"BRA",
          "District":"Alphaville"
       }
    },
    "Payment":{
       "DebitCard":{
          "CardNumber":"************1106",
          "Holder":"NOME DO TITULAR DO CARTÃO",
          "ExpirationDate":"12/2030",
          "SaveCard":false,
          "Brand":"Master"      },
       "Authenticate":true,
       "Recurrent":false,
       "ReturnUrl":"https://braspag.com.br",
       "ProofOfSale":"20230113",
       "AcquirerTransactionId":"0510053219433",
       "AuthorizationCode":"936403",
       "Tip":false,
       "ExternalAuthentication":{
          "Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
          "Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
          "Eci":"5",
          "Version":"2",
          "ReferenceId":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"      },
       "InitiatedTransactionIndicator": {
             "Category": "C1",
             "Subcategory": "Standingorder"
          },
       "ExtraDataCollection":[  
          {  
             "Name":"NomeDoCampo",
             "Value":"ValorDoCampo"
       ]
    }
 }

--request POST "https://apisandbox.braspag.com.br/v2/sales"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
--header "MerchantKey: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
--data-binary
--verbose
{
    "MerchantOrderId":"202301131052",
    "Customer":{
       "Name":"Nome do Comprador",
       "Identity":"12345678900",
       "IdentityType":"CPF",
       "Email":"comprador@email.com.br",
       "Birthdate":"1991-01-02",
       "IpAddress":"127.0.0.1",
       "Address":{  
          "Street":"Alameda Xingu",
          "Number":"512",
          "Complement":"27 andar",
          "ZipCode":"12345987",
          "City":"São Paulo",
          "State":"SP",
          "Country":"BRA",
          "District":"Alphaville"
       },
       "DeliveryAddress":{  
          "Street":"Alameda Xingu",
          "Number":"512",
          "Complement":"27 andar",
          "ZipCode":"12345987",
          "City":"São Paulo",
          "State":"SP",
          "Country":"BRA",
          "District":"Alphaville"
       }
    },
    "Payment":{
       "DebitCard":{
          "CardNumber":"************1106",
          "Holder":"NOME DO TITULAR DO CARTÃO",
          "ExpirationDate":"12/2030",
          "SaveCard":false,
          "Brand":"Master"      },
       "Authenticate":true,
       "Recurrent":false,
       "ReturnUrl":"https://braspag.com.br",
       "ProofOfSale":"20230113",
       "AcquirerTransactionId":"0510053219433",
       "AuthorizationCode":"936403",
       "Tip":false,
       "ExternalAuthentication":{
          "Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
          "Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
          "Eci":"5",
          "Version":"2",
          "ReferenceId":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"      },
       "InitiatedTransactionIndicator": {
             "Category": "C1",
             "Subcategory": "Standingorder"
          },
       "ExtraDataCollection":[  
          {  
             "Name":"NomeDoCampo",
             "Value":"ValorDoCampo"
       ]
    }
 }

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento. Clique aqui para acessar a lista de provedores. Obs.: Atualmente somente a Cielo suporta esta forma de pagamento via Pagador.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Neste caso, “DebitCard”.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.ReturnUrl`	URL para onde o usuário será redirecionado após o fim do pagamento.	texto	1024	Sim
`Payment.Tip`	As gorjetas são um tipo de transação que funcionam para cartão de crédito ou débito, tokenizados ou não. Se o valor for true, a transação é identificada como gorjeta, caso contrário, o valor deverá ser false.	booleano	—	Não (default “false”)
`Payment.DebitCard.CardNumber`	Número do cartão do comprador.	texto	16	Sim
`Payment.DebitCard.Holder`	Nome do comprador impresso no cartão.	texto	25	Sim
`Payment.DebitCard.ExpirationDate`	Data de validade impresso no cartão, no formato MM/AAAA.	texto	7	Sim
`Payment.DebitCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`Payment.DebitCard.Brand`	Bandeira do cartão.	texto	10	Sim
`Payment.DebitCard.CardOnFile.Usage`	“First” se o cartão foi armazenado e é seu primeiro uso. “Used” se o cartão foi armazenado e já utilizado em outra transação. Aplicável somente para Cielo.	texto	-	Não
`Payment.DebitCard.CardOnFile.Reason`	Indica o propósito de armazenamento de cartões, caso o campo `Usage` seja “Used”. “Recurring” - Compra recorrente programada, ex.: assinaturas. “Unscheduled” - Compra recorrente sem agendamento, ex.: aplicativos de serviços. “Installments” - Parcelamento através da recorrência. Aplicável somente para Cielo.	texto	-	Condicional
`Payment.Authenticate`	Define se o comprador será direcionado ao emissor para autenticação do cartão.	booleano (“true” / “false”)	-	Sim, caso a autenticação seja validada.
`Payment.ExternalAuthentication.ReturnUrl`	URL de retorno aplicável somente se a versão for “1”.	alfanumérico	1024	Sim.
`Payment.ExternalAuthentication.Cavv`	Assinatura retornada nos cenários de sucesso na autenticação.	texto	28	Sim, caso a autenticação seja validada.
`Payment.ExternalAuthentication.Xid`	XID retornado no processo de autenticação.	texto	28	Sim, quando a versão do 3DS for “1”.
`Payment.ExternalAuthentication.Eci`	Electronic Commerce Indicator retornado no processo de autenticação.	número	1	Sim.
`Payment.ExternalAuthentication.Version`	Versão do 3DS utilizado no processo de autenticação.	alfanumérico	1 posição	Sim, quando a versão do 3DS for “2” ou maior.
`Payment.ExternalAuthentication.ReferenceId`	RequestID retornado no processo de autenticação.	GUID	36	Sim, quando a versão do 3DS for “2” ou maior.
`Payment.InitiatedTransactionIndicator.Category`	Categoria do indicador de início da transação. Válido para bandeira Mastercard e Hipercard. Valores possíveis: - “C1”: transação inciada pelo portador do cartão; - “M1”: transação recorrente ou parcelada iniciada pela loja; - “M2”: transação iniciada pela loja.	string	2	Condicional. Obrigatório para bandeira Mastercard e Hipercard
`Payment.InitiatedTransactionIndicator.Subcategory`	Subcategoria do indicador. Válido para bandeira Mastercard e Hipercard. Valores possíveis: Se `InitiatedTransactionIndicator.Category` = “C1” ou “M1” CredentialsOnFile StandingOrder Subscription Installment Se `InitiatedTransactionIndicator.Category` = “M2” PartialShipment RelatedOrDelayedCharge NoShow Resubmission Consulte a tabela com a descrição das subcategorias em Indicador de Início da Transação.	string	-	Condicional. Obrigatório para bandeira Mastercard e Hipercard

Resposta

{
    "MerchantOrderId": "2017051002",
    "Customer": {
       "Name": "Nome do Comprador",
       "Identity": "12345678909",
       "IdentityType": "CPF",
       "Email": "comprador@braspag.com.br",
       "Birthdate": "1991-01-02",
       "Address": {
          "Street": "Alameda Xingu",
          "Number": "512",
          "Complement": "27 andar",
          "ZipCode": "12345987",
          "City": "São Paulo",
          "State": "SP",
          "Country": "BRA",
          "District": "Alphaville"
       },
       "DeliveryAddress": {
          "Street": "Alameda Xingu",
          "Number": "512",
          "Complement": "27 andar",
          "ZipCode": "12345987",
          "City": "São Paulo",
          "State": "SP",
          "Country": "BRA",
          "District": "Alphaville"
    },
    "Payment": {
       "DebitCard": {
          "CardNumber": "455187******0181",
          "Holder": "NOME DO TITULAR DO CARTÃO",
          "ExpirationDate": "12/2031",
          "SaveCard": false,
          "Brand": "Visa"     },
      "Authenticate":true,
      "Recurrent":false,
      "ReturnUrl":"http://www.braspag.com.br",
      "ProofOfSale":"20230115053219433",
      "AcquirerTransactionId":"10069930690009D366FA",
      "AuthorizationCode":"936403",
      "Tip":false,
      "SentOrderId":"10045146",
      "ExternalAuthentication":{
         "Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
         "Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
         "Eci":"02",
         "Version":"2",
         "ReferenceId":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"      },
      "PaymentId":"21423fa4-6bcf-448a-97e0-e683fa2581b",
      "Type":"DebitCard",
      "Amount":10000,
      "ReceivedDate":"2023-01-09 16:24:14",
      "CapturedAmount":10000,
      "CapturedDate":"2023-01-09 16:24:15",
      "Currency":"BRL",
      "Country":"BRA",
      "Provider":"Cielo",
      "InitiatedTransactionIndicator": {
            "Category": "C1",
            "Subcategory": "Standingorder"
         },
      "ExtraDataCollection":[
         {
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"         }
      ],
      "ReasonCode":0,
      "ReasonMessage":"Successful",
      "Status":2,
      "ProviderReturnCode":"00",
      "ProviderReturnMessage":"Successful",
      "Links":[
         {
            "Method":"GET",
            "Rel":"self",
            "Href":"https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"         },
         {
            "Method":"PUT",
            "Rel":"void",
            "Href":"https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"         }
      ]
   }
}
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    "MerchantOrderId": "2017051002",
    "Customer": {
       "Name": "Nome do Comprador",
       "Identity": "12345678909",
       "IdentityType": "CPF",
       "Email": "comprador@braspag.com.br",
       "Birthdate": "1991-01-02",
       "Address": {
          "Street": "Alameda Xingu",
          "Number": "512",
          "Complement": "27 andar",
          "ZipCode": "12345987",
          "City": "São Paulo",
          "State": "SP",
          "Country": "BRA",
          "District": "Alphaville"
       },
       "DeliveryAddress": {
          "Street": "Alameda Xingu",
          "Number": "512",
          "Complement": "27 andar",
          "ZipCode": "12345987",
          "City": "São Paulo",
          "State": "SP",
          "Country": "BRA",
          "District": "Alphaville"
    },
    "Payment": {
       "DebitCard": {
          "CardNumber": "455187******0181",
          "Holder": "NOME DO TITULAR DO CARTÃO",
          "ExpirationDate": "12/2031",
          "SaveCard": false,
          "Brand": "Visa"     },
      "Authenticate":true,
      "Recurrent":false,
      "ReturnUrl":"http://www.braspag.com.br",
      "ProofOfSale":"20230115053219433",
      "AcquirerTransactionId":"10069930690009D366FA",
      "AuthorizationCode":"936403",
      "Tip":false,
      "SentOrderId":"10045146",
      "ExternalAuthentication":{
         "Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
         "Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
         "Eci":"02",
         "Version":"2",
         "ReferenceId":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"      },
      "PaymentId":"21423fa4-6bcf-448a-97e0-e683fa2581b",
      "Type":"DebitCard",
      "Amount":10000,
      "ReceivedDate":"2023-01-09 16:24:14",
      "CapturedAmount":10000,
      "CapturedDate":"2023-01-09 16:24:15",
      "Currency":"BRL",
      "Country":"BRA",
      "Provider":"Cielo",
      "InitiatedTransactionIndicator": {
            "Category": "C1",
            "Subcategory": "Standingorder"
         },
      "ExtraDataCollection":[
         {
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"         }
      ],
      "ReasonCode":0,
      "ReasonMessage":"Successful",
      "Status":2,
      "ProviderReturnCode":"00",
      "ProviderReturnMessage":"Successful",
      "Links":[
         {
            "Method":"GET",
            "Rel":"self",
            "Href":"https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"         },
         {
            "Method":"PUT",
            "Rel":"void",
            "Href":"https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"         }
      ]
   }
}
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`AuthorizationCode`	Código de autorização.	texto	300	texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	Texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 1
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	Ex.: 57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Ex.: Transação Aprovada
`Payment.MerchantAdviceCode`	Código de retorno da bandeira que define período para retentativa. Válido para bandeira Mastercard e Hipercard.	texto	2	numérico
`Payment.ExternalAuthentication.Cavv`	Valor Cavv submetido na requisição de autorização.	texto	28	kBMaEAEAbV3FcwnExrXh4phhmpIj
`Payment.ExternalAuthentication.Xid`	Valor Xid submetido na requisição de autorização.	texto	28	ZGUzNzgwYzQxM2ZlMWMxMzVkMjc=
`Payment.ExternalAuthentication.Eci`	Valor ECI submetido na requisição de autorização.	número	1	Ex. 5
`Payment.ExternalAuthentication.Version`	Versão do 3DS utilizado no processo de autenticação.	alfanumérico	1	Ex: 2
`Payment.ExternalAuthentication.ReferenceId`	RequestID retornado no processo de autenticação.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Criando uma Transação de Débito sem Autenticação

É possível processar um cartão de débito sem a necessidade de submeter o comprador ao processo de autenticação. Confira o artigo Débito sem Senha (Autenticação) para mais detalhes a respeito desse tipo de transação.Este é o caso do auxílio emergencial “Coronavoucher”, disponibilizado pelo governo, que pode ser consumido através do cartão de débito virtual da Caixa Econômica Federal. Desta forma, a requisição deverá ser do tipo Cartão de Débito, porém sem autenticação, conforme o exemplo abaixo.

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
      "Payment": {
         "Provider": "Cielo30",
         "Type": "DebitCard",
         "Amount": 10000,
         "Currency": "BRL",
         "Country": "BRA",
         "Installments": 1,
         "Capture": true,
         "Authenticate": false,
         "DebitCard":{
            "CardNumber":"5067220000000001",
            "Holder":"Nome do Portador",
            "ExpirationDate":"12/2021",
            "SecurityCode":"123",
            "Brand":"Elo"
            "CardOnFile":{
              "Usage": "Used",
              "Reason":"Unscheduled"
        },
        [...]
    }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider": "Cielo30",
      "Type": "DebitCard",
      "Amount": 10000,
      "Currency": "BRL",
      "Country": "BRA",
      "Installments": 1,
      "Capture": true,
      "Authenticate": false,
      "DebitCard":{
         "CardNumber":"5067220000000001",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Elo"
         "CardOnFile":{
           "Usage": "Used",
           "Reason":"Unscheduled"         
      },
      [...]
   }
}

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento. Obs.: Disponível apenas para Cielo30.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Neste caso, “DebitCard”.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas. Fixo “1” para o cartão de débito.	número	2	Sim
`Payment.DebitCard.CardNumber`	Número do cartão do comprador.	texto	16	Sim
`Payment.DebitCard.Holder`	Nome do comprador impresso no cartão.	texto	25	Sim
`Payment.DebitCard.ExpirationDate`	Data de validade impresso no cartão, no formato MM/AAAA.	texto	7	Sim
`Payment.Payment.DebitCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`Payment.DebitCard.Brand`	Bandeira do cartão. Para este tipo de transação, sempre “Elo”.	texto	10	Sim
`Payment.DebitCard.CardOnFile.Usage`	“First” se o cartão foi armazenado e é seu primeiro uso. “Used” se o cartão foi armazenado e já utilizado em outra transação. Aplicável somente para Cielo.	texto	-	Não
`Payment.DebitCard.CardOnFile.Reason`	Indica o propósito de armazenamento de cartões, caso o campo `Usage` seja “Used”. “Recurring” - Compra recorrente programada, ex.: assinaturas. “Unscheduled” - Compra recorrente sem agendamento, ex.: aplicativos de serviços. “Installments” - Parcelamento através da recorrência. Aplicável somente para Cielo.	texto	-	Condicional

Resposta

{
 [...]
  "Payment": {
    "DebitCard": {
      "CardNumber": "506722******0001",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": false,
      "Brand": "Elo"
      "CardOnFile":{
        "Usage": "Used",
        "Reason":"Unscheduled"
    },
    "AcquirerTransactionId": "10069930690009D366FA",
    "PaymentId": "21423fa4-6bcf-448a-97e0-e683fa2581ba",
    "Type": "DebitCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 15:19:58",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Cielo30",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Payment.MerchantAdviceCode":"1",
    "Status": 2,
    "ProviderReturnCode": "6",
    "ProviderReturnMessage": "Operation Successful",
    [...]
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
 [...]
  "Payment": {
    "DebitCard": {
      "CardNumber": "506722******0001",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": false,
      "Brand": "Elo"
      "CardOnFile":{
        "Usage": "Used",
        "Reason":"Unscheduled"
    },
    "AcquirerTransactionId": "10069930690009D366FA",
    "PaymentId": "21423fa4-6bcf-448a-97e0-e683fa2581ba",
    "Type": "DebitCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 15:19:58",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Cielo30",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Payment.MerchantAdviceCode":"1",
    "Status": 2,
    "ProviderReturnCode": "6",
    "ProviderReturnMessage": "Operation Successful",
    [...]
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`AuthorizationCode`	Código de autorização.	Texto	300	texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	Texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	Texto	512	texto alfanumérico
`Status`	Status da transação. Clique aqui para ver lista de status.	byte	2	Ex.: 1
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	Ex.: 57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Ex.: Transação Aprovada
`Payment.MerchantAdviceCode`	Código de retorno da bandeira que define período para retentativa. Válido para bandeira Mastercard e Hipercard.	texto	2	numérico

Autenticação 3DS

O que é?

É um protocolo de autenticação que confirma se o comprador é de fato o portador do cartão (de crédito ou débito). O objetivo do 3DS (também chamado de EMV 3DS) é evitar fraudes em transações de cartão não presente (CNP).

Por meio do 3DS, os dados do comprador são enviados para as bandeiras e emissores do cartão, que irão realizar a autenticação. Para uma transação autenticada pelo 3DS, a responsabilidade em caso de chargeback será das bandeiras ou emissores.

Todas as transações de cartão de débito devem ser autenticadas pelo protocolo 3DS.

Qual é o objetivo?

O 3DS realiza a autenticação validando dados do portador. A autenticação pode ser silenciosa ou com desafio (o desafio é uma interface para autenticação, ou seja, o cliente será submetido a uma validação adicional do emissor).

Qual é o impacto do uso no meu negócio?

Ao autenticar transações pelo protocolo 3DS, a responsabilidade em caso de chargeback será das bandeiras ou emissores.

Como usar o 3DS?

O processo de autorização de cartão autenticada via 3D Secure 2.2 ocorre em duas etapas:

Etapa de autenticação: por meio do protocolo 3DS, a bandeira ou o emissor autentica que o comprador é de fato o titular do cartão. O protocolo é integrado ao e-commerce por meio de um script em JavaScript, que retorna o resultado da autenticação e alguns parâmetros (como o ECI) que devem ser enviados na autorização. Saiba mais em Integração do script;
Etapa de autorização: a loja submete a transação para autorização, informando os parâmetros retornados pelo script na etapa de autenticação. Saiba mais em Autorização com Autenticação.

O fluxo a seguir descreve as etapas de autenticação em alto nível:

Fluxo 3DS 2.2

1. O comprador escolhe pagar com cartão de crédito ou débito;
2. A loja executa um script, solicitando à Cielo autenticação através da solução 3DS 2.2;
3. A loja envia requisição com dados do comprador para a bandeira;
4. A bandeira envia a requisição para avaliação de risco do emissor;
5. O emissor avalia as informações e determina se fluxo será com ou sem desafio ao portador;
5.1. Se o emissor solicitar desafio, cria e envia a URL para a loja;
5.2. A loja apresenta lightbox do desafio na página de checkout para obter resposta do comprador;
5.3. O comprador responde o desafio, completando a autenticação;
6. O emissor envia o resultado da autenticação para o 3DS Server;
7. O 3DS Server envia resultado da autenticação no campo ECI. A loja decide seguir ou não para autorização.

A loja pode optar por submeter uma transação não autenticada para autorização; no entanto, nesse caso, a loja será responsável em caso de chargeback.

Como não utilizar? O que não fazer?

Não realizar transações de débito sem autenticação ou utilização de senha;
Não realizar transações de débito sem CVV.

Como saber se a transação foi autenticada?

Isso irá depender do resultado da Tabela de ECI.

Detalhes importantes

O ECI (Eletronic Commerce Indicator) retornado na resposta da autenticação indica se o portador foi autenticado ou não pela bandeira ou emissor.

Se o ECI retornado indicar que o portador não foi autenticado, recomendamos a utilização de Antifraude para analisar o risco da transação.

Caso a loja envie suas transações primeiro para o Antifraude e a análise indique alto risco, recomendamos que o pedido seja encaminhado para autenticação no 3DS 2.2.

Integração do 3DS 2.2

Para integrar a autenticação às suas transações:

Integre o script do 3DS 2.2 na sua página de pagamento, conforme manual do 3DS;
Na requisição das transações de crédito ou débito, envie o nó adicional ExternalAuthentication, conforme exemplos a seguir.

Acesse o padrão mais atual do autenticador em 3DS 2.2, sendo que a versão 3DS 1.0 foi descontinuada.

Indicador de início da transação Mastercard e Hipercard

As tabelas a seguir se aplicam para transações de crédito e débito Mastercard/Hipercard com credenciais armazenadas. O objetivo é identificar se a transação foi iniciada pelo titular do cartão ou pela loja:

Cardholder-Initiated Transaction (CIT): a transação é iniciada pela pessoa titular do cartão, que fornece suas credenciais de pagamento e permite que sejam armazenadas;
Merchant-Initiated Transaction (MIT): a transação é iniciada pela loja, após um acordo no qual a pessoa titular do cartão autoriza a loja a armazenar e usar os dados de sua conta para iniciar uma ou mais transações futuras (como pagamentos recorrentes, pagamentos parcelados e cobranças posteriores, como as praticadas pelo setor de hospitalidade e turismo, por exemplo).

Para indicar o iniciador de transação, é obrigatório enviar o nó Payment.InitiatedTransactionIndicator. Este nó tem dois parâmetros, categoria (Category) e subcategoria (Subcategory); confira a seguir o exemplo do nó na requisição e as tabelas com os valores correspondentes:

Requisição

   "Payment":{
     (...)
    "InitiatedTransactionIndicator": {
        "Category": "C1",
        "Subcategory": "Standingorder"
    },
    (...)
   }

   "Payment":{
     (...)
    "InitiatedTransactionIndicator": {
        "Category": "C1",
        "Subcategory": "Standingorder"
    },
    (...)
   }

Confira o exemplo de requisição completa em Criando uma transação de crédito ou em Criando uma transação de débito.

Parâmetro	Tipo	Tamanho	Obrigatório?	Descrição
`Payment.InitiatedTransactionIndicator.Category`	string	2	Condicional. Obrigatório para as bandeira Mastercard e Hipercard.	Categoria do indicador de início da transação. Válido para bandeira Mastercard e Hipercard. Valores possíveis: - “C1”: transação inciada pelo portador do cartão; - “M1”: transação recorrente ou parcelada iniciada pela loja; - “M2”: transação iniciada pela loja.
`Payment.InitiatedTransactionIndicator.Subcategory`	string	-	Condicional. Obrigatório para as bandeira Mastercard e Hipercard.	Subcategoria do indicador. Válido para bandeira Mastercard e Hipercard. Valores possíveis: Se `InitiatedTransactionIndicator.Category` = “C1” ou “M1” CredentialsOnFile StandingOrder Subscription Installment Se `InitiatedTransactionIndicator.Category` = “M2” PartialShipment RelatedOrDelayedCharge NoShow Resubmission Consulte a tabela com a descrição das subcategorias em Indicador de início da transação.

Resposta

A resposta será o padrão da transação de crédito ou débito com o retorno do mesmo nó inserido na requisição.

Tabelas do indicador de início da transação Mastercard e Hipercard

Categorias CIT e MIT

As categorias (C1, M1 ou M2) devem ser informadas no parâmetro Payment.InitiatedTransactionIndicator.Category.

Categoria	Quem iniciou a transação	Descrição
`C1`	Transação iniciada pelo portador do cartão (CIT).	A transação é iniciada pela pessoa titular do cartão, que fornece os dados do cartão e permite o armazenamento ou usa os dados do cartão armazenado previamente. A subcategoria indica a finalidade da compra/armazenamento do cartão.
`M1`	Transação iniciada pela loja (MIT).	A loja já tem os dados do cartão do comprador armazenados de forma criptografada (com o consentimento do titular do cartão) e a autorização para iniciar uma ou mais transações futuras de compras recorrentes ou parceladas.
`M2`	Transação iniciada pela loja (MIT).	A loja já tem os dados do cartão do comprador armazenados de forma criptografada (com o consentimento do titular do cartão) e a autorização para iniciar uma ou mais transações futuras, relacionadas a remessa parcial, cobranças atrasadas/adicionais, multas por no-show e retentativas.

Subcategorias CIT e MIT

As subcategorias devem ser informadas no parâmetro Payment.InitiatedTransactionIndicator.Subcategory.

Categoria do indicador	Subcategoria do indicador	Significado	Exemplo
C1	`CredentialsOnFile`	É uma transação iniciada pelo comprador (CIT), na qual o comprador autoriza a loja a salvar dados do cartão para compras futuras, ou na qual usa dados de cartão previamente armazenados pela loja.	Quando o titular do cartão inicia uma compra e a loja solicita autorização para salvar os dados do cartão para futuras compras iniciadas pelo titular do cartão, como compra com um clique.
C1	`StandingOrder`	É uma transação iniciada pelo comprador (CIT), na qual o comprador autoriza a loja a salvar dados do cartão para pagamentos futuros de valor variável e frequência fixa.	Quando é uma transação inicial para armazenar os dados do cartão para um pagamento mensal de serviços públicos.
C1	`Subscription`	É uma transação iniciada pelo comprador (CIT), na qual o comprador autoriza a loja a salvar dados do cartão para compras recorrentes de valor e frequência fixos.	Quando é uma transação inicial para armazenar os dados do cartão para uma assinatura mensal, como jornais, revistas e cursos.
C1	`Installment`	É uma transação iniciada pelo comprador (CIT), na qual o comprador inicia a transação da primeira parcela e autoriza a loja a salvar dados do cartão para pagamento das parcelas seguintes.	Quando é uma transação inicial para armazenar os dados do cartão para uma compra a ser paga por meios de pagamentos parcelados.
M1	`CredentialsOnFile`	São transações iniciadas pela loja (MIT), de valor fixo ou variável e sem intervalo fixo ou data programada.	Quando o consumidor permite que uma concessionária inicie transações de cobrança de pedágio quando o saldo em sua conta estiver abaixo de uma quantia estabelecida (auto recarga).
M1	`StandingOrder`	São transações iniciadas pela loja (MIT), de valor variável e intervalo fixo.	Pagamentos mensais de serviços públicos.
M1	`Subscription`	São transações iniciadas pela loja (MIT), de valor e intervalo fixos.	Assinatura mensal ou pagamento de serviço mensal fixo.
M1	`Installment`	São transações iniciadas pela loja (MIT), de valor conhecido e período definido.	Quando o consumidor compra uma televisão por R$2000,00 e faz o pagamento em quatro parcelas iguais de R$500,00; nesse cenário, a primeira transação é iniciada pelo titular do cartão (CIT) e as três transações restantes são iniciadas pela loja (MIT).
M2	`PartialShipment`	São transações iniciadas pela loja (MIT) quando a compra será dividida em mais de uma remessa de entrega.	Quando uma quantidade acordada de mercadorias encomendadas por e-commerce não está disponível para envio no momento da compra - cada remessa é uma transação separada.
M2	`RelatedOrDelayedCharge`	São transações iniciadas pela loja (MIT) para despesas adicionais, ou seja, é uma cobrança adicional da conta após a prestação dos serviços iniciais e o processamento do pagamento.	Quando um hotel faz uma cobrança do frigobar do após o titular do cartão fazer check-out do hotel.
M2	`NoShow`	São transações iniciadas pela loja (MIT) para cobrar multas de acordo com a política de cancelamento do estabelecimento.	Quando o comprador cancela uma reserva sem aviso prévio adequado ao estabelecimento.
M2	`Resubmission`	São transações iniciadas pela loja (MIT) como retentativa de transações negadas anteriormente, ou seja, quando a tentativa anterior de obter autorização para uma transação foi recusada, mas a resposta do emissor não proíbe a loja de tentar novamente mais tarde.	Quando o retorno do emissor/bandeira indica fundos insuficientes/resposta acima do limite de crédito.

Atenção: Os dados do cartão são armazenados de forma criptografada.

Capturando uma Transação

Quando uma transação é submetida com o parâmetro Payment.Capture igual a “false”, é necessário que seja feita, posteriormente, uma solicitação de captura para confirmar a transação.

Transações que não são capturadas até a data limite são automaticamente desfeitas pelas adquirentes. Clientes podem ter negociações específicas com as adquirentes para que alterem esse prazo limite de captura.

Requisição

--request PUT "https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/capture?amount=xxx&serviceTaxAmount=xxx"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`PaymentId`	Campo identificador do pedido.	GUID	36	Sim (envio no endpoint)
`Amount`	Valor a ser capturado, em centavos. Verificar se a adquirente utilizada suporta uma captura parcial. Caso não seja especificado um valor, a captura será total.	número	15	Não
`ServiceTaxAmount`	Aplicável para companhias aéreas. Montante do valor da autorização que deve ser destinado à taxa de serviço. Obs.: Esse valor não é adicionado ao valor da autorização.	número	15	Não

Resposta

{
    "Status": 2,
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "ProviderReturnCode": "6",
    "ProviderReturnMessage": "Operation Successful",
    "Links": [
        {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
        },
        {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/void"
        }
    ]
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    "Status": 2,
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "ProviderReturnCode": "6",
    "ProviderReturnMessage": "Operation Successful",
    "Links": [
        {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
        },
        {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/void"
        }
    ]
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`Status`	Status da transação. Clique aqui para ver lista de status.	byte	2	Ex.: 1
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico

Cancelando/Estornando uma Transação

A disponibilidade do serviço de estorno varia de adquirente para adquirente. Cada adquirente tem seus prazos-limites para permitir o estorno de uma transação. Neste artigo você poderá conferir cada um deles.

Para cancelar uma transação de cartão de crédito, é necessário o envio de mensagem HTTP através do método PUT para o recurso Payment, conforme o exemplo:

Requisição

--request PUT "https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/void?amount=xxx"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`PaymentId`	Campo identificador do pedido.	GUID	36	Sim (envio no endpoint)
`Amount`	Valor, em centavos, a ser cancelado/estornado. Observações.: 1. Verifique se a adquirente contratada suporta a operação de cancelamento ou estorno. 2. Caso o valor de `Amount` seja informado como “0” (zero), ou esse parâmetro não seja enviado, será considerado um estorno total do valor capturado.	número	15	Não (envio no endpoint)

Resposta

{
    "Status": 10,
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "ProviderReturnCode": "9",
    "ProviderReturnMessage": "Operation Successful",
    "Links": [
        {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
        }
    ]
}

{
    "Status": 10,
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "ProviderReturnCode": "9",
    "ProviderReturnMessage": "Operation Successful",
    "Links": [
        {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
        }
    ]
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`Status`	Status da transação. Clique aqui para ver lista de status.	byte	2	Ex.: 1
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	Texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	Texto alfanumérico

Analisando com Velocity Check

O Velocity Check é uma ferramenta de combate a fraudes massivas, que disparam rajadas de transações com dados de pagamento repetidos. A ferramenta analisa a frequência de elementos de rastreabilidade, tais como Número do Cartão, CPF, CEP de entrega, entre outros, bloqueando transações suspeitas.

A funcionalidade deve ser contratada à parte, e posteriormente habilitada em sua loja via painel. Quando o Velocity está ativo, a resposta da transação traz o nó Velocity com os detalhes da análise.

No caso da rejeição pela regra de Velocity, o ProviderReasonCode será “BP 171 - Rejected by fraud risk” (Velocity, com “ReasonCode 16 - AbortedByFraud”).

Resposta

{
    [...]
    "VelocityAnalysis": {
        "Id": "2d5e0463-47be-4964-b8ac-622a16a2b6c4",
        "ResultMessage": "Reject",
        "Score": 100,
        "RejectReasons": [
        {
            "RuleId": 49,
            "Message": "Bloqueado pela regra CardNumber. Name: Máximo de 3 Hits de Cartão em 1 dia. HitsQuantity: 3. HitsTimeRangeInSeconds: 1440. ExpirationBlockTimeInSeconds: 1440"
        }]
    [...]
  }
}

{
    [...]
    "VelocityAnalysis": {
        "Id": "2d5e0463-47be-4964-b8ac-622a16a2b6c4",
        "ResultMessage": "Reject",
        "Score": 100,
        "RejectReasons": [
        {
            "RuleId": 49,
            "Message": "Bloqueado pela regra CardNumber. Name: Máximo de 3 Hits de Cartão em 1 dia. HitsQuantity: 3. HitsTimeRangeInSeconds: 1440. ExpirationBlockTimeInSeconds: 1440"
        }]
    [...]
  }
}

Propriedade	Descrição	Tipo	Tamanho
`VelocityAnalysis.Id`	Identificador da análise efetuada.	GUID	36
`VelocityAnalysis.ResultMessage`	Resultado da análise feita (“Accept” / “Reject”).	texto	25
`VelocityAnalysis.Score`	Número de pontos dado à operação. Ex.: 100.	número	10

Utilizando o DCC (Conversor de Moedas)

O DCC (Dynamic Currency Conversion) é um conversor de moedas da adquirente Global Payments que permite que o portador de um cartão estrangeiro escolha entre pagar em reais ou em sua moeda local, convertendo o valor do pedido no momento da compra com total transparência para o comprador. A solução é indicada para estabelecimentos que recebem pagamentos com cartões emitidos no exterior como hotéis, pousadas, polos comerciais e comércios em pontos turísticos.

Quando o estabelecimento possui o produto DCC habilitado, o processo de autorização é realizado em 3 etapas, explicadas a seguir:

ETAPA 1 - Autorização

Na primeira etapa, quando é solicitada uma autorização com um cartão internacional, a Global Payments identifica o país do cartão e aplica a conversão de moeda seguindo os cálculos específicos de cada bandeira, retornando as informações de conversão em seguida.

Requisição

Não há diferença entre uma requisição de autorização padrão e uma de DCC.

Resposta

{
    [...]
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "123412******1234",
            "Holder": "Comprador Teste",
            "ExpirationDate": "12/2022",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "ReturnUrl": "http://www.braspag.com.br/",
        "PaymentId": "fa0c3119-c730-433a-123a-a3b6dfaaad67",
        "Type": "CreditCard",
        "Amount": 100,
        "ReceivedDate": "2018-08-23 10:46:25",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "GlobalPayments",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 12,
        "ProviderReturnCode": "0",
        "ProviderReturnMessage": "Transação autorizada",
        "CurrencyExchangeData": {
            "Id": "fab6f3a752d700af1d50fdd19987b95df497652b",
            "CurrencyExchanges": [{
                    "Currency": "EUR",
                    "ConvertedAmount": 31,
                    "ConversionRate": 3.218626,
                    "ClosingDate": "2017-03-09T00:00:00"
                },
                {
                    "Currency": "BRL",
                    "ConvertedAmount": 100
                }
            ]
        },
        [...]
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    [...]
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "123412******1234",
            "Holder": "Comprador Teste",
            "ExpirationDate": "12/2022",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "ReturnUrl": "http://www.braspag.com.br/",
        "PaymentId": "fa0c3119-c730-433a-123a-a3b6dfaaad67",
        "Type": "CreditCard",
        "Amount": 100,
        "ReceivedDate": "2018-08-23 10:46:25",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "GlobalPayments",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 12,
        "ProviderReturnCode": "0",
        "ProviderReturnMessage": "Transação autorizada",
        "CurrencyExchangeData": {
            "Id": "fab6f3a752d700af1d50fdd19987b95df497652b",
            "CurrencyExchanges": [{
                    "Currency": "EUR",
                    "ConvertedAmount": 31,
                    "ConversionRate": 3.218626,
                    "ClosingDate": "2017-03-09T00:00:00"
                },
                {
                    "Currency": "BRL",
                    "ConvertedAmount": 100
                }
            ]
        }
        [...]
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	Texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	Texto alfanumérico
`AuthorizationCode`	Código de autorização.	texto	300	Texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da operação.	texto	32	Texto alfanumérico
`ReasonMessage`	Mensagem de retorno da operação.	texto	512	Texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 12
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Transação Aprovada
`CurrencyExchangeData.Id`	Id da ação da troca de moeda.	Texto	50	1b05456446c116374005602dcbaf8db8879515a0
`CurrencyExchangeData.CurrencyExchanges.Currency`	Moeda local do comprador/cartão de crédito.	numérico	4	EUR
`CurrencyExchangeData.CurrencyExchanges.ConvertedAmount`	Valor convertido.	numérico	12	23
`CurrencyExchangeData.CurrencyExchanges.ConversionRate`	Taxa de conversão.	numérico	9	3.218626
`CurrencyExchangeData.CurrencyExchanges.ClosingDate`	Data de finalização da transação.	texto	19	AAAA-MM-DD HH:mm:SS
`CurrencyExchangeData.CurrencyExchanges.Currency`	Código da moeda “real”.	texto	3	BRA
`CurrencyExchangeData.CurrencyExchanges.ConvertedAmount`	Valor do pedido em reais.	numérico	12	100

ETAPA 2 - Opção de Pagamento

Na segunda etapa, o sistema da loja apresenta ao comprador as opções de pagar em reais ou com a moeda de seu país (moeda do cartão de crédito), seguindo as melhores práticas solicitadas pela bandeira. O texto é apresentado em inglês e o layout do site não precisa ser alterado, desde que as opções de escolha da moeda tenham as mesmas características de fonte, cor e dimensões.

Na tela da Global Payments são exibidas as opções de pagamento (em reais ou na moeda do cartão), ao lado de um resumo com os dados da compra.

ETAPA 3 - Confirmação

Na terceira etapa, o sistema da loja envia a confirmação da transação com as informações da moeda escolhida pelo comprador. Neste ponto é retornada a resposta da autorização.

Segue um exemplo de confirmação da transação com a moeda escolhida pelo comprador:

Requisição

{  
  "Id":"1b05456446c116374005602dcbaf8db8879515a0",
  "Currency":"EUR",
  "Amount":23
}

--request PUT " https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/confirm"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
  "Id":"1b05456446c116374005602dcbaf8db8879515a0",
  "Currency":"EUR",
  "Amount":23
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Id`	Id da ação da troca de moeda.	texto	50	Sim
`Currency`	Moeda selecionada pelo comprador.	numérico	4	Sim
`Amount`	Valor convertido.	numérico	12	Sim

Resposta

{
   [...]
   "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": false,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "123412******1234",
            "Holder": "TesteDcc",
            "ExpirationDate": "12/2022",
            "SecurityCode": "***",
            "Brand": "Visa"
        },
        "ProofOfSale": "20170510053219433",
        "AcquirerTransactionId": "0510053219433",
        "AuthorizationCode": "936403",
        "SoftDescriptor": "Mensagem",
        "PaymentId": "fa0c3119-c730-433a-123a-a3b6dfaaad67",
        "Type": "CreditCard",
        "Amount": 23,
        "ReceivedDate": "2017-05-10 17:32:19",
        "CapturedAmount": 23,
        "CapturedDate": "2017-05-10 17:32:19",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "GlobalPayments",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 2,
        "ProviderReturnCode": "6",
        "ProviderReturnMessage": "Operation Successful",
        [...]
    }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
   [...]
   "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": false,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "123412******1234",
            "Holder": "TesteDcc",
            "ExpirationDate": "12/2022",
            "SecurityCode": "***",
            "Brand": "Visa"
        },
        "ProofOfSale": "20170510053219433",
        "AcquirerTransactionId": "0510053219433",
        "AuthorizationCode": "936403",
        "SoftDescriptor": "Mensagem",
        "PaymentId": "fa0c3119-c730-433a-123a-a3b6dfaaad67",
        "Type": "CreditCard",
        "Amount": 23,
        "ReceivedDate": "2017-05-10 17:32:19",
        "CapturedAmount": 23,
        "CapturedDate": "2017-05-10 17:32:19",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "GlobalPayments",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 2,
        "ProviderReturnCode": "6",
        "ProviderReturnMessage": "Operation Successful",
        [...]
    }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	Texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	Texto alfanumérico
`AuthorizationCode`	Código de autorização.	texto	300	Texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	Texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	Texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 2
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Transação Aprovada

Facilitadores de Pagamento

Todos os clientes de E-Commerce que são Facilitadores de Pagamento, por obrigatoriedade das bandeiras e do Banco Central devem enviar campos específicos na mensageria transacional. A Braspag transmitirá as informações para as bandeiras por meio da mensageria transacional no momento da autorização.

Os campos específicos estão contidos dentro do nó PaymentFacilitator. Além dos campos deste nó, os facilitadores também precisam enviar obrigatoriamente o campo SoftDescriptor do nó Payment. Veja a seguir o exemplo de requisição e resposta.

Atenção: As bandeiras, ao identificarem inconformidade devido ao não envio dos dados obrigatórios na mensageria transacional, aplicarão multas ao Facilitador responsável pelo envio dos dados transacionais.

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":"false",
         "Alias":"",
         "CardOnFile":{
            "Usage": "Used",
            "Reason":"Unscheduled"
         }
      },
      "PaymentFacilitator":{
         "EstablishmentCode":"1234",
         "SubEstablishment":{
            "EstablishmentCode":"1234",
            "Identity":"11111111000100",
            "Mcc":"1234",
            "Address":"Alameda Grajau, 512",
            "City":"Barueri",
            "State":"SP",
            "CountryCode":"076",
            "PostalCode":"06455914",
            "PhoneNumber":"1155855585"
         }
      }
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051002",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":"false",
         "Alias":"",
         "CardOnFile":{
            "Usage":"Used",
            "Reason":"Unscheduled"
         }
      },
      "PaymentFacilitator":{
         "EstablishmentCode":"1234",
         "SubEstablishment":{
            "EstablishmentCode":"1234",
            "Identity":"11111111000100",
            "Mcc":"1234",
            "Address":"Alameda Grajau, 512",
            "City":"Barueri",
            "State":"SP",
            "CountryCode":"076",
            "PostalCode":"06455914",
            "PhoneNumber":"1155855585"
         }
      }
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.PaymentFacilitator.EstablishmentCode`	Código do estabelecimento do facilitador. “Facilitator ID” (cadastro do facilitador com as bandeiras). Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	11	Sim para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.EstablishmentCode`	Código do estabelecimento do sub-merchant. “Sub-Merchant ID” (cadastro do subcredenciado com o facilitador). Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	15	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.Mcc`	MCC do sub-merchant. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	4	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.Address`	Endereço do sub-merchant. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	22	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.City`	Cidade do sub-merchant. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	13	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.State`	Estado do sub-merchant. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	2	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.PostalCode`	Código postal do sub-merchant. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	9	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.PhoneNumber`	Número de telefone do sub-merchant. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	13	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.Identity`	CNPJ ou CPF do sub-merchant. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	14	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.CountryCode`	Código do país do sub-merchant com base no ISO 3166. Aplicável para Cielo30, Rede2 e PagSeguro.	texto*	3	Sim, para facilitadores
`Payment.PaymentFacilitator.SubEstablishment.CompanyName`	Razão Social do sub-merchant.	texto*	60	Somente para PagSeguro
`Payment.PaymentFacilitator.SubEstablishment.AddressNumber`	Número do endereço do sub-merchant.	texto*	60	Somente para PagSeguro
`Payment.PaymentFacilitator.SubEstablishment.District`	Bairro do sub-merchant.	texto*	60	Somente para PagSeguro

*Evite usar acentos pois eles são considerados como dois caracteres.

Resposta

{
   "MerchantOrderId": "2017051002",
   "Customer": {
      "Name": "Nome do Comprador",
      "Identity": "12345678909",
      "IdentityType": "CPF",
      "Email": "comprador@braspag.com.br",
      "Birthdate": "1991-01-02",
      "Address": {
         "Street": "Alameda Xingu",
         "Number": "512",
         "Complement": "27 andar",
         "ZipCode": "12345987",
         "City": "São Paulo",
         "State": "SP",
         "Country": "BRA",
         "District": "Alphaville"
      },
      "DeliveryAddress": {
         "Street": "Alameda Xingu",
         "Number": "512",
         "Complement": "27 andar",
         "ZipCode": "12345987",
         "City": "São Paulo",
         "State": "SP",
         "Country": "BRA",
         "District": "Alphaville"
   },
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "DoSplit":false,
      "CreditCard": {
         "CardNumber": "455187******0181",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2021",
         "SaveCard": false,
         "Brand": "Visa"
         "Alias": "",
         "CardOnFile":{
            "Usage": "Used",
            "Reason":"Unscheduled"
         }
      },
      "Credentials": {
         "Code": "9999999",
         "Key": "D8888888",
         "Password": "LOJA9999999",
         "Username": "#Braspag2018@NOMEDALOJA#"
      },
        "ProofOfSale": "20170510053219433",
        "AcquirerTransactionId": "0510053219433",
        "AuthorizationCode": "936403",
        "SoftDescriptor": "Mensagem",
        "VelocityAnalysis": {
           "Id": "c374099e-c474-4916-9f5c-f2598fec2925",
           "ResultMessage": "Accept",
           "Score": 0
        },
        "PaymentId": "c374099e-c474-4916-9f5c-f2598fec2925",
        "Type": "CreditCard",
        "Amount": 10000,
        "ReceivedDate": "2017-05-10 17:32:19",
        "CapturedAmount": 10000,
        "CapturedDate": "2017-05-10 17:32:19",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Simulado",
        "ExtraDataCollection": [{
            "Name": "NomeDoCampo",
            "Value": "ValorDoCampo"
        }],
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Payment.MerchantAdviceCode":"1",
        "Status": 2,
        "ProviderReturnCode": "6",
        "ProviderReturnMessage": "Operation Successful",
        "Links": [{
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"
            }
        ]
    }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
"MerchantOrderId": "2017051002",
    "Customer": {
        "Name": "Nome do Comprador",
        "Identity": "12345678909",
        "IdentityType": "CPF",
        "Email": "comprador@braspag.com.br",
        "Birthdate": "1991-01-02",
        "Address": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BRA",
            "District": "Alphaville"
        },
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BRA",
            "District": "Alphaville"
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "DoSplit":false,
        "CreditCard": {
            "CardNumber": "455187******0181",
            "Holder": "Nome do Portador",
            "ExpirationDate": "12/2021",
            "SaveCard": false,
            "Brand": "Visa"
            "Alias": "",
         "CardOnFile":{
            "Usage": "Used",
            "Reason":"Unscheduled"
         }
        },
        "Credentials": {
            "Code": "9999999",
            "Key": "D8888888",
            "Password": "LOJA9999999",
            "Username": "#Braspag2018@NOMEDALOJA#"
        },
        "ProofOfSale": "20170510053219433",
        "AcquirerTransactionId": "0510053219433",
        "AuthorizationCode": "936403",
        "SoftDescriptor": "Mensagem",
        "VelocityAnalysis": {
            "Id": "c374099e-c474-4916-9f5c-f2598fec2925",
            "ResultMessage": "Accept",
            "Score": 0
        },
        "PaymentId": "c374099e-c474-4916-9f5c-f2598fec2925",
        "Type": "CreditCard",
        "Amount": 10000,
        "ReceivedDate": "2017-05-10 17:32:19",
        "CapturedAmount": 10000,
        "CapturedDate": "2017-05-10 17:32:19",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Simulado",
        "ExtraDataCollection": [{
            "Name": "NomeDoCampo",
            "Value": "ValorDoCampo"
        }],
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 2,
        "ProviderReturnCode": "6",
        "ProviderReturnMessage": "Operation Successful",
        "Links": [{
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"
            }
        ]
    }
}

Pix

No Pix, a transmissão da ordem de pagamento e a disponibilidade de fundos para o usuário recebedor ocorrem em tempo real, 24 horas por dia e sem a necessidade de intermediários. Sendo assim, é um meio que viabiliza pagamentos rápidos e com menores custos de transação.

Conheça o ciclo de vida de uma transação Pix:

SEQUÊNCIA	RESPONSÁVEL	DESCRIÇÃO	STATUS DA TRANSAÇÃO
1	Loja	Geração do QR code.	12 - Pendente
2	Comprador	Pagamento do QR code.	2 - Pago
3	Loja	Recebimento da notificação de confirmação do pagamento.	2 - Pago
4	Loja	Consulta ao status da transação.	2 - Pago
5	Loja	Liberação do pedido.	2 - Pago
6	Loja	Caso necessário, solicitação da devolução da transação Pix (semelhante ao estorno do cartão).	2 - Pago
7	Loja	Recebimento da notificação de confirmação de devolução.	11 - Estornado
8	Loja	Consulta ao status da transação.	11 - Estornado

Criando uma Transação com QR Code Pix

Para gerar um QR code Pix através da API Pagador, basta realizar a integração conforme a especificação abaixo.

Entre os campos de envio obrigatório, destacam-se dois: Type, que deve ser enviado como “Pix”; e Provider, que deve ser “Cielo30” ou “Bradesco2”. Na resposta da requisição será retornado o código base64 da imagem do QR code Pix, que deve ser disponibilizado ao comprador.

Veja abaixo a representação do fluxo transacional na geração do QR code Pix: Fluxo Geração QR Code Pix

O comprador então realiza a leitura do QR code através de um dos aplicativos habilitados para o pagamento Pix e efetiva o pagamento. Nesta etapa não há participação da loja nem da Braspag, como demonstrado abaixo: Fluxo Pagamento QR Code Pix

Seguem exemplos de envio de requisição e resposta para a geração do QR code Pix:

Requisição

{ 
   "MerchantOrderId":"2020102601",
   "Customer":{
      "Name":"Nome do Pagador",
      "Identity":"12345678909",
      "IdentityType":"CPF"
   },
   "Payment":{ 
      "Type":"Pix",
      "Provider":"Bradesco2",
      "Amount":100,
      "QrCodeExpiration":36000
   }    
}

--request POST "https://(...)/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{ 
   "MerchantOrderId":"2020102601",
   "Customer":{
      "Name":"Nome do Pagador",
      "Identity":"12345678909",
      "IdentityType":"CPF"
   },
   "Payment":{ 
      "Type":"Pix",
      "Provider":"Bradesco2",
      "Amount":100,
      "QrCodeExpiration":36000
   }    
}
--verbose

PROPRIEDADE	DESCRIÇÃO	TIPO	TAMANHO	OBRIGATÓRIO?
`MerchantOrderId`	Número de identificação do pedido.	texto	50	Sim
`Customer.Name`	Nome do pagador.	texto	255	Sim
`Customer.Identity`	Número do CPF ou CNPJ do cliente.	texto	14	Sim
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF ou CNPJ).	texto	255	Sim
`Payment.Type`	Tipo do meio de pagamento. Neste caso, “Pix”.	texto	-	Sim
`Payment.Provider`	Nome do provedor do meio de pagamento. Neste caso, “Cielo30” ou “Bradesco2”.	texto	-	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.QrCodeExpiration`	Tempo de expiração do QR Code, em segundos. Para provider Cielo30: o tempo de expiração é de duas horas e não é parametrizavel. Para provider Bradesco2: o tempo de expiração do QR Code pode ser configurado no painel Shopfácil ou no momento da autorização pelo parâmetro `Payment.QrCodeExpiration`, em segundos (exemplo: 24 horas = 86400).	número	3600	Não

Resposta

{
   "MerchantOrderId":"2020102601",
   "Customer":{
        "Name": "Nome comprador",
        "Identity": "12345678900",
        "IdentityType": "CPF"
   },
   "Payment":{
      (...)   
      "PaymentId":"1997be4d-694a-472e-98f0-e7f4b4c8f1e7",
      "Type":"Pix",
      "Provider":"Bradesco2",
      "AcquirerTransactionId":"86c200c7-7cdf-4375-92dd-1f62dfa846ad",
         "ProofOfSale":"123456",
      "QrcodeBase64Image":"rfhviy64ak+zse18cwcmtg==[...]",
      "QrCodeString":"00020101021226880014br.gov.bcb.pix2566qrcodes-h.cielo.com.br/pix-qr/d05b1a34-ec52-4201-ba1e-d3cc2a43162552040000530398654041.005802BR5918Merchant Teste HML6009Sao Paulo62120508000101296304031C",
      "QrCodeExpiration": 86400,
      "SentOrderId": "10045146",
      "Amount":100,
      "ReceivedDate":"2020-10-15 18:53:20",
      "Status":12,
      "ProviderReturnCode":"0",
      "ProviderReturnMessage":"Pix gerado com sucesso",
      (...)
   }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
   "MerchantOrderId":"2020102601",
   "Customer":{
        "Name": "Nome comprador",
        "Identity": "12345678900",
        "IdentityType": "CPF"
   },
   "Payment":{
      (...)   
      "Paymentid":"1997be4d-694a-472e-98f0-e7f4b4c8f1e7",
      "Type":"Pix",
      "Provider":"Bradesco2",
      "AcquirerTransactionId":"86c200c7-7cdf-4375-92dd-1f62dfa846ad",
         "ProofOfSale":"123456",
      "QrcodeBase64Image":"rfhviy64ak+zse18cwcmtg==[...]",
      "QrCodeString":"00020101021226880014br.gov.bcb.pix2566qrcodes-h.cielo.com.br/pix-qr/d05b1a34-ec52-4201-ba1e-d3cc2a43162552040000530398654041.005802BR5918Merchant Teste HML6009Sao Paulo62120508000101296304031C",
      "QrCodeExpiration": 36000,
      "SentOrderId": "10045146",
      "Amount":100,
      "ReceivedDate":"2020-10-15 18:53:20",
      "Status":12,
      "ProviderReturnCode":"0",
      "ProviderReturnMessage":"Pix gerado com sucesso",
      (...)
   }
}
--verbose

PROPRIEDADE	DESCRIÇÃO	TIPO	TAMANHO	FORMATO
`Payment.PaymentId`	Campo identificador do pedido.	GUID	40	texto
`Payment.AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Payment.ProofOfSale`	NSU Pix.	texto	20	texto alfanumérico
`Payment.SentOrderId`	Número único enviado ao emissor Pix para representar o número do pedido. Utilizado para realizar a conciliação financeira.	número	8	10045146
`Payment.QrcodeBase64Image`	Código em base64 da imagem do QR code.	texto	-	texto
`Payment.QrCodeString`	Texto codificado para o comprador “copiar” e “colar” no campo do internet banking em pagamentos feitos no ambiente mobile.	texto	Variável	texto alfanumérico
`Payment.Status`	Status da transação. Em caso de sucesso, o status inicial é “12” (Pendente). Veja a lista completa de Status da Transação.	número	-	12
`Payment.ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento.	texto	32	0
`Payment.ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento.	texto	512	“Pix gerado com sucesso”.

Solicitando uma Devolução Pix

Caso o lojista precise “cancelar” uma transferência Pix, é possível realizar uma operação chamada de “devolução”. É importante ressaltar que a devolução não é uma operação instantânea, podendo ser acatada ou não pelo provedor Pix. Quando uma devolução é acatada, uma notificação é recebida pela loja.

Fluxo Cancelamento Pix

Requisição

--request PUT "https://(...)/sales/{PaymentId}/void?Amount=xxx"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório
`MerchantId`	Identificador da loja na API.	GUID	36	Sim
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não
`PaymentId`	Campo identificador do pedido.	GUID	36	Sim
`Amount`	Valor a ser cancelado/estornado, em centavos. Verifique se a adquirente contratada suporta a operação de cancelamento ou estorno.	número	15	Não

Resposta

{
   "Status": 12,
   "ReasonCode": 0,
   "ReasonMessage": "Successful",
   "ProviderReturnCode": "0",
   "ProviderReturnMessage": "Reembolso solicitado com sucesso",
   "Links": [
      {
         "Method": "GET",
         "Rel": "self",
         "Href": "https://(...)/sales/{PaymentId}"
      }
   ]
}

{
   "Status": 12,
   "ReasonCode": 0,
   "ReasonMessage": "Successful",
   "ProviderReturnCode": "0",
   "ProviderReturnMessage": "Reembolso solicitado com sucesso",
   "Links": [
      {
         "Method": "GET",
         "Rel": "self",
         "Href": "https://(...)/sales/{PaymentId}"
      }
   ]
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`Status`	Status da transação.	byte	2	Ex.: “1”
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico

Códigos Pix Bradesco

Abaixo segue os códigos Pix do Bradesco:

STATUS	DESCRIÇÃO
0	Operação realizada com sucesso.
120	A pagar	Status informando que o pagamento por Pix ainda não foi realizado.
121	Pago	Status informando que o pagamento por Pix foi realizado com sucesso.
124	Expirado	Status informando que o tempo para pagamento por Pix foi expirado.
125	Cancelado	Status informando que o pagamento por Pix foi cancelado.
126	Devolvido completamente	Status informando que o pagamento por Pix teve o valor pago devolvido em sua totalidade.
127	Devovildo parcialmente	Status informando que o pagamento por Pix teve uma fração do valor pago devolvido.
130	Pix Removido pelo SPS	Status informando que o QRCode/Payload encontra-se vencido e foi removido, pelo banco da lista de Pix disponíveis.

QR Code

Criando uma Transação com QR Code

Veja abaixo a representação de um fluxo transacional padrão na criação de uma transação com QR code: Fluxo QR Code

Uma transação com QR code se efetua com o envio de uma requisição através do método POST conforme o exemplo abaixo. Essa requisição irá criar a transação, que ficará com o status Pendente na Braspag, e gerar o QR code para realizar o pagamento. Usando um dos aplicativos compatíveis, o comprador efetua o pagamento e a transação muda de status (ex.: Pago, Não pago ou Não autorizado).

O exemplo abaixo contempla o mínimo de campos necessários a serem enviados para a autorização:

Requisição

{  
 "MerchantOrderId":"20191123",
 "Customer":{  
  "Name":"QRCode Test"
  },
 "Payment":{
   "Provider":"Cielo30",
   "Type":"qrcode",
   "Amount":100,
   "Installments":1,
   "Capture":false
   }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
 "MerchantOrderId":"20191023",
 "Customer":{  
  "Name":"QRCode Test"
  },
 "Payment":{
   "Provider":"Cielo30",
   "Type":"qrcode",
   "Amount":500,
   "Installments":1,
   "Capture":false
   }
}

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantOrderId`	Número de identificação do pedido.	texto	50	Sim
`Customer.Name`	Nome do comprador.	texto	255	Não
`Payment.Provider`	Nome do provedor do meio de pagamento. Obs.: Atualmente somente disponível para Cielo30.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Neste caso, “qrcode”.	texto	100	Sim
`Payment.Amount`	Valor do pedido (maior que zero), em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.Capture`	Enviar “true” para uma transação de captura automática.	booleano	-	Não

Resposta

{
 "MerchantOrderId":"20191023",
 "Customer": {
  "Name": "QRCode Test"
 },
 "Payment": {
  "Installments": 1,
  "Capture": false,
  "AcquirerTransactionId": "52d641fb-2880-4024-89f4-7b452dc5d9cd",
  "QrCodeBase64Image": "iVBORw0KGgoAAAA(...)",
  "PaymentId": "403dba6-23e3-468b-92f8-f9af56d3b9d7",
  "Type": "QrCode",
  "Amount": 100,
  "ReceivedDate": "2019-10-23 21:30:00",
  "Currency": "BRL",
  "Country": "BRA",
  "Provider": "Cielo30",
  "ReasonCode": 0,
  "ReasonMessage": "Successful",
  "Status": 12,
  "ProviderReturnCode": "0",
  "ProviderReturnMessage": "QRCode gerado com sucesso",
  "Links": [
   {
    "Method": "GET",
    "Rel": "self",
    "Href": "http://apiquerysandbox.braspag.com.br/v2/sales/4031dba6-23e3-468b-92f8-f9af56d3b9d7"
   }
  ]
 }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
 "MerchantOrderId":"20191023",
 "Customer": {
  "Name": "QRCode Test"
 },
 "Payment": {
  "Installments": 1,
  "Capture": false,
  "AcquirerTransactionId": "52d641fb-2880-4024-89f4-7b452dc5d9cd",
  "QrCodeBase64Image": "iVBORw0KGgoAAAA(...)",
  "PaymentId": "403dba6-23e3-468b-92f8-f9af56d3b9d7",
  "Type": "QrCode",
  "Amount": 100,
  "ReceivedDate": "2019-10-23 21:30:00",
  "Currency": "BRL",
  "Country": "BRA",
  "Provider": "Cielo30",
  "ReasonCode": 0,
  "ReasonMessage": "Successful",
  "Status": 12,
  "ProviderReturnCode": "0",
  "ProviderReturnMessage": "QRCode gerado com sucesso",
  "Links": [
   {
    "Method": "GET",
    "Rel": "self",
    "Href": "http://apiquerysandbox.braspag.com.br/v2/sales/4031dba6-23e3-468b-92f8-f9af56d3b9d7"
   }
  ]
 }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`QrCodeBase64Image`	QR code codificado em base64. A imagem do QR code poderá ser apresentada na página utilizando um código HTML como este: <img src=”data:image/png;base64,{código da imagem em base64}”>.	texto	Variável	texto alfanumérico
`PaymentId`	Campo identificador do pedido. Necessário para operações como consulta, captura e cancelamento.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Status`	Status da transação. No caso da transação de geração com QR code, o status inicial é “12” (Pendente). Veja a lista completa de Status da Transação.	byte	-	2
`ReturnCode`	Código de retorno da adquirência.	texto	32	texto alfanumérico
`ReturnMessage`	Mensagem de retorno da adquirência.	texto	512	texto alfanumérico

Boleto

Boleto Registrado

Com o objetivo de promover maior controle e segurança ao transacional de boletos no e-commerce e garantir mais confiabilidade e comodidade aos usuários, a FEBRABAN em conjunto com os bancos lançou a Nova Plataforma de Cobrança.

Desde 21 de julho de 2018 todos os boletos emitidos no e-commerce, obrigatoriamente, precisam ser registrados. Clique aqui para acessar o comunicado completo.

Abaixo seguem os procedimentos de configuração de boletos em cada banco:

Criando uma Transação de Boleto

Veja abaixo a representação de um fluxo transacional padrão na criação de uma transação com boleto: Fluxo Boleto

Para gerar um boleto, inclusive em ambiente Sandbox, é necessário fornecer dados do comprador como CPF ou CNPJ e endereço. Abaixo temos um exemplo de como criar um pedido com este meio de pagamento.

Os parâmetros Payment.FineRate e Payment.FineAmount não devem ser utilizados em conjunto. A mesma regra se aplica aos parâmetros Payment.InterestRate e Payment.InterestAmount. Esses parâmetros, apresentados na tabela mais abaixo, estão marcados com um * na coluna de obrigatoriedade.

Requisição

{  
   "MerchantOrderId":"2017091101",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"Boleto",
      "Amount":10000,
      "BoletoNumber":"2017091101",
      "Assignor": "Empresa Teste",
      "Demonstrative": "Desmonstrative Teste",
      "ExpirationDate": "2017-12-31",
      "Identification": "12346578909",
      "Instructions": "Aceitar somente até a data de vencimento.",
      "DaysToFine": 1,
      "FineRate": 10.00000,
      "FineAmount": 1000,
      "DaysToInterest": 1,
      "InterestRate": 5.00000,
      "InterestAmount": 500,
      "DiscountAmount": 100,
      "DiscountLimitDate": "2017-12-31",
      "DiscountRate": 5.00000
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017091101",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"Boleto",
      "Amount":10000,
      "BoletoNumber":"2017091101",
      "Assignor": "Empresa Teste",
      "Demonstrative": "Desmonstrative Teste",
      "ExpirationDate": "2017-12-31",
      "Identification": "12346578909",
      "Instructions": "Aceitar somente até a data de vencimento.",
      "DaysToFine": 1,
      "FineRate": 10.00000,
      "FineAmount": 1000,
      "DaysToInterest": 1,
      "InterestRate": 5.00000,
      "InterestAmount": 500,
      "DiscountAmount": 100,
      "DiscountLimitDate": "2017-12-31",
      "DiscountRate": 5.00000
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na Braspag.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na Braspag.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`MerchantOrderId`	Número de identificação do pedido. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Sim
`Customer.Name`	Nome do comprador. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Sim
`Customer.Identity`	Número do RG, CPF ou CNPJ do cliente.	texto	14	Sim
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF ou CNPJ).	texto	255	Sim
`Customer.Address.Street`	Endereço de contato do comprador. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Sim
`Customer.Address.Number`	Número do endereço de contato do comprador. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Sim
`Customer.Address.Complement`	Complemento do endereço de contato do comprador. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Não
`Customer.Address.ZipCode`	CEP do endereço de contato do comprador.	texto	8	Sim
`Customer.Address.District`	Bairro do endereço de contato do comprador. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Sim
`Customer.Address.City`	Cidade do endereço de contato do comprador. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Sim
`Customer.Address.State`	Estado do endereço de contato do comprador.	texto	2	Sim
`Customer.Address.Country`	País do endereço de contato do comprador.	texto	35	Não
`Payment.Provider`	Nome do provedor do meio de pagamento do boleto. Clique aqui para acessar a lista de provedores.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Neste caso, “Boleto”.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.BoletoNumber`	Número do boleto (“Nosso Número”). Caso preenchido, sobrepõe o valor configurado no meio de pagamento. A regra varia de acordo com o provedor utilizado (consulte a tabela).	número	Veja a tabela	Não
`Payment.Assignor`	Nome do cedente. Caso preenchido, sobrepõe o valor configurado no meio de pagamento.	texto	200	Não
`Payment.Demonstrative`	Texto de demonstrativo. Caso preenchido, sobrepõe o valor configurado no meio de pagamento. A regra varia de acordo com o provedor utilizado (consulte a tabela).	texto	Veja a tabela	Não
`Payment.ExpirationDate`	Data de vencimento do boleto. Caso não esteja previamente cadastrado no meio de pagamento, o envio deste campo é obrigatório. Se enviado na requisição, sobrepõe o valor configurado no meio de pagamento.	Date	AAAA-MM-DD	Não
`Payment.Identification`	CNPJ do Cedente. Caso preenchido, sobrepõe o valor configurado no meio de pagamento.	texto	14	Não
`Payment.Instructions`	Instruções do boleto. Caso preenchido, sobrepõe o valor configurado no meio de pagamento. A regra varia de acordo com o provedor utilizado (consulte a tabela). Para quebra de linhas no texto utilize sempre a notação em HTML `<br>`.	texto	Veja a tabela	Não
`Payment.NullifyDays`	Prazo para baixa automática do boleto. O cancelamento automático do boleto acontecerá após o número de dias estabelecido neste campo, contado a partir da data de vencimento. Ex.: um boleto com vencimento para 15/12 que tenha em seu registro o prazo para baixa de 5 dias, poderá ser pago até 20/12; após esta data o título é cancelado. Obs.: Recurso válido somente para boletos registrados do Banco Santander.	número	2	Não
`Payment.DaysToFine`	Opcional e somente para o provedor Bradesco2. Quantidade de dias após o vencimento para cobrar o valor da multa, em número inteiro. Ex.: 3.	número	15	Não
`Payment.FineRate`	Opcional e somente para o provedor Bradesco2. Valor da multa após o vencimento, em percentual, com base no valor do boleto (%). Permitido decimal com até 5 casas decimais. Não utilizar em conjunto com `FineAmount`. Ex: 10.12345 = 10.12345%.	número	15	Não*
`Payment.FineAmount`	Opcional e somente para o provedor Bradesco2. Valor da multa após o vencimento em valor absoluto em centavos. Não utilizar em conjunto com `FineRate`. Ex.: 1000 = R$ 10,00.	número	15	Não*
`Payment.DaysToInterest`	Opcional e somente para o provedor Bradesco2. Quantidade de dias após o vencimento para início da cobrança de juros por dia sobre o valor do boleto, em número inteiro. Ex.: 3.	número	15	Não
`Payment.InterestRate`	Opcional e somente para o provedor Bradesco2. Valor de juros mensal após o vencimento em percentual, com base no valor do boleto (%). O valor de juros é cobrado proporcionalmente por dia (mensal dividido por 30). Permitido decimal com até 5 casas decimais. Não utilizar em conjunto com `InterestAmount`. Ex.: 10.12345.	número	15	Não*
`Payment.InterestAmount`	Opcional e somente para o provedor Bradesco2. Valor absoluto de juros diários após o vencimento, em centavos. Não utilizar em conjunto com `InterestRate`. Ex.: 1000 = R$ 10,00.	número	15	Não*
`Payment.DiscountAmount`	Opcional e somente para o provedor Bradesco2. Valor do desconto até a data limite estipulada pelo Payment.DiscountLimitDate. Em valor absoluto em centavos. Não utilizar em conjunto com “Payment.DiscountRate”. Ex.: 1000 = R$ 10,00.	número	15	Não*
`Payment.DiscountLimitDate`	Opcional e somente para o provedor Bradesco2. Data limite para conceder o desconto	data	AAAA-MM-DD	Não*
`Payment.DiscountRate`	Opcional e somente para o provedor Bradesco2. Valor de desconto após o vencimento em percentual, com base no valor do boleto (%). Não utilizar em conjunto com “Payment.DiscountAmount”.	número	15	Não*

Resposta

{
  "MerchantOrderId": "2017091101",
  "Customer": {
    "Name": "Nome do Comprador",
    "Identity": "12345678909",
    "IdentityType": "CPF",
    "Address": {
      "Street": "Alameda Xingu",
      "Number": "512",
      "Complement": "27 andar",
      "ZipCode": "12345987",
      "City": "São Paulo",
      "State": "SP",
      "Country": "BRA"
    }
  },
  "Payment": {
    "Instructions": "Aceitar somente até a data de vencimento.",
    "ExpirationDate": "2017-12-31",
    "Demonstrative": "Desmonstrative Teste",
    "Url": "https://homologacao.pagador.com.br/post/pagador/reenvia.asp/d24b0aa4-21c9-449d-b85c-6279333f070f",
    "BoletoNumber": "2017091101",
    "BarCodeNumber": "00091739000000100000494250000000263400656560",
    "DigitableLine": "00090.49420 50000.000260 34006.565609 1 73900000010000",
    "Assignor": "Empresa Teste",
    "Address": "Av. Brigadeiro Faria Lima, 160",
    "Identification": "12346578909",
    "PaymentId": "d24b0aa4-21c9-449d-b85c-6279333f070f",
    "Type": "Boleto",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 16:42:55",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "InterestAmount": 1,
    "FineAmount": 5,
    "DaysToFine": 1,
    "DaysToInterest": 1,
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/d24b0aa4-21c9-449d-b85c-6279333f070f"
      }
    ]
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  "MerchantOrderId": "2017091101",
  "Customer": {
    "Name": "Nome do Comprador",
    "Identity": "12345678909",
    "IdentityType": "CPF",
    "Address": {
      "Street": "Alameda Xingu",
      "Number": "512",
      "Complement": "27 andar",
      "ZipCode": "12345987",
      "City": "São Paulo",
      "State": "SP",
      "Country": "BRA",
     "District":"Alphaville"
    }
  },
  "Payment": {
    "Instructions": "Aceitar somente até a data de vencimento.",
    "ExpirationDate": "2017-12-31",
    "Demonstrative": "Desmonstrative Teste",
    "Url": "https://homologacao.pagador.com.br/post/pagador/reenvia.asp/d24b0aa4-21c9-449d-b85c-6279333f070f",
    "BoletoNumber": "2017091101",
    "BarCodeNumber": "00091739000000100000494250000000263400656560",
    "DigitableLine": "00090.49420 50000.000260 34006.565609 1 73900000010000",
    "Assignor": "Empresa Teste",
    "Address": "Av. Brigadeiro Faria Lima, 160",
    "Identification": "12346578909",
    "PaymentId": "d24b0aa4-21c9-449d-b85c-6279333f070f",
    "Type": "Boleto",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 16:42:55",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "InterestAmount": 1,
    "FineAmount": 5,
    "DaysToFine": 1,
    "DaysToInterest": 1,
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/d24b0aa4-21c9-449d-b85c-6279333f070f"
      }
    ]
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ExpirationDate`	Data de expiração.	texto	10	2014-12-25
`Url`	URL do boleto gerado.	string	256	https://…/pagador/reenvia.asp/8464a692-b4bd-41e7-8003-1611a2b8ef2d
`BoletoNumber`	“NossoNumero” gerado.	número	50	2017091101
`BarCodeNumber`	Representação numérica do código de barras.	texto	44	00091628800000157000494250100000001200656560
`DigitableLine`	Linha digitável.	texto	256	00090.49420 50100.000004 12006.565605 1 62880000015700
`Address`	Endereço da loja cadastrada no banco emissor.	texto	256	Ex.: Av. Teste, 160
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 1

Conciliação de Boletos

Para atualizar o status de um boleto para Pago, o Pagador deve receber dos bancos os arquivos CNAB com as liquidações referentes. Para habilitar sua loja a receber os arquivos bancários, basta seguir o procedimento descrito neste link.

Regras Específicas por Banco Emissor

Segue uma lista de propriedades e suas especificações de tamanho, relativas a regras distintas de cada banco emissor e seus respectivos providers:

Propriedade	Bradesco	Banco do Brasil	Itaú Shopline	Santander	Caixa Econômica	Citibank
`Provider`	Bradesco2	BancoDoBrasil2	ItauShopline	Santander2	Caixa2	Citibank2
`MerchantOrderId`	27 (`*1`)	50	8	50	11 (`*2`)	10 (`*2`)
`Payment.BoletoNumber`	11 (`*3`)	9 (`*4`)	8 (`*5`)	13 (`*3`)	12 (`*6`)	11 (`*7`)
`Customer.Name`	34	60 (`*8`)	30	40	40	50 (`*9`)
`Customer.Address.Street`; `Customer.Address.Number`; `Customer.Address.Complement`; `Customer.Address.District`	Street: 70 Number: 10 Complement: 20 District: 50	Totalizar até 60 caracteres (`*8`)	Street, Number e Complement devem totalizar até 40 caracteres District: 15	Street, Number e Complement devem totalizar até 40 caracteres District: 15	Street, Number e Complement devem totalizar até 40 caracteres District: 15	Street, Number e Complement devem totalizar até 40 caracteres District: 50 (`*9`)
`Customer.Address.City`	50	18 (`*8`)	15	30	15	50 (`*9`)
`Payment.Instructions`	450	450	N/A	450	450	450
`Payment.Demonstrative`	255	N/A	N/A	255	255	255

Observações	Detalhes
`*1`	Apenas letras, números e caracteres como “_” e “$”.
`*2`	Caso passe dos 11 dígitos, a API gerará um número incremental a partir da configuração definida.
`*3`	O valor deve ser único, ou seja, o banco emissor não permite a repetição de valores previamente utilizados.
`*4`	Quando enviado acima de 9 posições, a API considera os últimos 9 dígitos.
`*5`	Deverá ser sempre igual ao número de pedido (`MerchantOrderId`).
`*6`	A API concatena automaticamente o valor “14” + 12 dígitos livres + dígito verificador, antes de mandar para o banco emissor. Caso o total ultrapasse os 14 dígitos, a API considera os últimos 14 dígitos.
`*7`	Quando enviado mais que o permitido, a API gera um número aleatório.
`*8`	São aceitos como caracteres válidos: números, letras de A a Z (MAIÚSCULAS) e caracteres especiais de conjunção (hífen “-“ e apóstrofo “‘”). Quando utilizados, não pode haver espaços entre as letras. Exemplos corretos: D’EL-REI / D’ALCORTIVO / SANT’ANA. Exemplos incorretos: D’EL - REI / um espaço em branco entre palavras.
`*9`	Caracteres especiais e acentuações são removidos automaticamente.

Buy Now, Pay Later (BNPL)

Buy Now, Pay Later (BNPL) é um tipo de financiamento de curto prazo, com ou sem taxas para o comprador, que considera uma avaliação de crédito instantânea permitindo o parcelamento de compras sem o uso de cartão de crédito.

A Braspag oferece a integração com o provider Koin para o meio de pagamento BPNL. Para fazer essa integração, consulte o nosso manual de BNPL.

E-Wallet (Carteira Digital)

E-wallets são cofres (repositórios) de cartões e dados de pagamento destinados a consumidores do e-commerce e do mundo físico. As carteiras digitais permitem que um consumidor realize o cadastro de seus dados de pagamento, tornando o processo de compra mais conveniente e seguro.

Entre em contato com o provedor de sua preferência para maiores informações sobre como contratar o serviço.

E-Wallets Disponíveis

O Pagador possui suporte para as principais carteiras digitais disponíveis no mercado, listadas a seguir:

Integração da E-Wallet

Consulte nosso manual E-Wallets e saiba mais detalhes sobre a integração dessas e-wallets em seu checkout.

Com a e-wallet já totalmente integrada, o seu fluxo transacional de pagamento será o seguinte: Fluxo E-Wallet

Voucher

Criando uma Transação com Voucher

Veja abaixo a representação de um fluxo transacional padrão na criação de uma transação com voucher: Fluxo Voucher

Uma transação com cartão voucher se efetua de forma semelhante à com cartão de débito; porém, sem o processo de autenticação.

Atualmente, suportamos os providers Alelo e Ticket.

Provider	Características
Alelo	- Permite captura automática quando `PaymentCapture` = true ou não informado; - Não permite captura posterior; - Permite cancelamento total;
Ticket	- Permite captura automática quando `PaymentCapture` = true ou captura posterior (pré-autorização) quando `PaymentCapture` = false. - Permite cancelamento/estorno total e parcial. Saiba mais sobre cancelamento parcial em Cancelando/estornando uma transação.

Atenção: Em caso de pré-autorização para o voucher Ticket, a API retornará o PaymentStatus = 1 e não retornará os parâmetros Payment.CapturedAmount e Payment.PaidDate.

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider": "Alelo",
      "Type": "DebitCard",
      "Amount": 10,
      "Installments": 1,
      "Authenticate": false,
      "ReturnUrl": "http://www.braspag.com.br"
      "DebitCard": {
         "CardNumber": "****4903",
         "Holder": "TesteBraspag",
         "ExpirationDate": "02/2019",
         "SecurityCode": "***",
         "Brand": "Elo"
      },
      [...]
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider": "Alelo",
      "Type": "DebitCard",
      "Amount": 10,
      "Installments": 1,
      "Authenticate":false,
      "ReturnUrl": "http://www.braspag.com.br"
      "DebitCard": {
         "CardNumber": "****4903",
         "Holder": "TesteBraspag",
         "ExpirationDate": "02/2019",
         "SecurityCode": "***",
         "Brand": "Elo"
      },
      [...]
   }
}

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento. Clique aqui para acessar a lista de provedores.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Neste caso, “DebitCard”.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.ReturnUrl`	URL para onde o usuário será redirecionado após o fim do pagamento.	texto	1024	Sim
`DebitCard.CardNumber`	Número do cartão do comprador.	texto	16	Sim
`DebitCard.Holder`	Nome do comprador impresso no cartão.	texto	25	Sim
`DebitCard.ExpirationDate`	Data de validade impressa no cartão, no formato MM/AAAA. Obs.: Vouchers “Ticket” não possuem data de validade impressa no cartão. Envie uma data posterior ao dia atual para que a transação seja processada.	texto	7	Sim
`DebitCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`DebitCard.Brand`	Bandeira do cartão.	texto	10	Sim

Resposta

{
    [...]
    "Payment": {
        "DebitCard": {
            "CardNumber": "527637******4903",
            "Holder": "TesteBraspag",
            "ExpirationDate": "02/2019",
            "SaveCard": false,
            "Brand": "Elo"
        },
        "ProofOfSale": "004045",
        "AcquirerTransactionId": "c63fb9f7-02ad-42b3-a182-c56e26238a00",
        "AuthorizationCode": "128752",
        "Eci": "0",
        "PaymentId": "562a8563-9181-4f12-bee8-0ccc89c8f931",
        "Type": "DebitCard",
        "Amount": 10,
        "ReceivedDate": "2018-02-21 10:59:57",
        "CapturedAmount": 10,
        "CapturedDate": "2018-02-21 11:00:48",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Alelo",
        "Authenticate": false,
        "ReturnUrl": "http://www.braspag.com.br"
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 2,
        "ProviderReturnCode": "00",
        "ProviderReturnMessage": "Transacao capturada com sucesso",
        [...]
    }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    [...]
    "Payment": {
        "DebitCard": {
            "CardNumber": "527637******4903",
            "Holder": "TesteBraspag",
            "ExpirationDate": "02/2019",
            "SaveCard": false,
            "Brand": "Elo"
        },
        "ProofOfSale": "004045",
        "AcquirerTransactionId": "c63fb9f7-02ad-42b3-a182-c56e26238a00",
        "AuthorizationCode": "128752",
        "Eci": "0",
        "PaymentId": "562a8563-9181-4f12-bee8-0ccc89c8f931",
        "Type": "DebitCard",
        "Amount": 10,
        "ReceivedDate": "2018-02-21 10:59:57",
        "CapturedAmount": 10,
        "CapturedDate": "2018-02-21 11:00:48",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Alelo",
        "Authenticate": false,
        "ReturnUrl": "http://www.braspag.com.br"
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 2,
        "ProviderReturnCode": "00",
        "ProviderReturnMessage": "Transacao capturada com sucesso",
        [...]
    }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`AuthorizationCode`	Código de autorização.	texto	300	texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 1
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Transação Aprovada
`AuthenticationUrl`	URL para o qual o portador será redirecionado para autenticação.	texto	56	https://qasecommerce.cielo.com.br/web/index.cbmp?id=13fda1da8e3d90d3d0c9df8820b96a7f

Recorrência

Diferente dos pagamentos com cartão de crédito ou boleto tradicionais, os pagamentos recorrentes se repetem automaticamente por períodos e em intervalos determinados, cobrando sempre o mesmo valor de um mesmo cartão ou conta.

É muito utilizado para assinaturas de revistas, mensalidades, licenças de software, entre outros. Além da integração técnica, é necessário que o seu estabelecimento comercial esteja habilitado na adquirente para receber pagamentos recorrentes.

A sua loja conta com recursos diferenciados para modelar a cobrança de acordo com o seu negócio, tais como: parametrização e alteração de periodicidade, data de início e fim, quantidade de tentativas e intervalo entre tentativas. Para saber mais detalhes, leia nosso artigo sobre Recorrência.

Vendas recorrentes com cartão de crédito não exigem CVV.

Autorização de Recorrência

Autorizando Recorrência com Cartão de Crédito

Adicione o nó RecurrentPayment ao nó Payment para agendar as recorrências futuras ao autorizar uma transação pela primeira vez na série de recorrências.

Os parâmetros Payment.RecurrentPayment.Interval e Payment.RecurrentPayment.DailyInterval, marcados com um “*” na coluna “OBRIGATÓRIO”, não devem ser utilizados em conjunto.

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount": 10000,
      "Installments": 1,
      "CreditCard": {
         "CardNumber":"5412217070050381",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "RecurrentPayment": {
         "AuthorizeNow":"true",
         "EndDate":"2019-12-31",
         "Interval":"Monthly"
      }
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount": 10000,
      "Installments": 1,
      "CreditCard": {
         "CardNumber":"5412217070050381",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "RecurrentPayment": {
         "AuthorizeNow":"true",
         "EndDate":"2019-12-31",
         "Interval":"Monthly"
      }
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.RecurrentPayment.EndDate`	Data para término da recorrência.	texto	10	Não
`Payment.RecurrentPayment.Interval`	Intervalo da recorrência. Não utilizar em conjunto com `DailyInterval`. Monthly (default) / Bimonthly / Quarterly / SemiAnnual / Annual	texto	10	Não*
`Payment.RecurrentPayment.DailyInterval`	Padrão da recorrência em dias. Não utilizar em conjunto com `Interval`.	número	2	Não*
`Payment.RecurrentPayment.AuthorizeNow`	“true” - autoriza no momento da requisição. “false” - para agendamento futuro.	booleano	—	Sim
`CreditCard.CardNumber`	Número do cartão do comprador.	texto	19	Sim
`CreditCard.Holder`	Nome do comprador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`CreditCard.ExpirationDate`	Data de validade impresso no cartão, no formato MM/AAAA.	texto	7	Sim
`CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`CreditCard.Brand`	Bandeira do cartão.	texto	10	Sim

*Não use os parâmetros Payment.RecurrentPayment.Interval e Payment.RecurrentPayment.DailyInterval em conjunto.

Resposta

{
  [...]
  "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": "ByMerchant",
    "Capture": true,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "455187******0181",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": false,
      "Brand": "Visa"
    },
    "ProofOfSale": "5646418",
    "AcquirerTransactionId": "0511045646418",
    "AuthorizationCode": "100024",
    "PaymentId": "067f73ce-62fb-4d76-871d-0bcbb88fbd22",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 16:56:46",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
    "RecurrentPayment": {
      "RecurrentPaymentId": "808d3631-47ca-43b4-97f5-bd29ab06c271",
      "ReasonCode": 0,
      "ReasonMessage": "Successful",
      "NextRecurrency": "2017-06-11",
      "EndDate": "2019-12-31",
      "Interval": "Monthly",
      [...]
    }
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  [...]
  "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": "ByMerchant",
    "Capture": true,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "455187******0181",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": false,
      "Brand": "Visa"
    },
    "ProofOfSale": "5646418",
    "AcquirerTransactionId": "0511045646418",
    "AuthorizationCode": "100024",
    "PaymentId": "067f73ce-62fb-4d76-871d-0bcbb88fbd22",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 16:56:46",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
    "RecurrentPayment": {
      "RecurrentPaymentId": "808d3631-47ca-43b4-97f5-bd29ab06c271",
      "ReasonCode": 0,
      "ReasonMessage": "Successful",
      "NextRecurrency": "2017-06-11",
      "EndDate": "2019-12-31",
      "Interval": "Monthly",
      [...]
    }
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`RecurrentPaymentId`	ID que representa a recorrência, utilizada para consultas e alterações futuras.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`NextRecurrency`	Data de quando acontecerá a próxima recorrência.	texto	10	2019-12-11 (YYYY-MM-DD)
`EndDate`	Data do fim da recorrência.	texto	10	2019-12-31 (YYYY-MM-DD)
`Interval`	Intervalo entre as recorrências.	texto	10	Monthly / Bimonthly / Quarterly / SemiAnnual / Annual
`AuthorizeNow`	Define se a primeira recorrência já irá ser autorizada ou não.	booleano	—	“true” ou “false”

Agendamento de Recorrência

Agendando uma Autorização

Diferente da recorrência anterior, este exemplo não autoriza imediatamente, mas agenda uma autorização futura.

Para programar a primeira transação da série de recorrências, passe o parâmetro Payment.RecurrentPayment.AuthorizeNow como “false” e adicione o parâmetro Payment.RecurrentPayment.StartDate.

Requisição

{  
   "MerchantOrderId":"2017091101",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Installments":1,
      "CreditCard":{
         "CardNumber":"5412217070050381",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "RecurrentPayment":{
         "AuthorizeNow":false,
         "StartDate":"2017-12-31",
         "EndDate":"2019-12-31",
         "Interval":"Monthly"
      }
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017091101",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Installments":1,
      "CreditCard":{
         "CardNumber":"5412217070050381",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "RecurrentPayment":{
         "AuthorizeNow":false,
         "StartDate":"2017-12-31",
         "EndDate":"2019-12-31",
         "Interval":"Monthly"
      }
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.RecurrentPayment.StartDate`	Data para início da recorrência.	texto	10	Não
`Payment.RecurrentPayment.EndDate`	Data para término da recorrência.	texto	10	Não
`Payment.RecurrentPayment.Interval`	Intervalo da recorrência. Monthly (default) / Bimonthly / Quarterly / SemiAnnual / Annual	texto	10	Não
`Payment.RecurrentPayment.DailyInterval`	Padrão da recorrência em dias. Não utilizar em conjunto com `Interval`.	número	2	Não*
`Payment.RecurrentPayment.AuthorizeNow`	“true” - autoriza no momento da requisição. “false” - para agendamento futuro.	booleano	—	Sim
`CreditCard.CardNumber`	Número do cartão do comprador.	texto	19	Sim
`CreditCard.Holder`	Nome do comprador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`CreditCard.ExpirationDate`	Data de validade impressa no cartão, no formato MM/AAAA.	texto	7	Sim
`CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`CreditCard.Brand`	Bandeira do cartão.	texto	10	Sim

Resposta

{
  [...]
  "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": "ByMerchant",
    "Capture": true,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "455187******0181",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": false,
      "Brand": "Undefined"
    },
    "Type": "CreditCard",
    "Amount": 10000,
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "Status": 20,
    "RecurrentPayment": {
      "RecurrentPaymentId": "32703035-7dfb-4369-ac53-34c7ff7b84e8",
      "ReasonCode": 0,
      "ReasonMessage": "Successful",
      "NextRecurrency": "2017-12-31",
      "StartDate": "2017-12-31",
      "EndDate": "2019-12-31",
      "Interval": "Monthly",
      [...]
      "AuthorizeNow": false
    }
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  [...]
  "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": "ByMerchant",
    "Capture": true,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "455187******0181",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": false,
      "Brand": "Undefined"
    },
    "Type": "CreditCard",
    "Amount": 10000,
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "Status": 20,
    "RecurrentPayment": {
      "RecurrentPaymentId": "32703035-7dfb-4369-ac53-34c7ff7b84e8",
      "ReasonCode": 0,
      "ReasonMessage": "Successful",
      "NextRecurrency": "2017-12-31",
      "StartDate": "2017-12-31",
      "EndDate": "2019-12-31",
      "Interval": "Monthly",
      [...]
      "AuthorizeNow": false
    }
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`RecurrentPaymentId`	Campo identificador da próxima recorrência.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`NextRecurrency`	Data da próxima recorrência.	texto	7	05/2019 (MM/YYYY)
`StartDate`	Data do início da recorrência.	texto	7	05/2019 (MM/YYYY)
`EndDate`	Data do fim da recorrência.	texto	7	05/2019 (MM/YYYY)
`Interval`	Intervalo entre as recorrências.	texto	10	Monthly / Bimonthly / Quarterly / SemiAnnual / Annual
`AuthorizeNow`	Define se a primeira recorrência já irá ser autorizada ou não.	booleano	—	true ou false

Alteração de Dados

Alterando Dados do Comprador

Para alterar os dados do comprador de uma recorrência existente, basta fazer uma chamada PUT para o endpoint especificado.
Em resposta, a API irá retornar o código do Status HTTP, informando se a operação foi realizada com sucesso ou não.

Requisição

{  
   "Name":"Outro nome do Comprador",
   "Email":"outrocomprador@braspag.com.br",
   "Birthdate":"1999-12-12",
   "Identity":"0987654321",
   "IdentityType":"CPF",
   "Address":{
      "Street":"Avenida Brigadeiro Faria Lima",
      "Number":"1500",
      "Complement":"AP 201",
      "ZipCode":"05426200",
      "City":"São Paulo",
      "State":"SP",
      "Country":"BRA",
      "District":"Alphaville"
      },
   "DeliveryAddress":{  
      "Street":"Avenida Brigadeiro Faria Lima",
      "Number":"1500",
      "Complement":"AP 201",
      "ZipCode":"05426200",
      "City":"São Paulo",
      "State":"SP",
      "Country":"BRA",
      "District":"Alphaville"
      }
   }
}

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/Customer"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{   
   "Name":"Outro nome do Comprador",
   "Email":"outrocomprador@braspag.com.br",
   "Birthdate":"1999-12-12",
   "Identity":"0987654321",
   "IdentityType":"CPF",
   "Address":{  
   "Street":"Avenida Brigadeiro Faria Lima",
      "Number":"1500",
      "Complement":"AP 201",
      "ZipCode":"05426200",
      "City":"São Paulo",
      "State":"SP",
      "Country":"BRA",
      "District":"Alphaville"
   },
   "DeliveryAddress":{  
      "Street":"Avenida Brigadeiro Faria Lima",
      "Number":"1500",
      "Complement":"AP 201",
      "ZipCode":"05426200",
      "City":"São Paulo",
      "State":"SP",
      "Country":"BRA",
      "District":"Alphaville"
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)
`Name`	Nome do comprador.	texto	255	Sim
`Email`	Email do comprador.	texto	255	Não
`Birthdate`	Data de nascimento do comprador.	data	10	Não
`Identity`	Número do RG, CPF ou CNPJ do cliente.	texto	14	Não
`IdentityType`	Tipo do documento de identificação do comprador (CFP/CNPJ).	texto	255	Não
`Address.Street`	Endereço do comprador.	texto	255	Não
`Address.Number`	Número do endereço do comprador.	texto	15	Não
`Address.Complement`	Complemento do endereço do comprador.	texto	50	Não
`Address.ZipCode`	CEP do endereço do comprador.	texto	9	Não
`Address.City`	Cidade do endereço do comprador.	texto	50	Não
`Address.State`	Estado do endereço do comprador.	texto	2	Não
`Address.Country`	País do endereço do comprador.	texto	35	Não
`Address.District`	Bairro do endereço do comprador.	texto	50	Não
`DeliveryAddress.Street`	Endereço de entrega do comprador.	texto	255	Não
`DeliveryAddress.Number`	Número do endereço de entrega do comprador.	texto	15	Não
`DeliveryAddress.Complement`	Complemento do endereço de entrega do comprador.	texto	50	Não
`DeliveryAddress.ZipCode`	CEP do endereço de entrega do comprador.	texto	9	Não
`DeliveryAddress.City`	Cidade do endereço de entrega do comprador.	texto	50	Não
`DeliveryAddress.State`	Estado do endereço de entrega do comprador.	texto	2	Não
`DeliveryAddress.Country`	País do endereço de entrega do comprador.	texto	35	Não
`DeliveryAddress.District`	Bairro do endereço de entrega do comprador.	texto	50	Não

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Alterando a Data Final da Recorrência

Para alterar a data final da recorrência já existente, basta fazer um PUT conforme o exemplo.

Requisição

"2021-01-09"

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/EndDate"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
"2021-01-09"
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)
`EndDate`	Data para término da recorrência.	texto	10	Sim

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Alterando o Intervalo da Recorrência

Para alterar o intervalo de uma recorrência já existente, basta fazer um PUT conforme o exemplo:

Requisição

{
  "Interval":"Annual"
}

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/Interval"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
"Interval":"Annual"
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)
`Interval`	Intervalo da recorrência. Monthly / Bimonthly / Quarterly / SemiAnnual / Annual.	texto	10	Sim

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Alterando o Dia da Recorrência

Ao efetuar a alteração do dia da recorrência, devem ser levadas em consideração as seguintes regras utilizadas para execução da atualização na API:

1. Se o novo dia informado for depois do dia atual, iremos atualizar o dia da recorrência com efeito na próxima recorrência.
Ex.: Hoje é dia 05/05 e a próxima recorrência é dia 25/05. Quando atualizado para o dia 10, a data da próxima recorrência será dia 10/05.

2. Se o novo dia informado for antes do dia atual, iremos atualizar o dia da recorrência, mas este só terá efeito depois que a próxima recorrência for executada com sucesso.
Ex.: Hoje é dia 05/05 e a próxima recorrência é dia 25/05. Quando atualizado para o dia 03, a data da próxima recorrência permanecerá dia 25/05. Após sua execução, a recorrência seguinte será agendada para o dia 03/06.

3. Se o novo dia informado for antes do dia atual, mas a próxima recorrência for em outro mês, iremos atualizar o dia da recorrência com efeito na próxima recorrência.
Ex.: Hoje é dia 05/05 e a próxima recorrência é dia 25/09. Quando atualizado para o dia 03, a data da próxima recorrência será 03/09.

Para modificar o dia de vencimento de uma recorrência já existente, basta fazer um PUT conforme o exemplo:

Requisição

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/RecurrencyDay"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
16
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)
`RecurrencyDay`	Dia da recorrência.	número	2	Sim

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Alterando o Valor da Transação da Recorrência

Para modificar o valor da transação de uma recorrência já existente, basta fazer um PUT conforme o exemplo.

Requisição

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/Amount"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
156
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)
`Amount`	Valor do pedido, em centavos. Ex.: 156 equivale a R$ 1,56.	número	15	Sim

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Alterando a Data do Próximo Pagamento

Para alterar somente a data do pagamento seguinte, basta fazer um PUT conforme o exemplo abaixo.

Requisição

"2017-06-15"

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/NextPaymentDate"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
"2016-06-15"
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)
`NextPaymentDate`	Data de pagamento da próxima recorrência.	texto	10	Sim

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Alterando os Dados de Pagamento da Recorrência

Durante o ciclo de vida de uma recorrência, é possível alterar:

Adquirente (ex.: de Rede para Cielo);
Cartão (em caso de cartão vencido);

Para alterar os dados de pagamento, basta fazer um PUT conforme o exemplo.

Requisição

{  
   "Type":"CreditCard",
   "Amount":"20000",
   "Installments":3,
   "Country":"USA",
   "Currency":"USD",
   "SoftDescriptor":"Mensagem",
   "Provider":"Simulado",
   "CreditCard":{  
      "Brand":"Master",
      "Holder":"Nome do Portador",
      "CardNumber":"5412217070050381",
      "ExpirationDate":"05/2019"
   },
   "Credentials": {
      "Code": "9999999",
      "Key": "D8888888",
      "Password": "LOJA9999999",
      "Username": "#Braspag2018@NOMEDALOJA#",
      "Signature": "001"
   }
}

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/Payment"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "Type":"CreditCard",
   "Amount":"20000",
   "Installments":3,
   "Country":"USA",
   "Currency":"USD",
   "SoftDescriptor":"Mensagem",
   "Provider":"Simulado",
   "CreditCard":{  
      "Brand":"Master",
      "Holder":"Nome do Portador",
      "CardNumber":"5412217070050381",
      "ExpirationDate":"05/2019"
   },
   "Credentials": {
      "Code": "9999999",
      "Key": "D8888888",
      "Password": "LOJA9999999",
      "Username": "#Braspag2018@NOMEDALOJA#",
      "Signature": "001"
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)
`Provider`	Nome do provedor do meio de pagamento.	texto	15	Sim
`Type`	Tipo do meio de pagamento.	texto	100	Sim
`Amount`	Valor do pedido, em centavos.	número	15	Sim
`Installments`	Número de parcelas.	número	2	Sim
`SoftDescriptor`	Texto que será impresso na fatura do portador.	texto	13	Não
`CreditCard.CardNumber`	Número do cartão do comprador.	texto	19	Sim
`CreditCard.Holder`	Nome do comprador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`CreditCard.ExpirationDate`	Data de validade impressa no cartão.	texto	7	Sim
`CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`CreditCard.Brand`	Bandeira do cartão.	texto	10	Sim
`Credentials.Code`	Afiliação gerada pela adquirente.	texto	100	Condicional*
`Credentials.Key`	Chave de afiliação/token gerado pela adquirente.	texto	100	Condicional*
`Credentials.Username`	Usuário gerado no credenciamento com a adquirente (provedores como Rede e Getnet utilizam usuário e senha nas comunicações, logo o campo deve obrigatoriamente ser enviado).	texto	50	Condicional*
`Credentials.Password`	Senha gerada no credenciamento com a adquirente (provedores como Rede e Getnet utilizam usuário e senha nas comunicações, logo o campo deve obrigatoriamente ser enviado).	texto	50	Condicional*
`Credentials.Signature`	Enviar o TerminalID da adquirente Global Payments Ex.: 001. Para Safra, colocar nome do estabelecimento, cidade e estado concatenados com ponto-e-vírgula “;”. Ex.: NomedaLoja;São Paulo;SP.	texto	–	Condicional*

**Obrigatório caso não estejam pré configurados nos meios de pagamento do MerchantID utilizado. Em ambiente sandbox usando o provider Simulado, não é necessário enviar o nó Credentials.

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Desabilitação de Pedido

Desabilitando um Pedido Recorrente

Para desabilitar um pedido recorrente, basta fazer um PUT conforme o exemplo:

Requisição

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/Deactivate"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Reabilitação de Pedido

Reabilitando um Pedido Recorrente

Para reabilitar um pedido recorrente, basta fazer um PUT conforme o exemplo:

Requisição

--request PUT "https://apisandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}/Reactivate"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Número de identificação da recorrência.	texto	50	Sim (envio no endpoint)

Resposta

HTTP Status 200

Consulte o anexo HTTP Status Code para ver a lista com todos os códigos de status HTTP possivelmente retornados pela API.

Transação com Renova Fácil

O Renova Fácil é um serviço desenvolvido pela Cielo em conjunto com os emissores cujo objetivo é aumentar a taxa de conversão de vendas recorrentes com cartão de crédito.

Através da identificação de cartões vencidos no momento da transação, é feita a autorização com um novo cartão, que é então retornado para armazenagem.

Como usar o Renova Fácil?

Para usar o Renova Fácil, é necessário que o serviço esteja habilitado na Cielo;
Não é necessário enviar nenhuma informação extra na requisição de autorização, porém a resposta terá o nó NewCard, que informa os dados do novo cartão;
Se a resposta tiver o nó NewCard, é necessário que a loja informe os dados do novo cartão na próxima autorização.

Veja a seguir o exemplo de resposta de uma transação de crédito com o nó NewCard.

Resposta

{
   [...]
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "CreditCard": {
         "CardNumber": "455187******0183",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2016",
         "SaveCard": false,
         "Brand": "Visa"
      },
      "AcquirerTransactionId": "0512105630844",
      "NewCard": {
         "CardNumber": "4551870000512353",
         "Holder": "Nome do Portador",
         "ExpirationDate": "05/2020",
         "SaveCard": false,
         "Brand": "Visa"
      },
      "PaymentId": "ca81c3c9-2dfa-4e6e-9c77-37e33a77ac84",
      "Type": "CreditCard",
      "Amount": 10000,
      "ReceivedDate": "2017-05-12 10:56:30",
      "Currency": "BRL",
      "Country": "BRA",
      "Provider": "Simulado",
      "ReasonCode": 15,
      "ReasonMessage": "CardExpired",
      "Status": 3,
      "ProviderReturnCode": "57",
      "ProviderReturnMessage": "Card Expired",
      [...]
   }
}

{
   [...]
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "CreditCard": {
         "CardNumber": "455187******0183",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2016",
         "SaveCard": false,
         "Brand": "Visa"
      },
      "AcquirerTransactionId": "0512105630844",
      "NewCard": {
         "CardNumber": "4551870000512353",
         "Holder": "Nome do Portador",
         "ExpirationDate": "05/2020",
         "SaveCard": false,
         "Brand": "Visa"
      },
      "PaymentId": "ca81c3c9-2dfa-4e6e-9c77-37e33a77ac84",
      "Type": "CreditCard",
      "Amount": 10000,
      "ReceivedDate": "2017-05-12 10:56:30",
      "Currency": "BRL",
      "Country": "BRA",
      "Provider": "Simulado",
      "ReasonCode": 15,
      "ReasonMessage": "CardExpired",
      "Status": 3,
      "ProviderReturnCode": "57",
      "ProviderReturnMessage": "Card Expired",
      [...]
   }
}

Propriedade	Descrição	Tipo	Tamanho
`NewCard.CardNumber`	Novo número do cartão do comprador.	texto	16
`NewCard.Holder`	Nome do portador impresso no novo cartão.	texto	25
`NewCard.ExpirationDate`	Data de validade impressa no novo cartão.	texto	7
`NewCard.SecurityCode`	Código de segurança impresso no verso do novo cartão.	texto	4
`NewCard.Brand`	Bandeira do novo cartão.	texto	10

Resposta para clientes Cartão Protegido e Renova Fácil

Para clientes Cartão Protegido e Renova Fácil, o nó NewCard irá retornar o número mascarado do cartão e um novo token do cartão atualizado. Dessa forma o lojista pode submeter uma nova cobrança, usando o retorno do Renova Fácil de uma forma segura.

{
   [...]
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "CreditCard": {
         "CardToken":"19077eb8-5d84-352f-10cd-6a4280b8c089"
         "SaveCard": false,
         "Brand": "Visa"
      },
      "AcquirerTransactionId": "0512105630844",
      "NewCard": {
         "CardNumber": "455187******4731",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2028",
         "SaveCard": false,
         "CardToken": "be7fg5a8-3ac8-59bc-dgf2-344516e20b68",
         "Brand": "Visa"
      },
      "PaymentId": "ca81c3c9-2dfa-4e6e-9c77-37e33a77ac84",
      "Type": "CreditCard",
      "Amount": 10000,
      "ReceivedDate": "2017-05-12 10:56:30",
      "Currency": "BRL",
      "Country": "BRA",
      "Provider": "Simulado",
      "ReasonCode": 15,
      "ReasonMessage": "CardExpired",
      "Status": 3,
      "ProviderReturnCode": "57",
      "ProviderReturnMessage": "Card Expired",
      [...]
   }
}

{
   [...]
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "CreditCard": {
         "CardToken":"19077eb8-5d84-352f-10cd-6a4280b8c089"
         "SaveCard": false,
         "Brand": "Visa"
      },
      "AcquirerTransactionId": "0512105630844",
      "NewCard": {
         "CardNumber": "455187******4731",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2028",
         "SaveCard": false,
         "CardToken": "be7fg5a8-3ac8-59bc-dgf2-344516e20b68",
         "Brand": "Visa"
      },
      "PaymentId": "ca81c3c9-2dfa-4e6e-9c77-37e33a77ac84",
      "Type": "CreditCard",
      "Amount": 10000,
      "ReceivedDate": "2017-05-12 10:56:30",
      "Currency": "BRL",
      "Country": "BRA",
      "Provider": "Simulado",
      "ReasonCode": 15,
      "ReasonMessage": "CardExpired",
      "Status": 3,
      "ProviderReturnCode": "57",
      "ProviderReturnMessage": "Card Expired",
      [...]
   }
}

Propriedade	Descrição	Tipo	Tamanho
`NewCard.CardNumber`	BIN e 4 últimos dígitios do novo número do cartão do comprador.	texto	16
`NewCard.Holder`	Nome do portador impresso no novo cartão.	texto	25
`NewCard.ExpirationDate`	Data de validade impressa no novo cartão.	texto	7
`NewCard.SecurityCode`	Código de segurança impresso no verso do novo cartão.	texto	4
`NewCard.CardToken`	Token no Cartão Protegido que representa os dados do cartão. OBS.: Se a origem da transação for do Silent Order Post então o retorno será `NewCard.PaymentToken`	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`NewCard.Brand`	Bandeira do novo cartão.	texto	10

Salvando e Reutilizando Cartões

Ao contratar o Cartão Protegido, é possível salvar um cartão de forma segura e de acordo com as normas PCI. A Braspag salva e criptografa os dados do cartão (nome do portador, número, bandeira e data de validade) em um token, que chamamos de CardToken.

O token viabiliza o envio e processamento de transações e garante a integridade dos cartões armazenados. Além disso, geramos um novo token a cada transação do mesmo comprador.

Além da geração do CardToken, é possível associar um nome (um identificador em formato de texto) ao cartão salvo. Esse identificador será o Alias.

ATENÇÃO: O Cartão Protegido não salva o CVV do cartão. Sendo assim:

O comprador deverá preencher o CVV a cada transação; ou

A sua loja pode realizar transações sem o CVV desde que esteja autorizada pela adquirente.

Salvando um Cartão Durante uma Autorização

Para salvar um cartão de crédito utilizado em uma transação, basta enviar o parâmetro Payment.SaveCard como “true” na requisição padrão de autorização. A numeração do cartão utilizado pode ser validada através da técnica do mod10, explicada neste artigo.

Abaixo veja a representação do fluxo transacional com a solicitação do token pela API do Pagador:

Cartão Protegido - Pagador

Consulte também os fluxos de tokenização direta com a API do Cartão Protegido, com a opção dos serviços da API do VerifyCard.

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":true,
         "Alias":"",
       },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":true,
         "Alias":"",
       },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`CreditCard.CardNumber`	Número do cartão do comprador.	texto	19	Sim
`CreditCard.Holder`	Nome do comprador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`CreditCard.ExpirationDate`	Data de validade impressa no cartão, no formato MM/AAAA.	texto	7	Sim
`CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão.	texto	4	Sim
`CreditCard.Brand`	Bandeira do cartão.	texto	10	Sim
`CreditCard.SaveCard`	“true” - para salvar o cartão. / “false” - para não salvar o cartão.	booleano	10	Não (default “false”)
`CreditCard.Alias`	Alias (apelido) do cartão de crédito.	texto	64	Não

Resposta

O parâmetro CreditCard.CardToken retornará o token a ser salvo para transações futuras com o mesmo cartão.

{
  [...]
  },
    "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": "ByMerchant",
    "Capture": true,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "455187******0181",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": true,
      "CardToken": "250e7c7c-5501-4a7c-aa42-a33d7ad61167",
      "Brand": "Visa",
      "Alias": "Cliente1"
    },
    "ProofOfSale": "3519928",
    "AcquirerTransactionId": "0511023519928",
    "AuthorizationCode": "536934",
    "PaymentId": "3af00b2d-dbd0-42d6-a669-d4937f0881da",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 14:35:19",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
    [...]
  }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  [...]
  },
    "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": "ByMerchant",
    "Capture": true,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "455187******0181",
      "Holder": "Nome do Portador",
      "ExpirationDate": "12/2021",
      "SaveCard": true,
      "CardToken": "250e7c7c-5501-4a7c-aa42-a33d7ad61167",
      "Brand": "Visa",
      "Alias": "Cliente1"
    },
    "ProofOfSale": "3519928",
    "AcquirerTransactionId": "0511023519928",
    "AuthorizationCode": "536934",
    "PaymentId": "3af00b2d-dbd0-42d6-a669-d4937f0881da",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 14:35:19",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
    [...]
  }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor do meio de pagamento.	texto	40	texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`AuthorizationCode`	Código de autorização.	Texto	300	texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 1
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Transação Aprovada
`CreditCard.CardToken`	Token no Cartão Protegido que representa os dados do cartão.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Criando uma Transação com CardToken

Este é um exemplo de como utilizar o CardToken, previamente salvo, para criar uma transação.

Por questões de segurança, um CardToken não armazena o Código de Segurança (CVV). Desta forma, a sua aplicação precisa solicitar esta informação ao portador para cada nova transação e enviar o CVV no campo CreditCard.SecurityCode.

Caso seu estabelecimento tenha autorização da adquirente para submeter transações sem o CVV, o campo CreditCard.SecurityCode passa a ser opcional.

Para transacionar sem o CVV, solicite autorização à sua adquirente.

O nó CreditCard dentro do nó Payment enviará o CardToken conforme exemplo a seguir:

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider": "Simulado",
      "Type": "CreditCard",
      "Amount": 10000,
      "Currency": "BRL",
      "Country": "BRA",
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "SoftDescriptor": "Mensagem",
      "CreditCard": {
         "CardToken":"250e7c7c-5501-4a7c-aa42-a33d7ad61167",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider": "Simulado",
      "Type": "CreditCard",
      "Amount": 10000,
      "Currency": "BRL",
      "Country": "BRA",
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "SoftDescriptor": "Mensagem",
      "CreditCard": {
         "CardToken":"250e7c7c-5501-4a7c-aa42-a33d7ad61167",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`CreditCard.CardToken`	Token no Cartão Protegido que representa os dados do cartão.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão. Para processar vendas sem o CVV, é necessário solicitar liberação na adquirente.	texto	4	Não
`CreditCard.Brand`	Bandeira do cartão.	texto	10	Sim

Resposta

{  
   [...]
   },
     "Payment": {
        "Provider": "Simulado",
        "Type": "CreditCard",
        "Amount": 10000,
        "Currency": "BRL",
        "Country": "BRA",
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "SoftDescriptor": "Mensagem",
        "CreditCard": {
            "CardToken":"250e7c7c-5501-4a7c-aa42-a33d7ad61167",
            "SecurityCode":"123",
            "Brand":"Visa"
            },
    "ProofOfSale": "124305",
    "AcquirerTransactionId": "0511030124305",
    "AuthorizationCode": "065964",
    "PaymentId": "23cd8bf5-2251-4991-9042-533ff5608788",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 15:01:24",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
   [...]
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   [...]
   },
     "Payment": {
        "Provider": "Simulado",
        "Type": "CreditCard",
        "Amount": 10000,
        "Currency": "BRL",
        "Country": "BRA",
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "SoftDescriptor": "Mensagem",
        "CreditCard": {
            "CardToken":"250e7c7c-5501-4a7c-aa42-a33d7ad61167",
            "SecurityCode":"123",
            "Brand":"Visa"
            },
    "ProofOfSale": "124305",
    "AcquirerTransactionId": "0511030124305",
    "AuthorizationCode": "065964",
    "PaymentId": "23cd8bf5-2251-4991-9042-533ff5608788",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 15:01:24",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
   [...]
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`AuthorizationCode`	Código de autorização.	texto	300	texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 1
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Transação Aprovada

Criando uma Transação com Alias

Este é um exemplo de como utilizar o Alias, previamente salvo, para criar uma transação. O Alias é um nome (identificador em formato de texto) associado ao cartão salvo.

Por questões de segurança, um Alias não armazena o Código de Segurança (CVV). Desta forma, a sua aplicação precisa solicitar esta informação ao portador para cada nova transação e enviar o CVV no campo CreditCard.SecurityCode.

Caso seu estabelecimento tenha autorização da adquirente para submeter transações sem o CVV, o campo CreditCard.SecurityCode passa a ser opcional.

Para transacionar sem o CVV, solicite autorização à sua adquirente.

O nó CreditCard dentro do nó Payment enviará o Alias conforme exemplo a seguir:

Requisição

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider": "Simulado",
      "Type": "CreditCard",
      "Amount": 10000,
      "Currency": "BRL",
      "Country": "BRA",
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "SoftDescriptor": "Mensagem",
      "CreditCard": {
         "Alias":"Cliente1",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "IpAddress":"127.0.0.1",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BRA",
         "District":"Alphaville"
      }
   },
   "Payment": {
      "Provider": "Simulado",
      "Type": "CreditCard",
      "Amount": 10000,
      "Currency": "BRL",
      "Country": "BRA",
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "SoftDescriptor": "Mensagem",
      "CreditCard": {
         "Alias":"Cliente1",
         "SecurityCode":"123",
         "Brand":"Visa"
      },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ]
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`Payment.Provider`	Nome do provedor do meio de pagamento.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento.	texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`CreditCard.CardToken`	Token no Cartão Protegido que representa os dados do cartão.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão. Para processar vendas sem o CVV, é necessário solicitar liberação na adquirente.	texto	4	Não
`CreditCard.Brand`	Bandeira do cartão.	texto	10	Sim
`CreditCard.Alias`	Alias (apelido) do cartão de crédito.	texto	64	Não

Resposta

{  
   [...]
   },
     "Payment": {
        "Provider": "Simulado",
        "Type": "CreditCard",
        "Amount": 10000,
        "Currency": "BRL",
        "Country": "BRA",
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "SoftDescriptor": "Mensagem",
        "CreditCard": {
            "Alias":"Cliente1",
            "SecurityCode":"123",
            "Brand":"Visa"
            },
    "ProofOfSale": "124305",
    "AcquirerTransactionId": "0511030124305",
    "AuthorizationCode": "065964",
    "PaymentId": "23cd8bf5-2251-4991-9042-533ff5608788",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 15:01:24",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
   [...]
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   [...]
   },
     "Payment": {
        "Provider": "Simulado",
        "Type": "CreditCard",
        "Amount": 10000,
        "Currency": "BRL",
        "Country": "BRA",
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "SoftDescriptor": "Mensagem",
        "CreditCard": {
            "Alias":"Cliente1",
            "SecurityCode":"123",
            "Brand":"Visa"
            },
    "ProofOfSale": "124305",
    "AcquirerTransactionId": "0511030124305",
    "AuthorizationCode": "065964",
    "PaymentId": "23cd8bf5-2251-4991-9042-533ff5608788",
    "Type": "CreditCard",
    "Amount": 10000,
    "ReceivedDate": "2017-05-11 15:01:24",
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Simulado",
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Status": 1,
    "ProviderReturnCode": "4",
    "ProviderReturnMessage": "Operation Successful",
   [...]
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`AcquirerTransactionId`	Id da transação no provedor de meio de pagamento.	texto	40	texto alfanumérico
`ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`AuthorizationCode`	Código de autorização.	texto	300	texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`ReasonCode`	Código de retorno da API para indicar sucesso ou erro na operação.	texto	32	texto alfanumérico
`ReasonMessage`	Mensagem correspondente ao `ReasonCode`.	texto	512	texto alfanumérico
`Status`	Status da transação. Veja a lista completa de Status da Transação.	byte	2	Ex.: 1
`ProviderReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto	32	57
`ProviderReturnMessage`	Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).	texto	512	Transação Aprovada

Exportação e importação e de tokens

É possível exportar os cartões tokenizados (CardToken) armazenados no cofre Braspag para uso em outros provedores de pagamento e também trazer para a Braspag os cartões tokenizados criados pela sua loja em outros serviços de tokenização.

Exportação de token de cartão: é quando a loja deseja exportar cartões tokenizados (CardToken) e armazenados no cofre Braspag para uso em outros provedores de pagamento. Esse processo está sujeito à cobranças pela Braspag, além de ser necessário assinar um termo de responsabilidade, informar o certificado PCI DSS de quem vai receber os tokens, preparar o ambiente SFTP; fornecer uma chave pública PGP e informar credenciais. Para informações detalhadas deste processo, consulte o artigo Exportação de tokens do Cartão Protegido.
Importação de token de cartão: é quando a loja deseja importar para o ambiente Braspag os tokens de cartão criados pela loja em outros serviços de tokenização. Para isso, a loja deverá listar os tokens de cartão dentro de um layout fornecido pela Braspag, preparar o ambiente SFTP, informar credenciais e usar a chave pública PGP Braspag/Cielo. Para informações detalhadas deste processo, consulte o suporte.

Para que o processo de exportação e importação ocorra com segurança, usamos a criptografia PGP.

Faça o download da chave pública Braspag/Cielo para importação de tokens.

Pagamentos com Análise de Fraude

Ao efetuar um pagamento, é possível verificar qual o risco de uma transação ser fraudulenta. Essa verificação pode ocorrer antes ou depois da autorização da transação, de acordo com as regras definidas pelo cliente.

Fluxo AuthorizeFirst

A sequência mais comum, em que acontece a autorização antes da análise, pode ocorrer com ou sem a captura automática da transação.

Com Autorização

Neste fluxo, a loja (plataforma) envia a requisição para a API do Pagador, que então envia a transação para autorização na Adquirente cadastrada na loja. Uma vez autorizada, o valor da venda estará sensibilizado, mas ainda não terá sido cobrado no cartão.
O Pagador faz a chamada para o Antifraude, onde ocorre a análise de risco do pedido.
Caso seja aceita pelo Antifraude, a transação é então capturada e a cobrança é realizada no cartão. Caso seja rejeitada pelo Antifraude, a API do Pagador solicita o cancelamento da transação à Adquirente e informa a loja. O valor bloqueado no cartão deverá retornar 100% para o cliente final.

Antifraude 1a

Com Captura Automática

Este fluxo é similar ao primeiro, com a diferença da captura automática no lugar da autorização. Se o Antifraude rejeita o pedido, que foi previamente autorizado pela Adquirente e já cobrado no cartão do cliente, a API do Pagador irá solicitar o cancelamento da transação à Adquirente e informar a loja. Neste caso, o valor já cobrado no cartão deverá igualmente ser estornado 100% para o cliente final.

Antifraude 1b

Fluxo AnalyseFirst

Para maiores detalhes sobre o fluxo em que acontece a análise antes da autorização, consulte o Manual do Antifraude.

AuthorizeFirst x AnalyseFirst

Confira a seguir o comportamento da análise de risco de acordo com cada tipo de integração:

Tipo de Integração	Descrição	Parâmetros Necessários
Autorização antes	A transação é enviada para a autorização e então analisada pelo Antifraude.	`FraudAnalysis.Sequence` igual a “AuthorizeFirst”
Análise antes	A transação é analisada pelo Antifraude e então enviada para autorização. Dessa forma, evita-se o envio de transações de alto risco para autorização.	`FraudAnalysis.Sequence` igual a “AnalyseFirst”
Análise das transações autorizadas	O Antifraude é acionado apenas para analisar transações autorizadas, evitando-se o custo com análises de transações que não receberiam autorização.	`FraudAnalysis.Sequence` igual a “AuthorizeFirst” e `FraudAnalysis.SequenceCriteria` igual a “OnSuccess”
Análise em qualquer hipótese	O Antifraude é acionado independentemente do status da transação após a autorização.	`FraudAnalysis.Sequence` igual a “AuthorizeFirst” e `FraudAnalysis.SequenceCriteria` igual a “Always”
Autorização em qualquer hipótese	A transação será enviada para autorização independentemente de seu score de fraude.	`FraudAnalysis.Sequence` igual a “AnalyseFirst” e `FraudAnalysis.SequenceCriteria` igual a “Always”
Captura de transações seguras	Após a análise de fraude, a captura será automática para transações autorizadas definidas como de baixo risco. Para a loja que utiliza revisão manual, a transação será capturada automaticamente assim que a Braspag receber notificação do novo status “Accept”.	`FraudAnalysis.Sequence` igual a “AuthorizeFirst”, `FraudAnalysis.CaptureOnLowRisk` igual a “true” e `Payment.Capture` igual a “false”
Cancelamento de transações comprometidas	Caso a análise de fraude retorne um alto risco para uma transação já autorizada ou capturada, ela será imediamente cancelada ou estornada. Para a loja que utiliza revisão manual, a transação será cancelada ou estornada automaticamente assim que a Braspag receber notificação do novo status “Reject”.	`FraudAnalysis.Sequence` igual a “AuthorizeFirst” e `FraudAnalysis.VoidOnHighRisk` igual a “true”

Caso não seja especificado durante a autorização, a Braspag irá processar sua transação pelo seguinte fluxo:

FraudAnalysis.Sequence igual a “AuthorizeFirst”,
FraudAnalysis.SequenceCriteria igual a “OnSuccess”,
FraudAnalysis.VoidOnHighRisk igual a “false”,
FraudAnalysis.CaptureOnLowRisk igual a “false”.

Implementando a Análise Cybersource

Para que a análise de fraude via Cybersource seja efetuada durante uma transação de cartão de crédito, é necessário complementar o contrato de autorização com os nós FraudAnalysis, Cart, MerchantDefinedFields e Travel (este somente para venda de passagens aéreas).

Durante implantação do Cybersource, informações adicionais podem ser armazenadas através de MDDs (Merchand Defined Data), que são campos numerados de 0 a N utilizados para armazenar informações exclusivas do merchant. Confira este artigo com detalhes sobre o preenchimento desses campos.

Requisição

{  
   "MerchantOrderId":"2017051002",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678910",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "Phone": "5521976781114",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":false
      },
      "Credentials":{  
         "Code":"9999999",
         "Key":"D8888888",
         "Password":"LOJA9999999",
         "Username":"#Braspag2018@NOMEDALOJA#",
         "Signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ],
      "FraudAnalysis":{  
         "Sequence":"AnalyseFirst",
         "SequenceCriteria":"Always",
         "Provider":"Cybersource",
         "CaptureOnLowRisk":false,
         "VoidOnHighRisk":false,
         "TotalOrderAmount":10000,
         "FingerPrintId":"074c1ee676ed4998ab66491013c565e2",
         "Browser":{  
            "CookiesAccepted":false,
            "Email":"comprador@braspag.com.br",
            "HostName":"Teste",
            "IpAddress":"127.0.0.1",
            "Type":"Chrome"
         },
         "Cart":{  
            "IsGift":false,
            "ReturnsAccepted":true,
            "Items":[  
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste1",
                  "Quantity":1,
                  "Sku":"20170511",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               },
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste2",
                  "Quantity":1,
                  "Sku":"20170512",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               }
            ]
         },
         "MerchantDefinedFields":[  
            {  
               "Id":2,
               "Value":"100"
            },
            {  
               "Id":4,
               "Value":"Web"
            },
            {  
               "Id":9,
               "Value":"SIM"
            }
         ],
         "Shipping":{  
            "Addressee":"João das Couves",
            "Method":"LowCost",
            "Phone":"551121840540"
         },
         "Travel":{  
            "JourneyType":"OneWayTrip",
            "DepartureTime":"2018-01-09 18:00",
            "Passengers":[  
               {  
                  "Name":"Passenger Test",
                  "Identity":"212424808",
                  "Status":"Gold",
                  "Rating":"Adult",
                  "Email":"email@mail.com",
                  "Phone":"5564991681074",
                  "TravelLegs":[  
                     {  
                        "Origin":"AMS",
                        "Destination":"GIG"
                     }
                  ]
               }
            ]
         }
      }
   }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051002",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678910",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "Phone": "5521976781114",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":false
      },
      "Credentials":{  
         "code":"9999999",
         "key":"D8888888",
         "password":"LOJA9999999",
         "username":"#Braspag2018@NOMEDALOJA#",
         "signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ],
      "FraudAnalysis":{  
         "Sequence":"AnalyseFirst",
         "SequenceCriteria":"Always",
         "Provider":"Cybersource",
         "CaptureOnLowRisk":false,
         "VoidOnHighRisk":false,
         "TotalOrderAmount":10000,
         "FingerPrintId":"074c1ee676ed4998ab66491013c565e2",
         "Browser":{  
            "CookiesAccepted":false,
            "Email":"comprador@braspag.com.br",
            "HostName":"Teste",
            "IpAddress":"127.0.0.1",
            "Type":"Chrome"
         },
         "Cart":{  
            "IsGift":false,
            "ReturnsAccepted":true,
            "Items":[  
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste1",
                  "Quantity":1,
                  "Sku":"20170511",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               },
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste2",
                  "Quantity":1,
                  "Sku":"20170512",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               }
            ]
         },
         "MerchantDefinedFields":[  
            {  
               "Id":2,
               "Value":"100"
            },
            {  
               "Id":4,
               "Value":"Web"
            },
            {  
               "Id":9,
               "Value":"SIM"
            }
         ],
         "Shipping":{  
            "Addressee":"João das Couves",
            "Method":"LowCost",
            "Phone":"551121840540"
         },
         "Travel":{  
            "JourneyType":"OneWayTrip",
            "DepartureTime":"2018-01-09 18:00",
            "Passengers":[  
               {  
                  "Name":"Passenger Test",
                  "Identity":"212424808",
                  "Status":"Gold",
                  "Rating":"Adult",
                  "Email":"email@mail.com",
                  "Phone":"5564991681074",
                  "TravelLegs":[  
                     {  
                        "Origin":"AMS",
                        "Destination":"GIG"
                     }
                  ]
               }
            ]
         }
      }
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na Braspag.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na Braspag.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja.	GUID	36	Não (envio no header)
`MerchantOrderId`	Número do pedido da loja.	texto	50	Sim
`Customer.Name`	Nome completo do comprador.	texto	120	Sim
`Customer.Identity`	Número do documento de identificação do comprador.	texto	14	Sim
`Customer.IdentityType`	Tipo de documento de identificação do comprador. Possíveis valores: “CPF” ou “CNPJ”.	texto	255	Não
`Customer.Email`	E-mail do comprador.	texto	100	Sim
`Customer.Birthdate`	Data de nascimento do comprador. Ex.: 1991-01-10.	data	10	Sim
`Customer.Phone`	Número do telefone do comprador. Ex.: 5521976781114.	texto	15	Sim
`Customer.Address.Street`	Logradouro do endereço de cobrança.	texto	54	Sim
`Customer.Address.Number`	Número do endereço de cobrança.	texto	5	Sim
`Customer.Address.Complement`	Complemento do endereço de cobrança.	texto	14	Não
`Customer.Address.ZipCode`	CEP do endereço de cobrança.	texto	9	Sim
`Customer.Address.City`	Cidade do endereço de cobrança.	texto	50	Sim
`Customer.Address.State`	Estado do endereço de cobrança.	texto	2	Sim
`Customer.Address.Country`	País do endereço de cobrança. Mais informações em ISO 2-Digit Alpha Country Code.	texto	2	Sim
`Customer.Address.District`	Bairro do endereço de cobrança.	texto	45	Sim
`Customer.DeliveryAddress.Street`	Logradouro do endereço de entrega.	texto	54	Não
`Customer.DeliveryAddress.Number`	Número do endereço de entrega.	texto	5	Não
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega.	texto	14	Não
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega.	texto	9	Não
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega.	texto	50	Não
`Customer.DeliveryAddress.State`	Estado do endereço de entrega.	texto	2	Não
`Customer.DeliveryAddress.Country`	País do endereço de entrega. Mais informações em ISO 2-Digit Alpha Country Code.	texto	2	Não
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega.	texto	45	Não
`Payment.Provider`	Nome do provedor da autorização.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Obs.: Somente o tipo “CreditCard” funciona com análise de fraude.	texto	100	Sim
`Payment.Amount`	Valor da transação financeira, em centavos. Ex.: 150000 = R$ 1.500,00.	número	15	Sim
`Payment.ServiceTaxAmount`	Aplicável apenas para empresas aéreas. Montante do valor da autorização que deve ser destinado à taxa de serviço. Obs.: Esse valor não é adicionado ao valor da autorização.	número	15	Não
`Payment.Currency`	Moeda na qual o pagamento será feito. Possíveis valores: “BRL” / “USD” / “MXN” / “COP” / “CLP” / “ARS” / “PEN” / “EUR” / “PYN” / “UYU” / “VEB” / “VEF” / “GBP”.	texto	3	Não
`Payment.Country`	País na qual o pagamento será realizado.	texto	3	Não
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.Interest`	Tipo de parcelamento. Possíveis valores: “ByMerchant” (loja) / “ByIssuer” (emissor).	texto	10	Não
`Payment.Capture`	Indica se a autorização deverá ser com captura automática. Possíveis valores: “true” / “false” (default). Obs1.: Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. Obs2.: Este campo deverá ser preenchido de acordo com o fluxo da análise de fraude.	booleano	—	Não
`Payment.Authenticate`	Indica se a transação deve ser autenticada. Possíveis valores: “true” / “false” (default). Obs1.: Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. Obs2. O campo `Payment.Recurrent` deve ser igual a “true” quando este for igual a “false”.	booleano	—	Não
`Payment.Recurrent`	Indica se a transação é do tipo recorrente. Possíveis valores: “true” / “false” (default). Obs1.: Este campo igual a “true” não irá criar uma recorrência; apenas permitirá a realização de uma transação sem a necessidade de envio do CVV, indicando para a adquirente que é a cobrança de uma transação de uma recorrência. Obs2.: Somente para transações Cielo. Obs3.: O campo `Payment.Authenticate` deve ser igual a “false” quando este for igual a “true”.	booleano	—	Não
`Payment.SoftDescriptor`	Texto que será impresso na fatura do portador. Obs.: O valor deste campo deve tornar fácil para o portador a identificação do estabelecimento onde foi realizada a compra, pois é um dos principais ofensores para chargeback.	texto	13	Não
`Payment.DoSplit`	Indica se a transação será dividida entre vários participantes. Possíveis valores: “true” / “false” (default). Para utilizar a funcionalidade de split de pagamentos, é necessário a contratação da solução junto à Braspag.	booleano	—	Não
`Payment.ExtraDataCollection.Name`	Identificador do campo extra que será enviado.	texto	50	Não
`Payment.ExtraDataCollection.Value`	Valor do campo extra que será enviado.	texto	1024	Não
`Payment.Credentials.Code`	Afiliação gerada pela adquirente.	texto	100	Sim
`Payment.Credentials.Key`	Chave de afiliação/token gerado pela adquirente.	texto	100	Sim
`Payment.Credentials.Username`	Usuário gerado no credenciamento com a adquirente Getnet. Obs.: O campo deve ser obrigatoriamente enviado se a transação é direcionada para Getnet.	texto	50	Não
`Payment.Credentials.Password`	Senha gerada no credenciamento com a adquirente Getnet. Obs.: O campo deve ser obrigatoriamente enviado se a transação é direcionada para Getnet.	texto	50	Não
`Payment.Credentials.Signature`	Id do terminal no credenciamento com a adquirente Global Payments. Obs.: O campo deve ser obrigatoriamente enviado se a transação é direcionada para Global Payments.	texto	3	Não
`Payment.CreditCard.CardNumber`	Número do cartão de crédito.	texto	19	Sim
`Payment.CreditCard.Holder`	Nome do portador impresso no cartão de crédito. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`Payment.CreditCard.ExpirationDate`	Data de validade do cartão de crédito.	texto	7	Sim
`Payment.CreditCard.SecurityCode`	Código de segurança no verso do cartão de crédito.	texto	4	Sim
`Payment.CreditCard.Brand`	Bandeira do cartão de crédito.	texto	10	Sim
`Payment.CreditCard.SaveCard`	Indica se os dados do cartão de crédito serão armazenados no Cartão Protegido.	booleano	—	Não
`Payment.CreditCard.Alias`	Alias (apelido) do cartão de crédito salvo no Cartão Protegido.	texto	64	Não
`Payment.FraudAnalysis.Sequence`	Tipo de fluxo da análise de fraude. Possíveis valores: “AnalyseFirst” / “AuthorizeFirst”.	texto	14	Sim
`Payment.FraudAnalysis.SequenceCriteria`	Critério do fluxo da análise de fraude. Possíveis valores: “OnSuccess” / “Always”.	texto	9	Sim
`Payment.FraudAnalysis.Provider`	Provedor de Antifraude. Possível valor: “Cybersource”.	texto	10	Sim
`Payment.FraudAnalysis.CaptureOnLowRisk`	Indica se a transação após a análise de fraude será capturada. Possíveis valores: “true” / “false” (default) Obs1.: Quando enviado igual a “true” e o retorno da análise de fraude for de baixo risco (“Accept”), a transação anteriormente autorizada será capturada. Obs2.: Quando enviado igual a “true” e o retorno da análise de fraude for revisão (“Review”), a transação ficará autorizada, sendo capturada após a Braspag receber notificação de alteração do status para baixo risco (“Accept”). Obs3.: Para a utilização deste parâmetro, a sequência do fluxo de análise de risco (`FraudAnalysis.Sequence`) deve ser obrigatoriamente “AuthorizeFirst”.	booleano	—	Não
`Payment.FraudAnalysis.VoidOnHighRisk`	Indica se a transação após a análise de fraude será cancelada. Possíveis valores: “true” / “false” (default). Obs1.: Quando enviado igual a “true” e o retorno da análise de fraude for de alto risco (“Reject”), a transação anteriormente autorizada será cancelada. Obs2.: Quando enviado igual a “true” e o retorno da análise de fraude for revisão (“Review”), a transação ficará autorizada, sendo cancelada após a Braspag receber notificação de alteração do status para alto risco (“Reject”). Obs3.: Para a utilização deste parâmetro, a sequência do fluxo de análise de risco (`FraudAnalysis.Sequence`) deve ser obrigatoriamente “AuthorizeFirst”.	booleano	—	Não
`Payment.FraudAnalysis.TotalOrderAmount`	Valor total do pedido, em centavos. Ex.: 123456 = R$ 1.234,56.	número	15	Sim
`Payment.FraudAnalysis.FingerPrintId`	É o valor do `ProviderIdentifier`. Identificador utilizado para cruzar informações obtidas do dispositivo do comprador. Obs.: Este identificador poderá ser qualquer valor ou o número do pedido, mas deverá ser único durante 48 horas. Saiba mais em Fingerprint com a Cybersource.	texto	88	Sim
`Payment.FraudAnalysis.Browser.HostName`	Nome do host informado pelo browser do comprador e identificado através do cabeçalho HTTP.	texto	60	Não
`Payment.FraudAnalysis.Browser.CookiesAccepted`	Identifica se o browser do comprador aceita cookies. Possíveis valores: “true” / “false” (default).	booleano	—	Sim
`Payment.FraudAnalysis.Browser.Email`	E-mail registrado no browser do comprador. Pode ser diferente do e-mail de cadastro na loja (`Customer.Email`).	texto	100	Não
`Payment.FraudAnalysis.Browser.Type`	Nome do browser utilizado pelo comprador e identificado através do cabeçalho HTTP. Ex.: “Google Chrome”, “Mozilla Firefox”, “Safari”, etc.	texto	40	Não
`Payment.FraudAnalysis.Browser.IpAddress`	Endereço de IP do comprador. Formato IPv4 ou IPv6.	texto	45	Sim
`Payment.FraudAnalysis.Cart.IsGift`	Indica se o pedido realizado pelo comprador é para presente.	booleano	—	Não
`Payment.FraudAnalysis.Cart.ReturnsAccepted`	Indica se o pedido realizado pelo comprador pode ser devolvido à loja. Possíveis valores: “true” / “false” (default).	booleano	—	Não
`Payment.FraudAnalysis.Cart.Items.GiftCategory`	Identifica a avaliação dos endereços de cobrança e entrega para diferentes cidades, estados ou países. Lista de Valores - GiftCategory.	texto	9	Não
`Payment.FraudAnalysis.Cart.Items.HostHedge`	Nível de importância dos endereços de IP e e-mail do comprador na análise de fraude. Lista de Valores - HostHedge.	texto	6	Não
`Payment.FraudAnalysis.Cart.Items.NonSensicalHedge`	Nível de importância das verificações sobre os dados do comprador sem sentido na análise de fraude. Lista de Valores - NonSensicalHedge.	texto	6	Não
`Payment.FraudAnalysis.Cart.Items.ObscenitiesHedge`	Nível de importância das verificações sobre os dados do comprador com obscenidade na análise de fraude. Lista de Valores - ObscenitiesHedge.	texto	6	Não
`Payment.FraudAnalysis.Cart.Items.PhoneHedge`	Nível de importância das verificações sobre os números de telefone do comprador na análise de fraude. Lista de Valores - PhoneHedge.	texto	6	Não
`Payment.FraudAnalysis.Cart.Items.Name`	Nome do produto.	texto	255	Sim
`Payment.FraudAnalysis.Cart.Items.Quantity`	Quantidade do produto.	número	15	Sim
`Payment.FraudAnalysis.Cart.Items.Sku`	SKU (Stock Keeping Unit - Unidade de Controle de Estoque) do produto.	texto	255	Sim
`Payment.FraudAnalysis.Cart.Items.UnitPrice`	Preço unitário do produto, em centavos. Ex.: 10950 = R$ 109,50.	número	15	Sim
`Payment.FraudAnalysis.Cart.Items.Risk`	Nível de risco do produto associado a quantidade de chargebacks.	texto	6	Não
`Payment.FraudAnalysis.Cart.Items.TimeHedge`	Nível de importância, na análise de fraude, da hora do dia em que o comprador realizou o pedido. Lista de Valores - TimeHedge.	texto	6	Não
`Payment.FraudAnalysis.Cart.Items.Type`	Categoria do produto. Lista de Valores - Type.	texto	19	Não
`Payment.FraudAnalysis.Cart.Items.VelocityHedge`	Nível de importância, na análise de fraude, da frequência de compra do comprador dentro dos 15 minutos anteriores. Lista de Valores - VelocityHedge.	texto	6	Não
`Payment.FraudAnalysis.MerchantDefinedFields.Id`	Id das informações adicionais a serem enviadas. Tabela de MDDs.	número	2	Sim
`Payment.FraudAnalysis.MerchantDefinedFields.Value`	Valor das informações adicionais a serem enviadas. Tabela de MDDs.	texto	255	Sim
`Payment.FraudAnalysis.Shipping.Addressee`	Nome completo do responsável a receber o produto no endereço de entrega.	texto	120	Não
`Payment.FraudAnalysis.Shipping.Method`	Meio de entrega do pedido. Lista de Valores - Method.	texto	8	Não
`Payment.FraudAnalysis.Shipping.Phone`	Número do telefone do responsável a receber o produto no endereço de entrega. Ex.: 552121114700.	texto	15	Não
`Payment.FraudAnalysis.Travel.JourneyType`	Tipo de viagem. Lista de Valores - JourneyType.	texto	32	Não
`Payment.FraudAnalysis.Travel.DepartureTime`	Data e hora de partida. Ex.: 2018-03-31 19:16:38.	datetime	—	Não
`Payment.FraudAnalysis.Travel.Passengers.Name`	Nome completo do passageiro.	texto	120	Não
`Payment.FraudAnalysis.Travel.Passengers.Identity`	Número do documento do passageiro.	texto	32	Não
`Payment.FraudAnalysis.Travel.Passengers.Status`	Classificação da empresa aérea. Lista de Valores - Status.	texto	15	Não
`Payment.FraudAnalysis.Travel.Passengers.Rating`	Tipo do passageiro. Lista de Valores - Rating.	texto	13	Não
`Payment.FraudAnalysis.Travel.Passengers.Email`	E-mail do passageiro.	texto	255	Não
`Payment.FraudAnalysis.Travel.Passengers.Phone`	Telefone do passageiro. Ex.: 552121114700.	texto	15	Não
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Origin`	Código do aeroporto de partida. Mais informações em IATA 3-Letter Codes.	texto	3	Não
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Destination`	Código do aeroporto de chegada. Mais informações em IATA 3-Letter Codes.	texto	3	Não

Resposta

{  
   "MerchantOrderId":"2017051002",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678910",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "Phone": "5521976781114"
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"455187******0181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":false
      },
      "Credentials":{  
         "code":"9999999",
         "key":"D8888888",
         "password":"LOJA9999999",
         "username":"#Braspag2018@NOMEDALOJA#",
         "signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ],
      "FraudAnalysis":{  
         "Sequence":"AnalyseFirst",
         "SequenceCriteria":"Always",
         "Provider":"Cybersource",
         "CaptureOnLowRisk":false,
         "VoidOnHighRisk":false,
         "TotalOrderAmount":10000,
         "FingerPrintId":"074c1ee676ed4998ab66491013c565e2",
         "Browser":{  
            "CookiesAccepted":false,
            "Email":"comprador@braspag.com.br",
            "HostName":"Teste",
            "IpAddress":"127.0.0.1",
            "Type":"Chrome"
         },
         "Cart":{  
            "IsGift":false,
            "ReturnsAccepted":true,
            "Items":[  
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste1",
                  "Quantity":1,
                  "Sku":"20170511",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               },
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste2",
                  "Quantity":1,
                  "Sku":"20170512",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               }
            ]
         },
         "MerchantDefinedFields":[  
            {  
               "Id":2,
               "Value":"100"
            },
            {  
               "Id":4,
               "Value":"Web"
            },
            {  
               "Id":9,
               "Value":"SIM"
            }
         ],
         "Shipping":{  
            "Addressee":"João das Couves",
            "Method":"LowCost",
            "Phone":"551121840540"
         },
         "Travel":{  
            "JourneyType":"OneWayTrip",
            "DepartureTime":"2018-01-09 18:00",
            "Passengers":[  
               {  
                  "Name":"Passenger Test",
                  "Identity":"212424808",
                  "Status":"Gold",
                  "Rating":"Adult",
                  "Email":"email@mail.com",
                  "Phone":"5564991681074",
                  "TravelLegs":[  
                     {  
                        "Origin":"AMS",
                        "Destination":"GIG"
                     }
                  ]
               }
            ]
        },
        "Id":"0e4d0a3c-e424-4fa5-a573-4eabbd44da42",
        "Status":1,
        "FraudAnalysisReasonCode":100,
        "ReplyData":{  
            "AddressInfoCode":"COR-BA^MM-BIN",
            "FactorCode":"B^D^R^Z",
            "Score":42,
            "BinCountry":"us",
            "CardIssuer":"FIA CARD SERVICES, N.A.",
            "CardScheme":"VisaCredit",
            "HostSeverity":1,
            "InternetInfoCode":"FREE-EM^RISK-EM",
            "IpRoutingMethod":"Undefined",
            "ScoreModelUsed":"default_lac",
            "CasePriority":3,
            "ProviderTransactionId":"5220688414326697303008"
         }
      },
      "PaymentId": "c374099e-c474-4916-9f5c-f2598fec2925",
      "ProofOfSale": "20170510053219433",
      "AcquirerTransactionId": "0510053219433",
      "AuthorizationCode": "936403",
      "ReceivedDate": "2017-05-10 17:32:19",
      "CapturedAmount": 10000,
      "CapturedDate": "2017-05-10 17:32:19",
      "ReasonCode": 0,
      "ReasonMessage": "Successful",
      "Status": 2,
      "ProviderReturnCode": "6",
      "ProviderReturnMessage": "Operation Successful",
      "Links": [{
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"
      },
      {
        "Method": "PUT",
        "Rel": "void",
        "Href": "https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"
      }]
   }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{  
   "MerchantOrderId":"2017051002",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678910",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "Phone": "5521976781114"
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":false,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"4551870000000181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Visa",
         "SaveCard":false
      },
      "Credentials":{  
         "code":"9999999",
         "key":"D8888888",
         "password":"LOJA9999999",
         "username":"#Braspag2018@NOMEDALOJA#",
         "signature":"001"
      },
      "ExtraDataCollection":[  
         {  
            "Name":"NomeDoCampo",
            "Value":"ValorDoCampo"
         }
      ],
      "FraudAnalysis":{  
         "Sequence":"AnalyseFirst",
         "SequenceCriteria":"Always",
         "Provider":"Cybersource",
         "CaptureOnLowRisk":false,
         "VoidOnHighRisk":false,
         "TotalOrderAmount":10000,
         "FingerPrintId":"074c1ee676ed4998ab66491013c565e2",
         "Browser":{  
            "CookiesAccepted":false,
            "Email":"comprador@braspag.com.br",
            "HostName":"Teste",
            "IpAddress":"127.0.0.1",
            "Type":"Chrome"
         },
         "Cart":{  
            "IsGift":false,
            "ReturnsAccepted":true,
            "Items":[  
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste1",
                  "Quantity":1,
                  "Sku":"20170511",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               },
               {  
                  "GiftCategory":"Undefined",
                  "HostHedge":"Off",
                  "NonSensicalHedge":"Off",
                  "ObscenitiesHedge":"Off",
                  "PhoneHedge":"Off",
                  "Name":"ItemTeste2",
                  "Quantity":1,
                  "Sku":"20170512",
                  "UnitPrice":10000,
                  "Risk":"High",
                  "TimeHedge":"Normal",
                  "Type":"AdultContent",
                  "VelocityHedge":"High"
               }
            ]
         },
         "MerchantDefinedFields":[  
            {  
               "Id":2,
               "Value":"100"
            },
            {  
               "Id":4,
               "Value":"Web"
            },
            {  
               "Id":9,
               "Value":"SIM"
            }
         ],
         "Shipping":{  
            "Addressee":"João das Couves",
            "Method":"LowCost",
            "Phone":"551121840540"
         },
         "Travel":{  
            "JourneyType":"OneWayTrip",
            "DepartureTime":"2018-01-09 18:00",
            "Passengers":[  
               {  
                  "Name":"Passenger Test",
                  "Identity":"212424808",
                  "Status":"Gold",
                  "Rating":"Adult",
                  "Email":"email@mail.com",
                  "Phone":"5564991681074",
                  "TravelLegs":[  
                     {  
                        "Origin":"AMS",
                        "Destination":"GIG"
                     }
                  ]
               }
            ]
        },
        "Id":"0e4d0a3c-e424-4fa5-a573-4eabbd44da42",
        "Status":1,
        "FraudAnalysisReasonCode":100,
        "ReplyData":{  
            "AddressInfoCode":"COR-BA^MM-BIN",
            "FactorCode":"B^D^R^Z",
            "Score":42,
            "BinCountry":"us",
            "CardIssuer":"FIA CARD SERVICES, N.A.",
            "CardScheme":"VisaCredit",
            "HostSeverity":1,
            "InternetInfoCode":"FREE-EM^RISK-EM",
            "IpRoutingMethod":"Undefined",
            "ScoreModelUsed":"default_lac",
            "CasePriority":3,
            "ProviderTransactionId":"5220688414326697303008"
         }
      },
      "PaymentId": "c374099e-c474-4916-9f5c-f2598fec2925",
      "ProofOfSale": "20170510053219433",
      "AcquirerTransactionId": "0510053219433",
      "AuthorizationCode": "936403",
      "ReceivedDate": "2017-05-10 17:32:19",
      "CapturedAmount": 10000,
      "CapturedDate": "2017-05-10 17:32:19",
      "ReasonCode": 0,
      "ReasonMessage": "Successful",
      "Status": 2,
      "ProviderReturnCode": "6",
      "ProviderReturnMessage": "Operation Successful",
      "Links": [{
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925"
      },
      {
        "Method": "PUT",
        "Rel": "void",
        "Href": "https://apisandbox.braspag.com.br/v2/sales/c374099e-c474-4916-9f5c-f2598fec2925/void"
      }]
   }
}

Propriedade	Descrição	Tipo
`MerchantOrderId`	Número do pedido da loja.	texto
`Customer.Name`	Nome completo do comprador.	texto
`Customer.Identity`	Número do documento de identificação do comprador.	texto
`Customer.IdentityType`	Tipo de documento de identificação do comprador.	texto
`Customer.Email`	E-mail do comprador.	texto
`Customer.Birthdate`	Data de nascimento do comprador.	data
`Customer.Phone`	Número do telefone do comprador.	texto
`Customer.Address.Street`	Logradouro do endereço de cobrança.	texto
`Customer.Address.Number`	Número do endereço de cobrança.	texto
`Customer.Address.Complement`	Complemento do endereço de cobrança.	texto
`Customer.Address.ZipCode`	CEP do endereço de cobrança.	texto
`Customer.Address.City`	Cidade do endereço de cobrança.	texto
`Customer.Address.State`	Estado do endereço de cobrança.	texto
`Customer.Address.Country`	País do endereço de cobrança.	texto
`Customer.Address.District`	Bairro do endereço de cobrança.	texto
`Customer.DeliveryAddress.Street`	Logradouro do endereço de entrega.	texto
`Customer.DeliveryAddress.Number`	Número do endereço de entrega.	texto
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega.	texto
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega.	texto
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega.	texto
`Customer.DeliveryAddress.State`	Estado do endereço de entrega.	texto
`Customer.DeliveryAddress.Country`	País do endereço de entrega.	texto
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega.	texto
`Payment.Provider`	Nome do provedor da autorização.	texto
`Payment.Type`	Tipo do meio de pagamento.	texto
`Payment.Amount`	Valor da transação financeira, em centavos.	número
`Payment.ServiceTaxAmount`	Montante do valor da autorização que deve ser destinado à taxa de serviço.	número
`Payment.Currency`	Moeda na qual o pagamento será feito.	texto
`Payment.Country`	País na qual o pagamento será realizado.	texto
`Payment.Installments`	Número de parcelas.	número
`Payment.Interest`	Tipo de parcelamento.	texto
`Payment.Capture`	Indica se a autorização deverá ser com captura automática.	booleano
`Payment.Authenticate`	Indica se a transação deve ser autenticada.	booleano
`Payment.Recurrent`	Indica se a transação é do tipo recorrente.	booleano
`Payment.SoftDescriptor`	Texto que será impresso na fatura do portador.	texto
`Payment.DoSplit`	Indica se a transação será dividida entre vários participantes.	booleano
`Payment.ExtraDataCollection.Name`	Identificador do campo extra que será enviado.	texto
`Payment.ExtraDataCollection.Value`	Valor do campo extra que será enviado.	texto
`Payment.Credentials.Code`	Afiliação gerada pela adquirente.	texto
`Payment.Credentials.Key`	Chave de afiliação/token gerado pela adquirente.	texto
`Payment.Credentials.Username`	Usuário gerado no credenciamento com a adquirente Getnet.	texto
`Payment.Credentials.Password`	Senha gerada no credenciamento com a adquirente Getnet.	texto
`Payment.Credentials.Signature`	Id do terminal no credenciamento com a adquirente Global Payments.	texto
`Payment.CreditCard.CardNumber`	Número do cartão de crédito truncado.	texto
`Payment.CreditCard.Holder`	Nome do portador impresso no cartão de crédito.	texto
`Payment.CreditCard.ExpirationDate`	Data de validade do cartão de crédito.	texto
`Payment.CreditCard.SecurityCode`	Código de segurança no verso do cartão de crédito.	texto
`Payment.CreditCard.Brand`	Bandeira do cartão de crédito.	texto
`Payment.CreditCard.SaveCard`	Indica se os dados do cartão de crédito foram armazenados no Cartão Protegido.	booleano
`Payment.CreditCard.Alias`	Alias (apelido) do cartão de crédito salvo no Cartão Protegido.	texto
`Payment.CreditCard.CardToken`	Identificador do cartão de crédito salvo no Cartão Protegido.	GUID
`Payment.FraudAnalysis.Sequence`	Tipo de fluxo da análise de fraude.	texto
`Payment.FraudAnalysis.SequenceCriteria`	Critério do fluxo da análise de fraude.	texto
`Payment.FraudAnalysis.Provider`	Provedor de Antifraude.	texto
`Payment.FraudAnalysis.CaptureOnLowRisk`	Indica se a transação após a análise de fraude será capturada.	booleano
`Payment.FraudAnalysis.VoidOnHighRisk`	Indica se a transação após a análise de fraude será cancelada.	booleano
`Payment.FraudAnalysis.TotalOrderAmount`	Valor total do pedido, em centavos.	número
`Payment.FraudAnalysis.FingerPrintId`	Identificador utilizado para cruzar informações obtidas do dispositivo do comprador.	texto
`Payment.FraudAnalysis.Browser.HostName`	Nome do host informado pelo browser do comprador e identificado através do cabeçalho HTTP.	texto
`Payment.FraudAnalysis.Browser.CookiesAccepted`	Identifica se o browser do comprador aceita cookies.	booleano
`Payment.FraudAnalysis.Browser.Email`	E-mail registrado no browser do comprador. Pode ser diferente do e-mail de cadastro na loja (`Customer.Email`).	texto
`Payment.FraudAnalysis.Browser.Type`	Nome do browser utilizado pelo comprador e identificado através do cabeçalho HTTP.	texto
`Payment.FraudAnalysis.Browser.IpAddress`	Endereço de IP do comprador. Formato IPv4 ou IPv6.	texto
`Payment.FraudAnalysis.Cart.IsGift`	Indica se o pedido realizado pelo comprador é para presente.	booleano
`Payment.FraudAnalysis.Cart.ReturnsAccepted`	Indica se o pedido realizado pelo comprador pode ser devolvido à loja.	booleano
`Payment.FraudAnalysis.Cart.Items.GiftCategory`	Identifica a avaliação dos endereços de cobrança e entrega para diferentes cidades, estados ou países.	texto
`Payment.FraudAnalysis.Cart.Items.HostHedge`	Nível de importância dos endereços de IP e e-mail do comprador na análise de fraude.	texto
`Payment.FraudAnalysis.Cart.Items.NonSensicalHedge`	Nível de importância das verificações sobre os dados do comprador sem sentido na análise de fraude.	texto
`Payment.FraudAnalysis.Cart.Items.ObscenitiesHedge`	Nível de importância das verificações sobre os dados do comprador com obscenidade na análise de fraude.	texto
`Payment.FraudAnalysis.Cart.Items.PhoneHedge`	Nível de importância das verificações sobre os números de telefones do comprador na análise de fraude.	texto
`Payment.FraudAnalysis.Cart.Items.Name`	Nome do produto.	texto
`Payment.FraudAnalysis.Cart.Items.Quantity`	Quantidade do produto.	número
`Payment.FraudAnalysis.Cart.Items.Sku`	SKU (Stock Keeping Unit - Unidade de Controle de Estoque) do produto.	texto
`Payment.FraudAnalysis.Cart.Items.UnitPrice`	Preço unitário do produto.	número
`Payment.FraudAnalysis.Cart.Items.Risk`	Nível de risco do produto associado à quantidade de chargebacks.	texto
`Payment.FraudAnalysis.Cart.Items.TimeHedge`	Nível de importância, na análise de fraude, da hora do dia em que o comprador realizou o pedido.	texto
`Payment.FraudAnalysis.Cart.Items.Type`	Categoria do produto.	texto
`Payment.FraudAnalysis.Cart.Items.VelocityHedge`	Nível de importância, na análise de fraude, da frequência de compra do comprador dentro dos 15 minutos anteriores.	texto
`Payment.FraudAnalysis.MerchantDefinedFields.Id`	Id das informações adicionais a serem enviadas.	número
`Payment.FraudAnalysis.MerchantDefinedFields.Value`	Valor das informações adicionais a serem enviadas.	texto
`Payment.FraudAnalysis.Shipping.Addressee`	Nome completo do responsável a receber o produto no endereço de entrega.	texto
`Payment.FraudAnalysis.Shipping.Method`	Meio de entrega do pedido.	texto
`Payment.FraudAnalysis.Shipping.Phone`	Número do telefone do responsável a receber o produto no endereço de entrega.	número
`Payment.FraudAnalysis.Travel.JourneyType`	Tipo de viagem.	texto
`Payment.FraudAnalysis.Travel.DepartureTime`	Data e hora de partida.	datetime
`Payment.FraudAnalysis.Travel.Passengers.Name`	Nome completo do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Identity`	Número do documento do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Status`	Classificação da empresa aérea.	texto
`Payment.FraudAnalysis.Travel.Passengers.Rating`	Tipo do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Email`	E-mail do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Phone`	Telefone do passageiro.	número
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Origin`	Código do aeroporto de partida.	texto
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Destination`	Código do aeroporto de chegada.	texto
`Payment.FraudAnalysis.Id`	Id da transação no Antifraude Braspag.	GUID
`Payment.FraudAnalysis.Status`	Status da transação no Antifraude Braspag. Lista de Valores - Status.	número
`Payment.FraudAnalysis.FraudAnalysisReasonCode`	Código de retorno da Cybersouce. Lista de Valores - FraudAnalysisReasonCode.	número
`Payment.FraudAnalysis.ReplyData.AddressInfoCode`	Códigos indicam incompatibilidades entre os endereços de cobrança e entrega do comprador. Os códigos são concatenados usando o caractere “^”. Ex.: COR-BA^MM-BIN. Lista de Valores - AddressInfoCode.	texto
`Payment.FraudAnalysis.ReplyData.FactorCode`	Códigos que afetaram a pontuação da análise. Os códigos são concatenados usando o caractere “^”. Ex.: B^D^R^Z. Lista de Valores - FactorCode.	texto
`Payment.FraudAnalysis.ReplyData.Score`	Score da análise de fraude. Valor entre 0 e 100.	número
`Payment.FraudAnalysis.ReplyData.BinCountry`	Código do país do BIN do cartão usado na análise. Mais informações em ISO 2-Digit Alpha Country Code.	texto
`Payment.FraudAnalysis.ReplyData.CardIssuer`	Nome do banco ou entidade emissora do cartão de crédito.	texto
`Payment.FraudAnalysis.ReplyData.CardScheme`	Bandeira do cartão.	texto
`Payment.FraudAnalysis.ReplyData.HostSeverity`	Nível de risco do domínio de e-mail do comprador, de 0 a 5, onde 0 é risco indeterminado e 5 representa o risco mais alto.	número
`Payment.FraudAnalysis.ReplyData.InternetInfoCode`	Códigos que indicam problemas com o endereço de e-mail, endereço IP ou endereço de cobrança. Os códigos são concatenados usando o caractere “^”. Ex.: FREE-EM^RISK-EM Lista de Valores - InternetInfoCode.	texto
`Payment.FraudAnalysis.ReplyData.IpRoutingMethod`	Método de roteamento do comprador obtido a partir do endereço de IP. Lista de Valores - IpRoutingMethod.	texto
`Payment.FraudAnalysis.ReplyData.ScoreModelUsed`	Nome do modelo de score utilizado na análise. Caso não tenha nenhum modelo definido, o modelo padrão da Cybersource foi o utilizado.	texto
`Payment.FraudAnalysis.ReplyData.CasePriority`	Define o nível de prioridade das regras ou perfis do lojista. O nível de prioridade varia entre 1 (maior) e 5 (menor). O valor padrão é 3, e é atribuído caso não se tenha definido a prioridade das regras ou perfis. Este campo será retornado somente se a loja for assinante do Enhanced Case Management.	número
`Payment.FraudAnalysis.ReplyData.ProviderTransactionId`	Id da transação na Cybersource.	texto
`Payment.PaymentId`	Identificador da transação no Pagador Braspag.	GUID
`Payment.AcquirerTransactionId`	Identificador da transação na adquirente.	texto
`Payment.ProofOfSale`	Número do comprovante de venda na adquirente (NSU - Número Sequencial Único).	texto
`Payment.AuthorizationCode`	Código de autorização na adquirente.	texto
`Payment.ReceivedDate`	Data em que a transação foi recebida no Pagador Braspag. Ex.: 2018-01-16 16:38:19.	datetime
`Payment.CapturedDate`	Data em que a transação foi capturada na adquirente. Ex.: 2018-01-16 16:38:20.	datetime
`Payment.CapturedAmount`	Valor capturado da transação, em centavos. Ex.: 123456 = R$ 1.234,56.	número
`Payment.ECI`	Electronic Commerce Indicator. Código gerado em uma transação de crédito com autenticação externa.	texto
`Payment.ReasonCode`	Código de retorno da operação.	texto
`Payment.ReasonMessage`	Mensagem de retorno da operação.	texto
`Payment.Status`	Status da transação no Pagador. Veja a lista completa de Status da Transação.	Número
`Payment.ProviderReturnCode`	Código retornado pela adquirente ou emissor.	texto
`Payment.ProviderReturnMessage`	Mensagem retornada pela adquirente ou emissor.	texto

Fingerprint com a Cybersource

O Fingerprint é a identificação digital do dispositivo do comprador. Essa identificação é composta por uma série de dados coletados na página de checkout do site ou aplicativo.

Na integração da API do Pagador com análise de fraude, o valor do ProviderIdentifier deve ser enviado no parâmetro Payment.FraudAnalisys.FingerPrintId.

Para configurar o Fingerprint com a Cybersource, consulte o manual do Antifraude Gateway.

Implementando a Análise ACI Worldwide

Na requisição de análise de fraude com a ACI Worldwide, envie o campo Payment.FraudAnalysis.Provider como “RedShield”.

Requisição

{  
   "MerchantOrderId":"123456",
   "Customer":{  
      "Name":"Comprador Teste",
      "Identity":"12345678910",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "Phone": "5521976781114",
      "mobile": "5511940028922",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":true,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"455184******0181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2028",
         "SecurityCode":"***",
         "Brand":"Visa",
         "SaveCard":"true"
      },
      "FraudAnalysis":{  
         "Sequence":"AnalyseFirst",
         "SequenceCriteria":"OnSuccess",
         "Provider":"RedShield",
         "CaptureOnLowRisk":false,
         "VoidOnHighRisk":false,
         "TotalOrderAmount":10000,
         "FingerPrintId":"074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2",
         "Browser":{  
            "CookiesAccepted":true,
            "IpAddress":"127.0.0.1"
         },
         "Cart":{  
            "IsGift":true,
            "ReturnsAccepted":true,
            "Items":[  
               {  
                  "Name":"ItemTeste1",
                  "Quantity":2,
                  "Sku":"20170511",
                  "UnitPrice":20000
               },
               {  
                  "Name":"ItemTeste2",
                  "Quantity":1,
                  "Sku":"20170512",
                  "UnitPrice":10000
               }
            ]
         },
         "MerchantDefinedFields":[  
            {  
               "Id":26,
               "Value":"nomedousuario"
            },
            {  
               "Id":27,
               "Value":"120"
            },
            {  
               "Id":28,
               "Value":"12"
            },
            {  
               "Id":29,
               "Value":"WEB"
            }
         ],
         "Shipping":{
            "Addressee":"Nome do destinatario",
            "Method":"LowCost",
            "Phone":"551121840540"
         },
         "Travel":{  
            "JourneyType":"OneWayTrip",
            "DepartureTime":"2018-01-09 18:00",
            "Passengers":[  
               {  
                  "Name":"Passenger Test",
                  "Identity":"212424808",
                  "Status":"Gold",
                  "Rating":"Adult",
                  "Email":"email@mail.com",
                  "Phone":"5564991681074",
                  "TravelLegs":[  
                     {  
                        "Origin":"AMS",
                        "Destination":"GIG"
                     }
                  ]
               }
            ]
         }
      }
   }
}

{  
   "MerchantOrderId":"123456",
   "Customer":{  
      "Name":"Comprador Teste",
      "Identity":"12345678910",
      "IdentityType":"CPF",
      "Email":"comprador@braspag.com.br",
      "Birthdate":"1991-01-02",
      "Phone": "5521976781114",
      "mobile": "5511940028922",
      "Address":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      },
      "DeliveryAddress":{  
         "Street":"Alameda Xingu",
         "Number":"512",
         "Complement":"27 andar",
         "ZipCode":"12345987",
         "City":"São Paulo",
         "State":"SP",
         "Country":"BR",
         "District":"Alphaville"
      }
   },
   "Payment":{  
      "Provider":"Simulado",
      "Type":"CreditCard",
      "Amount":10000,
      "Currency":"BRL",
      "Country":"BRA",
      "Installments":1,
      "Interest":"ByMerchant",
      "Capture":true,
      "Authenticate":false,
      "Recurrent":true,
      "SoftDescriptor":"Mensagem",
      "DoSplit":false,
      "CreditCard":{  
         "CardNumber":"455184******0181",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2028",
         "SecurityCode":"***",
         "Brand":"Visa",
         "SaveCard":"true"
      },
      "FraudAnalysis":{  
         "Sequence":"AnalyseFirst",
         "SequenceCriteria":"OnSuccess",
         "Provider":"RedShield",
         "CaptureOnLowRisk":false,
         "VoidOnHighRisk":false,
         "TotalOrderAmount":10000,
         "FingerPrintId":"074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2",
         "Browser":{  
            "CookiesAccepted":true,
            "IpAddress":"127.0.0.1"
         },
         "Cart":{  
            "IsGift":true,
            "ReturnsAccepted":true,
            "Items":[  
               {  
                  "Name":"ItemTeste1",
                  "Quantity":2,
                  "Sku":"20170511",
                  "UnitPrice":20000
               },
               {  
                  "Name":"ItemTeste2",
                  "Quantity":1,
                  "Sku":"20170512",
                  "UnitPrice":10000
               }
            ]
         },
         "MerchantDefinedFields":[  
            {  
               "Id":26,
               "Value":"nomedousuario"
            },
            {  
               "Id":27,
               "Value":"120"
            },
            {  
               "Id":28,
               "Value":"12"
            },
            {  
               "Id":29,
               "Value":"WEB"
            }
         ],
         "Shipping":{
            "Addressee":"Nome do destinatario",
            "Method":"LowCost",
            "Phone":"551121840540"
         },
         "Travel":{  
            "JourneyType":"OneWayTrip",
            "DepartureTime":"2018-01-09 18:00",
            "Passengers":[  
               {  
                  "Name":"Passenger Test",
                  "Identity":"212424808",
                  "Status":"Gold",
                  "Rating":"Adult",
                  "Email":"email@mail.com",
                  "Phone":"5564991681074",
                  "TravelLegs":[  
                     {  
                        "Origin":"AMS",
                        "Destination":"GIG"
                     }
                  ]
               }
            ]
         }
      }
   }
}
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantOrderId`	Número do pedido da loja.	texto	50	Sim
`Customer.Name`	Nome completo do comprador.	texto	120	Sim
`Customer.Identity`	Número do documento de identificação do comprador.	texto	16	Sim
`Customer.IdentityType`	Tipo de documento de identificação do comprador. Possíveis valores: “CPF” ou “CNPJ”.	texto	255	Não
`Customer.Email`	E-mail do comprador.	texto	100	Sim
`Customer.Birthdate`	Data de nascimento do comprador. Ex.: 1991-01-10.	data	10	Sim
`Customer.Phone`	Número do telefone do comprador. Ex.: 5521976781114.	texto	15	Sim
`Customer.Mobile`	Número do telefone celular do comprador. Ex.: 5521976781114.	texto	15	Sim
`Customer.Address.Street`	Logradouro do endereço de cobrança.	texto	54	Sim
`Customer.Address.Number`	Número do endereço de cobrança.	texto	5	Sim
`Customer.Address.Complement`	Complemento do endereço de cobrança.	texto	14	Não
`Customer.Address.ZipCode`	CEP do endereço de cobrança.	texto	9	Sim
`Customer.Address.City`	Cidade do endereço de cobrança.	texto	50	Sim
`Customer.Address.State`	Estado do endereço de cobrança.	texto	2	Sim
`Customer.Address.Country`	País do endereço de cobrança. Mais informações em ISO 2-Digit Alpha Country Code.	texto	2	Sim
`Customer.Address.District`	Bairro do endereço de cobrança.	texto	45	Sim
`Customer.DeliveryAddress.Street`	Logradouro do endereço de entrega.	texto	54	Não
`Customer.DeliveryAddress.Number`	Número do endereço de entrega.	texto	5	Não
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega.	texto	14	Não
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega.	texto	9	Não
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega.	texto	50	Não
`Customer.DeliveryAddress.State`	Estado do endereço de entrega.	texto	2	Não
`Customer.DeliveryAddress.Country`	País do endereço de entrega. Mais informações em ISO 2-Digit Alpha Country Code.	texto	2	Não
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega.	texto	45	Não
`Payment.Provider`	Nome do provedor da autorização.	texto	15	Sim
`Payment.Type`	Tipo do meio de pagamento. Obs.: Somente o tipo “CreditCard” funciona com análise de fraude.	texto	100	Sim
`Payment.Amount`	Valor da transação financeira, em centavos. Ex.: 150000 = R$ 1.500,00.	número	15	Sim
`Payment.Currency`	Moeda na qual o pagamento será feito. Possíveis valores: “BRL” / “USD” / “MXN” / “COP” / “CLP” / “ARS” / “PEN” / “EUR” / “PYN” / “UYU” / “VEB” / “VEF” / “GBP”.	texto	3	Não
`Payment.Country`	País na qual o pagamento será realizado.	texto	3	Não
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.Interest`	Tipo de parcelamento. Possíveis valores: “ByMerchant” (loja) / “ByIssuer” (emissor).	texto	10	Não
`Payment.Capture`	Indica se a autorização deverá ser com captura automática. Possíveis valores: “true” / “false” (default). Obs1.: Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. Obs2.: Este campo deverá ser preenchido de acordo com o fluxo da análise de fraude.	booleano	—	Não
`Payment.Authenticate`	Indica se a transação deve ser autenticada. Possíveis valores: “true” / “false” (default). Obs1.: Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. Obs2. O campo `Payment.Recurrent` deve ser igual a “true” quando este for igual a “false”.	booleano	—	Não
`Payment.Recurrent`	Indica se a transação é do tipo recorrente. Possíveis valores: “true” / “false” (default). Obs1.: Este campo igual a “true” não irá criar uma recorrência; apenas permitirá a realização de uma transação sem a necessidade de envio do CVV, indicando para a adquirente que é a cobrança de uma transação de uma recorrência. Obs2.: Somente para transações Cielo. Obs3.: O campo `Payment.Authenticate` deve ser igual a “false” quando este for igual a “true”.	booleano	—	Não
`Payment.SoftDescriptor`	Texto que será impresso na fatura do portador. Obs.: O valor deste campo deve tornar fácil para o portador a identificação do estabelecimento onde foi realizada a compra, pois é um dos principais ofensores para chargeback.	texto	13	Não
`Payment.DoSplit`	Indica se a transação será dividida entre vários participantes. Possíveis valores: “true” / “false” (default). Para utilizar a funcionalidade de split de pagamentos, é necessário a contratação da solução junto à Braspag.	booleano	—	Não
`Payment.CreditCard.CardNumber`	Número do cartão de crédito.	texto	19	Sim
`Payment.CreditCard.Holder`	Nome do portador impresso no cartão de crédito. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`Payment.CreditCard.ExpirationDate`	Data de validade do cartão de crédito.	texto	7	Sim
`Payment.CreditCard.SecurityCode`	Código de segurança no verso do cartão de crédito.	texto	4	Sim
`Payment.CreditCard.Brand`	Bandeira do cartão de crédito.	texto	10	Sim
`Payment.CreditCard.SaveCard`	Indica se os dados do cartão de crédito serão armazenados no Cartão Protegido.	booleano	—	Não
`Payment.FraudAnalysis.Sequence`	Tipo de fluxo da análise de fraude. Possíveis valores: “AnalyseFirst” / “AuthorizeFirst”.	texto	14	Sim
`Payment.FraudAnalysis.SequenceCriteria`	Critério do fluxo da análise de fraude. Possíveis valores: “OnSuccess” / “Always”.	texto	9	Sim
`Payment.FraudAnalysis.Provider`	Provedor de Antifraude. Valor possível para o provedor ACI Worldwide: “RedShield”.	texto	10	Sim
`Payment.FraudAnalysis.CaptureOnLowRisk`	Indica se a transação após a análise de fraude será capturada. Possíveis valores: “true” / “false” (default) Obs1.: Quando enviado igual a “true” e o retorno da análise de fraude for de baixo risco (“Accept”), a transação anteriormente autorizada será capturada. Obs2.: Quando enviado igual a “true” e o retorno da análise de fraude for revisão (“Review”), a transação ficará autorizada, sendo capturada após a Braspag receber notificação de alteração do status para baixo risco (“Accept”). Obs3.: Para a utilização deste parâmetro, a sequência do fluxo de análise de risco (`FraudAnalysis.Sequence`) deve ser obrigatoriamente “AuthorizeFirst”.	booleano	—	Não
`Payment.FraudAnalysis.VoidOnHighRisk`	Indica se a transação após a análise de fraude será cancelada. Possíveis valores: “true” / “false” (default). Obs1.: Quando enviado igual a “true” e o retorno da análise de fraude for de alto risco (“Reject”), a transação anteriormente autorizada será cancelada. Obs2.: Quando enviado igual a “true” e o retorno da análise de fraude for revisão (“Review”), a transação ficará autorizada, sendo cancelada após a Braspag receber notificação de alteração do status para alto risco (“Reject”). Obs3.: Para a utilização deste parâmetro, a sequência do fluxo de análise de risco (`FraudAnalysis.Sequence`) deve ser obrigatoriamente “AuthorizeFirst”.	booleano	—	Não
`Payment.FraudAnalysis.TotalOrderAmount`	Valor total do pedido, em centavos. Ex.: 123456 = R$ 1.234,56.	número	15	Sim
`Payment.FraudAnalysis.FingerPrintId`	Identificador utilizado para cruzar informações obtidas do dispositivo do comprador. Este mesmo identificador deve ser utilizado para gerar o valor que será atribuído ao campo `session_id` do script que será incluído na página de checkout. Obs.: Este identificador poderá ser qualquer valor ou o número do pedido, mas deverá ser único durante 48 horas.	texto	88	Sim
`Payment.FraudAnalysis.Browser.CookiesAccepted`	Identifica se o browser do comprador aceita cookies. Possíveis valores: “true” / “false” (default).	booleano	—	Sim
`Payment.FraudAnalysis.Browser.IpAddress`	Endereço de IP do comprador. Formato IPv4 ou IPv6.	texto	45	Sim
`Payment.FraudAnalysis.Cart.IsGift`	Indica se o pedido realizado pelo comprador é para presente.	booleano	—	Não
`Payment.FraudAnalysis.Cart.ReturnsAccepted`	Indica se o pedido realizado pelo comprador pode ser devolvido à loja. Possíveis valores: “true” / “false” (default).	booleano	—	Não
`Payment.FraudAnalysis.Cart.Items.Name`	Nome do produto.	texto	255	Sim
`Payment.FraudAnalysis.Cart.Items.Quantity`	Quantidade do produto.	número	15	Sim
`Payment.FraudAnalysis.Cart.Items.Sku`	SKU (Stock Keeping Unit - Unidade de Controle de Estoque) do produto.	texto	255	Sim
`Payment.FraudAnalysis.Cart.Items.UnitPrice`	Preço unitário do produto, em centavos. Ex.: 10950 = R$ 109,50.	número	15	Sim
`Payment.FraudAnalysis.MerchantDefinedFields.Id`	Id das informações adicionais a serem enviadas. Tabela de MDDs.	número	2	Sim
`Payment.FraudAnalysis.MerchantDefinedFields.Value`	Valor das informações adicionais a serem enviadas. Tabela de MDDs.	texto	255	Sim
`Payment.FraudAnalysis.Shipping.Addressee`	Nome completo do responsável a receber o produto no endereço de entrega.	texto	120	Não
`Payment.FraudAnalysis.Shipping.Method`	Meio de entrega do pedido. Lista de Valores - Method.	texto	8	Não
`Payment.FraudAnalysis.Shipping.Phone`	Número do telefone do responsável a receber o produto no endereço de entrega. Ex.: 552121114700.	texto	15	Não
`Payment.FraudAnalysis.Travel.JourneyType`	Tipo de viagem. Lista de Valores - JourneyType.	texto	32	Não*
`Payment.FraudAnalysis.Travel.DepartureTime`	Data e hora de partida. Ex.: 2018-03-31 19:16:38.	datetime	—	Não*
`Payment.FraudAnalysis.Travel.Passengers.Name`	Nome completo do passageiro.	texto	120	Não*
`Payment.FraudAnalysis.Travel.Passengers.Identity`	Número do documento do passageiro.	texto	32	Não*
`Payment.FraudAnalysis.Travel.Passengers.Status`	Classificação da empresa aérea. Lista de Valores - Status.	texto	15	Não*
`Payment.FraudAnalysis.Travel.Passengers.Rating`	Tipo do passageiro. Lista de Valores - Rating.	texto	13	Não*
`Payment.FraudAnalysis.Travel.Passengers.Email`	E-mail do passageiro.	texto	255	Não*
`Payment.FraudAnalysis.Travel.Passengers.Phone`	Telefone do passageiro. Ex.: 552121114700.	texto	15	Não*
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Origin`	Código do aeroporto de partida. Mais informações em IATA 3-Letter Codes.	texto	3	Não*
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Destination`	Código do aeroporto de chegada. Mais informações em IATA 3-Letter Codes.	texto	3	Não*

Resposta

{
    "MerchantOrderId": "123456",
    "Customer": {
        "Name": "Comprador Teste",
        "Identity": "12345678910",
        "IdentityType": "CPF",
        "Email": "comprador@braspag.com.br",
        "Phone": "5521976781114",
        "Birthdate": "1991-01-02",
        "Address": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        },
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        },
        "Mobile": "5511940028922"
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": true,
        "CreditCard": {
            "CardNumber": "455184******0181",
            "Holder": "Nome do Portador",
            "ExpirationDate": "12/2028",
            "SaveCard": true,
            "Brand": "Visa"
        },
        "ProofOfSale": "836045",
        "AcquirerTransactionId": "0527060143139",
        "AuthorizationCode": "095614",
        "SoftDescriptor": "Mensagem",
        "SentOrderId": "20220527180141FEC711",
        "FraudAnalysis": {
            "Sequence": "AnalyseFirst",
            "SequenceCriteria": "OnSuccess",
            "FingerPrintId": "074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2",
            "Provider": "RedShield",
            "CaptureOnLowRisk": false,
            "VoidOnHighRisk": false,
            "TotalOrderAmount": 10000,
            "IsRetryTransaction": false,
            "MerchantDefinedFields": [
                {
                    "Id": "26",
                    "Value": "nomedousuario"
                },
                {
                    "Id": "27",
                    "Value": "120"
                },
                {
                    "Id": "28",
                    "Value": "12"
                },
                {
                    "Id": "29",
                    "Value": "WEB"
                }
            ],
            "Cart": {
                "IsGift": true,
                "ReturnsAccepted": true,
                "Items": [
                    {
                        "Name": "ItemTeste1",
                        "Sku": "20170511",
                        "UnitPrice": 20000,
                        "Quantity": 2
                    },
                    {
                        "Name": "ItemTeste2",
                        "Sku": "20170512",
                        "UnitPrice": 10000,
                        "Quantity": 1
                    }
                ]
            },
            "Travel": {
                "DepartureTime": "2018-01-09T18:00:00",
                "JourneyType": "OneWayTrip",
                "Passengers": [
                    {
                        "Name": "Passenger Test",
                        "Identity": "212424808",
                        "Status": "Gold",
                        "Rating": "Adult",
                        "Email": "email@mail.com",
                        "Phone": "5564991681074",
                        "TravelLegs": [
                            {
                                "Destination": "GIG",
                                "Origin": "AMS"
                            }
                        ]
                    }
                ]
            },
            "Browser": {
                "CookiesAccepted": true,
                "IpAddress": "127.0.0.1"
            },
            "Shipping": {
                "Addressee": "Nome do destinatario",
                "Phone": "551121840540",
                "Method": "LowCost"
            },
            "Id": "3c31b840-30f0-49a5-40c1-08da39ba639e",
            "Status": 1,
            "StatusDescription": "Accept",
            "ReplyData": {
                "FactorCode": "000.000.000",
                "ProviderTransactionId": "153322379407",
                "ReturnMessage": "Transaction succeeded",
                "ProviderOrderId": "000591000001XAA20220527170142439",
                "ReturnCode": "0100"
            }
        },
        "DoSplit": false,
        "PaymentId": "b705b792-e5c0-4386-9f44-b07a791fb972",
        "Type": "CreditCard",
        "Amount": 10000,
        "ReceivedDate": "2022-05-27 18:01:41",
        "CapturedAmount": 10000,
        "CapturedDate": "2022-05-27 18:01:43",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Simulado",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 2,
        "ProviderReturnCode": "6",
        "ProviderReturnMessage": "Operation Successful",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/b705b792-e5c0-4386-9f44-b07a791fb972"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/b705b792-e5c0-4386-9f44-b07a791fb972/void"
            }
        ]
    }
}

{
    "MerchantOrderId": "123456",
    "Customer": {
        "Name": "Comprador Teste",
        "Identity": "12345678910",
        "IdentityType": "CPF",
        "Email": "comprador@braspag.com.br",
        "Phone": "5521976781114",
        "Birthdate": "1991-01-02",
        "Address": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        },
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        },
        "Mobile": "5511940028922"
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": true,
        "Authenticate": false,
        "Recurrent": true,
        "CreditCard": {
            "CardNumber": "455184******0181",
            "Holder": "Nome do Portador",
            "ExpirationDate": "12/2028",
            "SaveCard": true,
            "Brand": "Visa"
        },
        "ProofOfSale": "836045",
        "AcquirerTransactionId": "0527060143139",
        "AuthorizationCode": "095614",
        "SoftDescriptor": "Mensagem",
        "SentOrderId": "20220527180141FEC711",
        "FraudAnalysis": {
            "Sequence": "AnalyseFirst",
            "SequenceCriteria": "OnSuccess",
            "FingerPrintId": "074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2074c1ee676ed4998ab66491013c565e2",
            "Provider": "RedShield",
            "CaptureOnLowRisk": false,
            "VoidOnHighRisk": false,
            "TotalOrderAmount": 10000,
            "IsRetryTransaction": false,
            "MerchantDefinedFields": [
                {
                    "Id": "26",
                    "Value": "nomedousuario"
                },
                {
                    "Id": "27",
                    "Value": "120"
                },
                {
                    "Id": "28",
                    "Value": "12"
                },
                {
                    "Id": "29",
                    "Value": "WEB"
                }
            ],
            "Cart": {
                "IsGift": true,
                "ReturnsAccepted": true,
                "Items": [
                    {
                        "Name": "ItemTeste1",
                        "Sku": "20170511",
                        "UnitPrice": 20000,
                        "Quantity": 2
                    },
                    {
                        "Name": "ItemTeste2",
                        "Sku": "20170512",
                        "UnitPrice": 10000,
                        "Quantity": 1,
                    }
                ]
            },
            "Travel": {
                "DepartureTime": "2018-01-09T18:00:00",
                "JourneyType": "OneWayTrip",
                "Passengers": [
                    {
                        "Name": "Passenger Test",
                        "Identity": "212424808",
                        "Status": "Gold",
                        "Rating": "Adult",
                        "Email": "email@mail.com",
                        "Phone": "5564991681074",
                        "TravelLegs": [
                            {
                                "Destination": "GIG",
                                "Origin": "AMS"
                            }
                        ]
                    }
                ]
            },
            "Browser": {
                "CookiesAccepted": true,
                "IpAddress": "127.0.0.1"
            },
            "Shipping": {
                "Addressee": "Nome do destinatario",
                "Phone": "551121840540",
                "Method": "LowCost"
            },
            "Id": "3c31b840-30f0-49a5-40c1-08da39ba639e",
            "Status": 1,
            "StatusDescription": "Accept",
            "ReplyData": {
                "FactorCode": "000.000.000",
                "ProviderTransactionId": "153322379407",
                "ReturnMessage": "Transaction succeeded",
                "ProviderOrderId": "000591000001XAA20220527170142439",
                "ReturnCode": "0100"
            }
        },
        "DoSplit": false,
        "PaymentId": "b705b792-e5c0-4386-9f44-b07a791fb972",
        "Type": "CreditCard",
        "Amount": 10000,
        "ReceivedDate": "2022-05-27 18:01:41",
        "CapturedAmount": 10000,
        "CapturedDate": "2022-05-27 18:01:43",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Simulado",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 2,
        "ProviderReturnCode": "6",
        "ProviderReturnMessage": "Operation Successful",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/b705b792-e5c0-4386-9f44-b07a791fb972"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/b705b792-e5c0-4386-9f44-b07a791fb972/void"
            }
        ]
    }
}

Propriedade	Descrição	Tipo
`MerchantOrderId`	Número do pedido da loja.	texto
`Customer.Name`	Nome completo do comprador.	texto
`Customer.Identity`	Número do documento de identificação do comprador.	texto
`Customer.IdentityType`	Tipo de documento de identificação do comprador.	texto
`Customer.Email`	E-mail do comprador.	texto
`Customer.Birthdate`	Data de nascimento do comprador.	data
`Customer.Phone`	Número do telefone do comprador.	texto
`Customer.Address.Street`	Logradouro do endereço de cobrança.	texto
`Customer.Address.Number`	Número do endereço de cobrança.	texto
`Customer.Address.Complement`	Complemento do endereço de cobrança.	texto
`Customer.Address.ZipCode`	CEP do endereço de cobrança.	texto
`Customer.Address.City`	Cidade do endereço de cobrança.	texto
`Customer.Address.State`	Estado do endereço de cobrança.	texto
`Customer.Address.Country`	País do endereço de cobrança.	texto
`Customer.Address.District`	Bairro do endereço de cobrança.	texto
`Customer.Address.AddressType`	Tipo do endereço de cobrança.	texto
`Customer.DeliveryAddress.Street`	Logradouro do endereço de entrega.	texto
`Customer.DeliveryAddress.Number`	Número do endereço de entrega.	texto
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega.	texto
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega.	texto
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega.	texto
`Customer.DeliveryAddress.State`	Estado do endereço de entrega.	texto
`Customer.DeliveryAddress.Country`	País do endereço de entrega.	texto
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega.	texto
`Customer.DeliveryAddress.AddressType`	Tipo do endereço de entrega.	texto
`Customer.Mobile`	Número do telefone celular do comprador.	texto
`Payment.ServiceTaxAmount`	Montante do valor da autorização que deve ser destinado à taxa de serviço.	número
`Payment.Installments`	Número de parcelas.	número
`Payment.Interest`	Tipo de parcelamento.	texto
`Payment.Capture`	Indica se a autorização deverá ser com captura automática.	booleano
`Payment.Authenticate`	Indica se a transação deve ser autenticada.	booleano
`Payment.Recurrent`	Indica se a transação é do tipo recorrente.	booleano
`Payment.CreditCard.CardNumber`	Número do cartão de crédito truncado.	texto
`Payment.CreditCard.Holder`	Nome do portador impresso no cartão de crédito.	texto
`Payment.CreditCard.ExpirationDate`	Data de validade do cartão de crédito.	texto
`Payment.CreditCard.SaveCard`	Indica se os dados do cartão de crédito foram armazenados no Cartão Protegido.	booleano
`Payment.CreditCard.Brand`	Bandeira do cartão de crédito.	texto
`Payment.ProofOfSale`	Número do comprovante de venda na adquirente (NSU - Número Sequencial Único).	texto
`Payment.AcquirerTransactionId`	Identificador da transação na adquirente.	texto
`Payment.AuthorizationCode`	Código de autorização na adquirente.	texto
`Payment.SoftDescriptor`	Texto que será impresso na fatura do portador.	texto
`Payment.SentOrderId`	Número adicional ao MerchantOrderId gerado para o pedido e utilizado durante a transação. Esse número (SentOrderId) só será diferente em caso de adequação a regras da adquirente ou em caso de números de identificação do pedido (MerchantOrderId) repetidos.	texto
`Payment.FraudAnalysis.Sequence`	Tipo de fluxo da análise de fraude.	texto
`Payment.FraudAnalysis.SequenceCriteria`	Critério do fluxo da análise de fraude.	texto
`Payment.FraudAnalysis.FingerPrintId`	Identificador utilizado para cruzar informações obtidas do dispositivo do comprador.	texto
`Payment.FraudAnalysis.Provider`	Provedor de Antifraude.	texto
`Payment.FraudAnalysis.CaptureOnLowRisk`	Indica se a transação após a análise de fraude será capturada.	booleano
`Payment.FraudAnalysis.VoidOnHighRisk`	Indica se a transação após a análise de fraude será cancelada.	booleano
`Payment.FraudAnalysis.TotalOrderAmount`	Valor total do pedido, em centavos.	número
`Payment.FraudAnalysis.IsRetryTransaction`	Retentativa de uma análise, e deverá ser enviado com valor igual a TRUE quando o código de retorno na primeira tentativa for igual a BP900	booleano
`Payment.FraudAnalysis.MerchantDefinedFields.Id`	Id das informações adicionais a serem enviadas.	número
`Payment.FraudAnalysis.MerchantDefinedFields.Value`	Valor das informações adicionais a serem enviadas.	texto
`Payment.FraudAnalysis.Cart.IsGift`	Indica se o pedido realizado pelo comprador é para presente.	booleano
`Payment.FraudAnalysis.Cart.ReturnsAccepted`	Indica se o pedido realizado pelo comprador pode ser devolvido à loja.	booleano
`Payment.FraudAnalysis.Cart.Items.Name`	Nome do produto.	texto
`Payment.FraudAnalysis.Cart.Items.Sku`	SKU (Stock Keeping Unit - Unidade de Controle de Estoque) do produto.	texto
`Payment.FraudAnalysis.Cart.Items.UnitPrice`	Preço unitário do produto.	número
`Payment.FraudAnalysis.Cart.Items.Quantity`	Quantidade do produto.	número
`Payment.FraudAnalysis.Travel.DepartureTime`	Data e hora de partida.	datetime
`Payment.FraudAnalysis.Travel.JourneyType`	Tipo de viagem.	texto
`Payment.FraudAnalysis.Travel.Passengers.Name`	Nome completo do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Identity`	Número do documento do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Status`	Classificação da empresa aérea.	texto
`Payment.FraudAnalysis.Travel.Passengers.Rating`	Tipo do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Email`	E-mail do passageiro.	texto
`Payment.FraudAnalysis.Travel.Passengers.Phone`	Telefone do passageiro.	número
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Destination`	Código do aeroporto de chegada.	texto
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Origin`	Código do aeroporto de partida.	texto
`Payment.FraudAnalysis.Browser.CookiesAccepted`	Identifica se o browser do comprador aceita cookies.	booleano
`Payment.FraudAnalysis.Browser.IpAddress`	Endereço de IP do comprador. Formato IPv4 ou IPv6.	texto
`Payment.FraudAnalysis.Shipping.Addressee`	Nome completo do responsável a receber o produto no endereço de entrega.	texto
`Payment.FraudAnalysis.Shipping.Phone`	Número do telefone do responsável a receber o produto no endereço de entrega.	número
`Payment.FraudAnalysis.Shipping.Method`	Meio de entrega do pedido.	texto
`Payment.FraudAnalysis.Id`	Id da transação no Antifraude Braspag.	GUID
`Payment.FraudAnalysis.Status`	Status da transação no Antifraude Braspag. Lista de Valores - Status.	número
`Payment.FraudAnalysis.StatusDescription`	Descrição do status	texto
`Payment.FraudAnalysis.ReplyData.FactorCode`	Códigos que afetaram a pontuação da análise. Os códigos são concatenados usando o caractere “^”. Ex.: B^D^R^Z. Lista de Valores - FactorCode.	texto
`Payment.FraudAnalysis.ReplyData.ProviderTransactionId`	Id da transação na ACI Worldwide.	texto
`Payment.FraudAnalysis.ReplyData.ReturnMessage`	Mensagem retornada pelo provedor de Antifraude	texto
`Payment.FraudAnalysis.ReplyData.ProviderOrderId`	Id do pedido na ACI Worldwide	texto
`Payment.FraudAnalysis.ReplyData.ReturnCode`	Código retornado pelo provedor do meio de pagamento (adquirente ou emissor).	texto
`Payment.DoSplit`	Indica se a transação será dividida entre vários participantes.	booleano
`Payment.PaymentId`	Identificador da transação no Pagador Braspag.	GUID
`Payment.Type`	Tipo do meio de pagamento. Obs.: Somente o tipo “CreditCard” funciona com análise de fraude.	texto
`Payment.Amount`	Valor da transação financeira, em centavos. Ex.: 150000 = R$ 1.500,00.	texto
`Payment.ReceivedDate`	Data em que a transação foi recebida no Pagador Braspag. Ex.: 2018-01-16 16:38:19.	datetime
`Payment.CapturedAmount`	Valor capturado da transação, em centavos. Ex.: 123456 = R$ 1.234,56.	número
`Payment.CapturedDate`	Data em que a transação foi capturada na adquirente. Ex.: 2018-01-16 16:38:20.	datetime
`Payment.Currency`	Moeda na qual o pagamento será feito. Possíveis valores: “BRL” / “USD” / “MXN” / “COP” / “CLP” / “ARS” / “PEN” / “EUR” / “PYN” / “UYU” / “VEB” / “VEF” / “GBP”.	Não
`Payment.Country`	País no qual o pagamento será realizado.	texto
`Payment.Provider`	Nome do provedor da autorização.	texto
`Payment.ReasonCode`	Código de retorno da operação.	texto
`Payment.ReasonMessage`	Mensagem de retorno da operação.	texto
`Payment.Status`	Status da transação no Pagador. Veja a lista completa de Status da Transação.	número
`Payment.ProviderReturnCode`	Código retornado pela adquirente ou emissor.	texto
`Payment.ProviderReturnMessage`	Mensagem retornada pela adquirente ou emissor.	texto

Fingerprint com a ACI

O Fingerprint é a identificação digital do dispositivo do comprador. Essa identificação é composta por uma série de dados coletados na página de checkout do site ou aplicativo. Para configurar o Fingerprint com a ACI, consulte o manual do Antifraude Gateway.

Implementando a Análise ClearSale

Na requisição de análise de fraude com a ClearSale, envie o campo Payment.FraudAnalysis.Provider como “ClearSale”.

Requisição

{
    "MerchantOrderId": 9094008,
    "Customer": {
        "Name": "Bruno Silva",
        "Identity": "11111111111",
        "IdentityType": "CPF",
        "Email": "nome@email.com.br",
        "Birthdate": "1996-11-14",
        "Phone": "+55 11 5555-1001",
        "Mobile": "+55 11 99999-9999",
        "Workphone": "+55 11 5555-2002",
        "Address": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "21 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville"
        },
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville"
        }
    },
    "Payment": {
        "Type": "CreditCard",
        "Provider": "Simulado",
        "Amount": 45500,
        "Installments": 1,
        "Capture": false,
        "Recurrent": false,
        "SoftDescriptor": "Nome fantasia",
        "CreditCard": {
            "CardNumber": "4000021231111111",
            "Holder": "Bruno Silva",
            "ExpirationDate": "08/2033",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "FraudAnalysis": {
            "Provider": "ClearSale",
            "Sequence": "AuthorizeFirst",
            "SequenceCriteria": "OnSuccess",
            "CaptureOnLowRisk": false,
            "VoidOnHighRisk": false,
            "TotalOrderAmount": 100000,
            "FingerPrintId":"MzE5MjAzODg0NA==",
            "Shipping": {
                "Addressee": "Nome do destinatário",
                "Method": "LowCost",
                "Mobile": "+55 11 5555-1003",
                "Identity": "99988877711",
                "IdentityType": "CPF",
                "Street": "Alameda Xingu",
                "Number": "512",
                "Complement": "21 andar",
                "Neighborhood": "Alphaville",
                "City": "Barueri",
                "State": "SP",
                "Country": "BR",
                "ZipCode": "06455030",
                "Email": "nome@email.com.br"
            },
            "Cart": {
                "IsGift": false,
                "ReturnsAccepted": true,
                "Items": [
                    {
                        "Name": "Mouse",
                        "Quantity": 1,
                        "Sku": "100010",
                        "UnitPrice": 50000,
                        "Type": "EletronicGood"
                    },
                    {
                        "Name": "Windows 11 Professional",
                        "Quantity": 2,
                        "Sku": "50000",
                        "UnitPrice": 85515,
                        "Type": "EletronicSoftware"
                    }
                ]
            },
            "Travel": {
                "Passengers": [
                    {
                        "Name": "Bruno Silva",
                        "TravelLegs": [
                            {
                                "Origin": "SDU",
                                "Destination": "CGH",
                                "DepartureDate": "2023-10-10T18:30:00",
                                "Boarding": "2023-10-10T18:45:00",
                                "Arriving": "2023-10-10T20:00:00"
                            }
                        ]
                    },
                    {
                        "Name": "Guilherme Silva",
                        "TravelLegs": [
                            {
                                "Origin": "SDU",
                                "Destination": "CGH",
                                "DepartureDate": "2023-10-010T18:30:00",
                                "Boarding": "2023-10-10T18:45:00",
                                "Arriving": "2023-10-10T20:00:00"
                            }
                        ]
                    }
                ]
            }
        }
    }
}

--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    "MerchantOrderId": 9094008,
    "Customer": {
        "Name": "Bruno Silva",
        "Identity": "11111111111",
        "IdentityType": "CPF",
        "Email": "nome@email.com.br",
        "Birthdate": "1996-11-14",
        "Phone": "+55 11 5555-1001",
        "Mobile": "+55 11 99999-9999",
        "Workphone": "+55 11 5555-2002",
        "Address": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "21 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville"
        },
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville"
        }
    },
    "Payment": {
        "Type": "CreditCard",
        "Provider": "Simulado",
        "Amount": 45500,
        "Installments": 1,
        "Capture": false,
        "Recurrent": false,
        "SoftDescriptor": "Nome fantasia",
        "CreditCard": {
            "CardNumber": "4000021231111111",
            "Holder": "Bruno Silva",
            "ExpirationDate": "08/2033",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "FraudAnalysis": {
            "Provider": "ClearSale",
            "Sequence": "AuthorizeFirst",
            "SequenceCriteria": "OnSuccess",
            "CaptureOnLowRisk": false,
            "VoidOnHighRisk": false,
            "TotalOrderAmount": 100000,
            "FingerPrintId":"MzE5MjAzODg0NA==",
            "Shipping": {
                "Addressee": "Nome do destinatário",
                "Method": "LowCost",
                "Phone": "+55 11 5555-1001",
                "Identity": "99988877711",
                "IdentityType": "CPF",
                "Street": "Alameda Xingu",
                "Number": "512",
                "Complement": "21 andar",
                "Neighborhood": "Alphaville",
                "City": "Barueri",
                "State": "SP",
                "Country": "BR",
                "ZipCode": "06455030",
                "Email": "nome@email.com.br"
            },
            "Cart": {
                "IsGift": false,
                "ReturnsAccepted": true,
                "Items": [
                    {
                        "Name": "Mouse",
                        "Quantity": 1,
                        "Sku": "100010",
                        "UnitPrice": 50000,
                        "Type": "EletronicGood"
                    },
                    {
                        "Name": "Windows 11 Professional",
                        "Quantity": 2,
                        "Sku": "50000",
                        "UnitPrice": 85515,
                        "Type": "EletronicSoftware"
                    }
                ]
            },
            "Travel": {
                "Passengers": [
                    {
                        "Name": "Bruno Silva",
                        "TravelLegs": [
                            {
                                "Origin": "SDU",
                                "Destination": "CGH",
                                "DepartureDate": "2023-10-10T18:30:00",
                                "Boarding": "2023-10-10T18:45:00",
                                "Arriving": "2023-10-10T20:00:00"
                            }
                        ]
                    },
                    {
                        "Name": "Guilherme Silva",
                        "TravelLegs": [
                            {
                                "Origin": "SDU",
                                "Destination": "CGH",
                                "DepartureDate": "2023-10-010T18:30:00",
                                "Boarding": "2023-10-10T18:45:00",
                                "Arriving": "2023-10-10T20:00:00"
                            }
                        ]
                    }
                ]
            }
        }
    }
}

Parâmetros no cabeçalho (header)

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na Braspag.	GUID	36	Sim
`MerchantKey`	Chave pública para autenticação dupla na Braspag.	texto	40	Sim
`RequestId`	Identificador do request definido pela loja.	GUID	36	Não

Parâmetros no corpo (body)

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantOrderId`	Número do pedido da loja.	texto	50	Sim
`Customer.Name`	Nome completo do comprador.	texto	120	Sim
`Customer.Identity`	Número do documento de identificação do comprador.	texto	14	Sim
`Customer.IdentityType`	Tipo de documento de identificação do comprador. Possíveis valores: “CPF” ou “CNPJ”.	texto	255	Não
`Customer.Email`	E-mail do comprador.	texto	100	Sim
`Customer.Birthdate`	Data de nascimento do comprador. Ex.: 1991-01-10.	data	10	Sim
`Customer.Phone`	Telefone residencial. Formato +DDI DDD NNNN-NNNN Exemplo: +55 11 5555-1001. É obrigatório enviar pelo menos um telefone.	string	20	Não*
`Customer.Mobile`	Celular. Formato +DDI DDD NNNNN-NNNN Exemplo: +55 11 99999-9999. É obrigatório enviar pelo menos um telefone.	string	20	Não*
`Customer.Workphone`	Telefone comercial. Formato +DDI DDD NNNN-NNNN Exemplo: +55 11 5555-2002. É obrigatório enviar pelo menos um telefone.	string	20	Não*
`Customer.Address.Street`	Logradouro do endereço de cobrança.	texto	54	Sim
`Customer.Address.Number`	Número do endereço de cobrança.	texto	5	Sim
`Customer.Address.Complement`	Complemento do endereço de cobrança.	texto	14	Não
`Customer.Address.ZipCode`	CEP do endereço de cobrança.	texto	9	Sim
`Customer.Address.City`	Cidade do endereço de cobrança.	texto	50	Sim
`Customer.Address.State`	Estado do endereço de cobrança.	texto	2	Sim
`Customer.Address.Country`	País do endereço de cobrança. Mais informações em ISO 2-Digit Alpha Country Code.	texto	2	Sim
`Customer.Address.District`	Bairro do endereço de cobrança.	texto	45	Sim
`Customer.DeliveryAddress.Street`	Logradouro do endereço de entrega.	texto	54	Não
`Customer.DeliveryAddress.Number`	Número do endereço de entrega.	texto	5	Não
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega.	texto	14	Não
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega.	texto	9	Não
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega.	texto	50	Não
`Customer.DeliveryAddress.State`	Estado do endereço de entrega.	texto	2	Não
`Customer.DeliveryAddress.Country`	País do endereço de entrega. Mais informações em ISO 2-Digit Alpha Country Code.	texto	2	Não
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega.	texto	45	Não
`Payment.Type`	Tipo do meio de pagamento. Obs.: Somente o tipo “CreditCard” funciona com análise de fraude.	texto	100	Sim
`Payment.Provider`	Nome do provedor da autorização.	texto	15	Sim
`Payment.Amount`	Valor da transação financeira, em centavos. Ex.: 150000 = R$ 1.500,00.	número	15	Sim
`Payment.Installments`	Número de parcelas.	número	2	Sim
`Payment.Capture`	Indica se a autorização deverá ser com captura automática. Possíveis valores: “true” / “false” (default). Obs1.: Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. Obs2.: Este campo deverá ser preenchido de acordo com o fluxo da análise de fraude.	booleano	—	Não
`Payment.Recurrent`	Indica se a transação é do tipo recorrente. Possíveis valores: “true” / “false” (default). Obs1.: Este campo igual a “true” não irá criar uma recorrência; apenas permitirá a realização de uma transação sem a necessidade de envio do CVV, indicando para a adquirente que é a cobrança de uma transação de uma recorrência. Obs2.: Somente para transações Cielo. Obs3.: O campo `Payment.Authenticate` deve ser igual a “false” quando `Payment.Recurrent` for igual a “true”.	booleano	—	Não
`Payment.SoftDescriptor`	Texto que será impresso na fatura do portador. Obs.: O valor deste campo deve tornar fácil para o portador a identificação do estabelecimento onde foi realizada a compra, pois é um dos principais ofensores para chargeback.	texto	13	Não
`Payment.CreditCard.CardNumber`	Número do cartão de crédito.	texto	19	Sim
`Payment.CreditCard.Holder`	Nome do portador impresso no cartão de crédito. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	Sim
`Payment.CreditCard.ExpirationDate`	Data de validade do cartão de crédito.	texto	7	Sim
`Payment.CreditCard.SecurityCode`	Código de segurança no verso do cartão de crédito.	texto	4	Sim
`Payment.CreditCard.Brand`	Bandeira do cartão de crédito.	texto	10	Sim
`Payment.FraudAnalysis.Provider`	Provedor de Antifraude. Nesse caso, use “ClearSale”.	texto	10	Sim
`Payment.FraudAnalysis.Sequence`	Tipo de fluxo da análise de fraude. Possíveis valores: “AnalyseFirst” / “AuthorizeFirst”.	texto	14	Sim
`Payment.FraudAnalysis.SequenceCriteria`	Critério do fluxo da análise de fraude. Possíveis valores: “OnSuccess” / “Always”.	texto	9	Sim
`Payment.FraudAnalysis.CaptureOnLowRisk`	Indica se a transação após a análise de fraude será capturada. Possíveis valores: “true” / “false” (default) Obs1.: Quando enviado igual a “true” e o retorno da análise de fraude for de baixo risco (“Accept”), a transação anteriormente autorizada será capturada. Obs2.: Quando enviado igual a “true” e o retorno da análise de fraude for revisão (“Review”), a transação ficará autorizada, sendo capturada após a Braspag receber notificação de alteração do status para baixo risco (“Accept”). Obs3.: Para a utilização deste parâmetro, a sequência do fluxo de análise de risco (`FraudAnalysis.Sequence`) deve ser obrigatoriamente “AuthorizeFirst”.	booleano	—	Não
`Payment.FraudAnalysis.VoidOnHighRisk`	Indica se a transação após a análise de fraude será cancelada. Possíveis valores: “true” / “false” (default). Obs1.: Quando enviado igual a “true” e o retorno da análise de fraude for de alto risco (“Reject”), a transação anteriormente autorizada será cancelada. Obs2.: Quando enviado igual a “true” e o retorno da análise de fraude for revisão (“Review”), a transação ficará autorizada, sendo cancelada após a Braspag receber notificação de alteração do status para alto risco (“Reject”). Obs3.: Para a utilização deste parâmetro, a sequência do fluxo de análise de risco (`FraudAnalysis.Sequence`) deve ser obrigatoriamente “AuthorizeFirst”.	booleano	—	Não
`Payment.FraudAnalysis.TotalOrderAmount`	Valor total do pedido, em centavos. Ex.: 123456 = R$ 1.234,56.	número	15	Sim
`Payment.FraudAnalysis.FingerPrintId`	Identificador único da sessão do usuário. Saiba mais em Fingerprint com a ClearSale.	string	?	Sim
`Payment.FraudAnalysis.Shipping.Addressee`	Nome do destinatário.	string	60	Sim
`Payment.FraudAnalysis.Shipping.Method`	Meio de entrega.	string
`Payment.FraudAnalysis.Shipping.Phone`	Telefone residencial - Formato +DDI DDD NNNN-NNNN Exemplo: +55 11 3333-3333. É obrigatório enviar pelo menos um telefone.	string	20	Não*
`Payment.FraudAnalysis.Shipping.Identity`	Documento do destinatário.	string	14	Sim
`Payment.FraudAnalysis.Shipping.IdentityType`	1 = Pessoa Física 2 = Pessoa Jurídica.	string	255	Não
`Payment.FraudAnalysis.Shipping.Street`	Nome do logradouro do destinatário.	string	200	Sim
`Payment.FraudAnalysis.Shipping.Number`	Número do endereço do destinatário.	string	15	Sim
`Payment.FraudAnalysis.Shipping.Complement`	Complemento do endereço do destinatário.	string	250 ou 14?	Não
`Payment.FraudAnalysis.Shipping.Neighborhood`	Bairro do endereço do destinatário.	string	150	Sim
`Payment.FraudAnalysis.Shipping.City`	Cidade do destinatário.	string	150	Sim
`Payment.FraudAnalysis.Shipping.State`	Estado do destinatário - UF.	string	2	Sim
`Payment.FraudAnalysis.Shipping.Country`	País do destinatário.	string	150	Sim
`Payment.FraudAnalysis.Shipping.ZipCode`	CEP do destinatário.	string	10	Sim
`Payment.FraudAnalysis.Shipping.Email`	E-mail do destinatário.	string	150	Não
`Payment.FraudAnalysis.Cart.IsGift`	Indica se o pedido realizado pelo comprador é para presente.	booleano	—	Não
`Payment.FraudAnalysis.Cart.ReturnsAccepted`	Indica se o pedido realizado pelo comprador pode ser devolvido à loja. Possíveis valores: “true” / “false” (default).	booleano	—	Não
`Payment.FraudAnalysis.Cart.Items.Name`	Nome do produto.	texto	255	Sim
`Payment.FraudAnalysis.Cart.Items.Quantity`	Quantidade do produto.	número	15	Sim
`Payment.FraudAnalysis.Cart.Items.Sku`	SKU (Stock Keeping Unit - Unidade de Controle de Estoque) do produto.	texto	255	Sim
`Payment.FraudAnalysis.Cart.Items.UnitPrice`	Preço unitário do produto, em centavos. Ex.: 10950 = R$ 109,50.	número	15	Sim
`Payment.FraudAnalysis.Cart.Items.Type`	Categoria do produto. Lista de Valores - Type.	texto	19	Sim
`Payment.FraudAnalysis.Travel.Passengers.Name`	Nome completo do passageiro.	texto	120	Não
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Origin`	Código do aeroporto de partida. Mais informações em IATA 3-Letter Codes.	texto	3	Não
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Destination`	Código do aeroporto de chegada. Mais informações em IATA 3-Letter Codes.	texto	3	Não
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.DepartureDate`	Data e hora de partida. Formato: “2023-10-09T18:30:00”.	datetime	—	Não
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Boarding`	Data e hora de embarque. Formato: “2023-10-09T18:30:00”.	datetime	—	Não
`Payment.FraudAnalysis.Travel.Passengers.TravelLegs.Arriving`	Data e hora de chegada. Formato: “2023-10-09T18:30:00”.	datetime	—	Não

*É obrigatório enviar pelo menos um telefone.

Resposta

{
    "MerchantOrderId": "9094008",
    "Customer": {
        "Name": "Bruno Silva",
        "Identity": "11111111111",
        "IdentityType": "CPF",
        "Email": "nome@email.com.br",
        "Birthdate": "1996-11-14",
        "Phone": "+55 11 5555-1001",
        "Mobile": "+55 11 99999-9999",
        "Workphone": "+55 11 5555-2002",
        "Address": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "21 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        },
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        }
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": false,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "400002******1111",
            "Holder": "Guilherme Silva",
            "ExpirationDate": "08/2033",
            "SaveCard": false,
            "Brand": "Visa",
            "PaymentAccountReference": "Z0HFQMDXNM98R2HYZEZR7Q5ZR9ZEM"
        },
        "ProofOfSale": "432165",
        "AcquirerTransactionId": "1020115504663",
        "AuthorizationCode": "772858",
        "SoftDescriptor": "Teste Cielo",
        "SentOrderId": "9094008",
        "FraudAnalysis": {           
            "Sequence": "AuthorizeFirst",
            "SequenceCriteria": "OnSuccess",
            "Provider": "ClearSale",
            "CaptureOnLowRisk": false,
            "VoidOnHighRisk": false,
            "TotalOrderAmount": 46000,
            "IsRetryTransaction": false,
            "Cart": {
                "IsGift": false,
                "ReturnsAccepted": true,
                "Items": [
                    {
                        "Type": "EletronicGood",
                        "Name": "Notebook Dell Inspiron",
                        "Risk": "Undefined",
                        "Sku": "100010",
                        "UnitPrice": 532400,
                        "Quantity": 1,
                        "GiftCategory": "Undefined",
                        "OriginalPrice": 0,
                        "Weight": 0,
                        "CartType": 0
                    },
                    {
                        "Type": "EletronicSoftware",
                        "Name": "Windows 11 Professional",
                        "Risk": "Undefined",
                        "Sku": "100011",
                        "UnitPrice": 85515,
                        "Quantity": 2,
                        "HostHedge": "Undefined",
                        "NonSensicalHedge": "Undefined",
                        "ObscenitiesHedge": "Undefined",
                        "PhoneHedge": "Undefined",
                        "TimeHedge": "Undefined",
                        "VelocityHedge": "Undefined",
                        "GiftCategory": "Undefined",
                        "OriginalPrice": 0,
                        "Weight": 0,
                        "CartType": 0
                    }
                ]
            },
            "Travel": {
                "Passengers": [
                    {
                        "Name": "Bruno Silva",
                        "Rating": "Undefined",
                        "TravelLegs": [
                            {
                                "Destination": "CGH",
                                "Origin": "SDU",
                                "DepartureDate": "2023-10-09T18:30:00",
                                "Boarding": "2023-10-09T18:45:00",
                                "Arriving": "2023-10-09T20:00:00"
                            }
                        ]
                    },
                    {
                        "Name": "Guilherme Silva",
                        "Rating": "Undefined",
                        "TravelLegs": [
                            {
                                "Destination": "CGH",
                                "Origin": "SDU",
                                "DepartureDate": "2023-10-09T18:30:00",
                                "Boarding": "2023-10-09T18:45:00",
                                "Arriving": "2023-10-09T20:00:00"
                            }
                        ]
                    }
                ]
            },
            "Shipping": {
                "Addressee": "Nome Comprador",
                "Phone": "+55 11 5555-1001",
                "Method": "LowCost",
                "Email": "nome@email.com.br",
                "Identity": "99988877711",
                "IdentityType": "CPF"
            },
            "Status": 4,
            "StatusDescription": "Aborted"
        },
        "PaymentId": "db8f8d82-5c3f-4f09-8af2-3e33b3aec302",
        "Type": "CreditCard",
        "Amount": 45500,
        "ReceivedDate": "2023-10-20 11:55:03",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Simulado",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 1,
        "ProviderReturnCode": "4",
        "ProviderReturnMessage": "Operation Successful",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/db8f8d82-5c3f-4f09-8af2-3e33b3aec302"
            },
            {
                "Method": "PUT",
                "Rel": "capture",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/db8f8d82-5c3f-4f09-8af2-3e33b3aec302/capture"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/db8f8d82-5c3f-4f09-8af2-3e33b3aec302/void"
            }
        ]
    }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    "MerchantOrderId": "9094008",
    "Customer": {
        "Name": "Bruno Silva",
        "Identity": "11111111111",
        "IdentityType": "CPF",
        "Email": "nome@email.com.br",
        "Birthdate": "1996-11-14",
        "Phone": "+55 11 5555-1001",
        "Mobile": "+55 11 99999-9999",
        "Workphone": "+55 11 5555-2002",
        "Address": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "21 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        },
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "06455030",
            "City": "Barueri",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville",
            "AddressType": "NotInformed"
        }
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": "ByMerchant",
        "Capture": false,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "400002******1111",
            "Holder": "Guilherme Silva",
            "ExpirationDate": "08/2033",
            "SaveCard": false,
            "Brand": "Visa",
            "PaymentAccountReference": "Z0HFQMDXNM98R2HYZEZR7Q5ZR9ZEM"
        },
        "ProofOfSale": "432165",
        "AcquirerTransactionId": "1020115504663",
        "AuthorizationCode": "772858",
        "SoftDescriptor": "Teste Cielo",
        "SentOrderId": "9094008",
        "FraudAnalysis": {           
            "Sequence": "AuthorizeFirst",
            "SequenceCriteria": "OnSuccess",
            "Provider": "ClearSale",
            "CaptureOnLowRisk": false,
            "VoidOnHighRisk": false,
            "TotalOrderAmount": 46000,
            "IsRetryTransaction": false,
            "Cart": {
                "IsGift": false,
                "ReturnsAccepted": true,
                "Items": [
                    {
                        "Type": "EletronicGood",
                        "Name": "Notebook Dell Inspiron",
                        "Risk": "Undefined",
                        "Sku": "100010",
                        "UnitPrice": 532400,
                        "Quantity": 1,
                        "GiftCategory": "Undefined",
                        "OriginalPrice": 0,
                        "Weight": 0,
                        "CartType": 0
                    },
                    {
                        "Type": "EletronicSoftware",
                        "Name": "Windows 11 Professional",
                        "Risk": "Undefined",
                        "Sku": "100011",
                        "UnitPrice": 85515,
                        "Quantity": 2,
                        "HostHedge": "Undefined",
                        "NonSensicalHedge": "Undefined",
                        "ObscenitiesHedge": "Undefined",
                        "PhoneHedge": "Undefined",
                        "TimeHedge": "Undefined",
                        "VelocityHedge": "Undefined",
                        "GiftCategory": "Undefined",
                        "OriginalPrice": 0,
                        "Weight": 0,
                        "CartType": 0
                    }
                ]
            },
            "Travel": {
                "Passengers": [
                    {
                        "Name": "Bruno Silva",
                        "Rating": "Undefined",
                        "TravelLegs": [
                            {
                                "Destination": "CGH",
                                "Origin": "SDU",
                                "DepartureDate": "2023-10-09T18:30:00",
                                "Boarding": "2023-10-09T18:45:00",
                                "Arriving": "2023-10-09T20:00:00"
                            }
                        ]
                    },
                    {
                        "Name": "Guilherme Silva",
                        "Rating": "Undefined",
                        "TravelLegs": [
                            {
                                "Destination": "CGH",
                                "Origin": "SDU",
                                "DepartureDate": "2023-10-09T18:30:00",
                                "Boarding": "2023-10-09T18:45:00",
                                "Arriving": "2023-10-09T20:00:00"
                            }
                        ]
                    }
                ]
            },
            "Shipping": {
                "Addressee": "Nome Comprador",
                "Phone": "+55 11 5555-1001",
                "Method": "LowCost",
                "Email": "nome@email.com.br",
                "Identity": "99988877711",
                "IdentityType": "CPF"
            },
            "Status": 4,
            "StatusDescription": "Aborted"
        },
        "PaymentId": "db8f8d82-5c3f-4f09-8af2-3e33b3aec302",
        "Type": "CreditCard",
        "Amount": 45500,
        "ReceivedDate": "2023-10-20 11:55:03",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Simulado",
        "ReasonCode": 0,
        "ReasonMessage": "Successful",
        "Status": 1,
        "ProviderReturnCode": "4",
        "ProviderReturnMessage": "Operation Successful",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/db8f8d82-5c3f-4f09-8af2-3e33b3aec302"
            },
            {
                "Method": "PUT",
                "Rel": "capture",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/db8f8d82-5c3f-4f09-8af2-3e33b3aec302/capture"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/db8f8d82-5c3f-4f09-8af2-3e33b3aec302/void"
            }
        ]
    }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`Payment.ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`Payment.AcquirerTransactionId`	Identificador da transação na adquirente.	texto	40	texto alfanumérico
`Payment.AuthorizationCode`	Código de autorização na adquirente.	texto	300	texto alfanumérico
`Payment.FraudAnalysis.IsRetryTransaction`	Retentativa de uma análise, e deverá ser enviado com valor igual a “true” quando o código de retorno na primeira tentativa for igual a BP900	booleano	-	“true” ou “false”
`Payment.FraudAnalysis.Status`	Status da transação no AntiFraude. Veja mais na tabela.	Número	-
`Payment.FraudAnalysis.StatusDescription`	Descrição do status do Antifraude. Veja mais na tabela.	Texto	-

Fingerprint com a ClearSale

O Fingerprint é a identificação digital do dispositivo do comprador. Essa identificação é composta por uma série de dados coletados na página de checkout do site ou aplicativo.

Na integração da API do Pagador com análise de fraude ClearSale, o valor do session_id deve ser enviado no parâmetro Payment.FraudAnalisys.FingerPrintId.

Para configurar o Fingerprint com a ClearSale, consulte o manual do Antifraude Gateway.

Consultas

É possível consultar transações até 18 meses após sua criação. As formas de consultar uma transação (venda) dependem de quanto tempo ela tem de vida, como especificado na tabela abaixo:

TEMPO DE VIDA	FORMA DE CONSULTA
Até 5 meses	Pela API ou pelo painel Admin Braspag.
De 5 a 18 meses	Pelo painel Admin Braspag com a opção Histórico selecionada.

A consulta feita através de requisição diretamente à API de Consulta funciona conforme a figura:

Consulta

Consultando uma Transação via PaymentID

Para que o nó Chargeback esteja contido no retorno, a Braspag deverá passar a receber os chargebacks da sua loja. Você poderá então acatar ou contestar as operações, acompanhando os resultados das contestações no Painel Admin Braspag. Através do Post de Notificação, sua loja poderá ser informada da transação que sofreu o chargeback. As operações contidas no Painel Admin Braspag também estão disponíveis na API Risk Notification.

Para que o nó FraudAlert esteja contido no retorno, a Braspag deverá passar a receber os alertas de fraude da sua loja, que ficarão disponíveis no Painel Admin Braspag. Através do Post de Notificação, a sua loja será informada da transação que sofreu o alerta de fraude.

Transações de Crédito, Débito ou Pix

Para consultar uma transação de cartão de crédito, cartão de débito ou Pix via PaymentID, é necessário o envio de mensagem HTTP através do método GET para o recurso Payment, conforme o exemplo:

Requisição

curl
--request GET "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`PaymentId`	Número de identificação do pagamento.	texto	36	Sim (envio no endpoint)

Resposta

{
   "MerchantOrderId": "2017051001",
   "Customer": {
      "Name": "Nome do Cliente",
      "Identity": "01234567789",
      "Email": "cliente@email.com.br",
      "Address": {
         "Street": "GONCALO DA CUNHA",
         "Number": "111",
         "ZipCode": "04140040",
         "City": "SAO PAULO",
         "State": "SP",
         "Country": "BRA",
         "District": "CHACARA INGLESA"
      }
   },
   "Merchant": {
      "Id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "TradeName": "Lojas Teste"
   },
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "CreditCard": {
         "CardNumber": "455187******0181",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2021",
         "Brand": "Visa"
      },
      "ProofOfSale": "2539492",
      "AcquirerTransactionId": "0510042539492",
      "AuthorizationCode": "759497",
      "Eci": "0",
      "Refunds": [
         {
            "Amount": 10000,
            "Status": 3,
            "ReceivedDate": "2017-05-15 16:25:38"
         }
      ],
      "Chargebacks": [
         {
            "Amount": 10000,
            "CaseNumber": "123456",
            "Date": "2017-06-04",
            "ReasonCode": "104",
            "ReasonMessage": "Outras Fraudes - Cartao Ausente",
            "Status": "Received",
            "RawData": "Client did not participate and did not authorize transaction"
         }
      ],
      "FraudAlert": {
         "Date": "2017-05-20",
         "ReasonMessage": "Uso Ind Numeração",
         "IncomingChargeback": false
      },
      "VelocityAnalysis": {
         "Id": "f8078b32-be17-4c35-b164-ad74c3cd0725",
         "ResultMessage": "Accept",
         "Score": 0
      },
      "PaymentId": "f8078b32-be17-4c35-b164-ad74c3cd0725",
      "Type": "CreditCard",
      "Amount": 10000,
      "ReceivedDate": "2017-05-10 16:25:38",
      "CapturedAmount": 10000,
      "CapturedDate": "2017-05-10 16:25:38",
      "VoidedAmount": 10000,
      "VoidedDate": "2017-05-15 16:25:38",
      "Currency": "BRL",
      "Country": "BRA",
      "Provider": "Simulado",
      "ProviderDescription": "Simulado",
      "ReasonCode": 0,
      "Status": 1,
      "Links": [
         {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725"
         },
         {
            "Method": "PUT",
            "Rel": "capture",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/capture"
         },
         {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/void"
         }
      ]
   }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
   "MerchantOrderId": "2017051001",
   "Customer": {
      "Name": "Nome do Cliente",
      "Identity": "01234567789",
      "Email": "cliente@email.com.br",
      "Address": {
         "Street": "GONCALO DA CUNHA",
         "Number": "111",
         "ZipCode": "04140040",
         "City": "SAO PAULO",
         "State": "SP",
         "Country": "BRA",
         "District": "CHACARA INGLESA"
      }
   },
   "Merchant": {
      "Id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "TradeName": "Lojas Teste"
   },
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "CreditCard": {
         "CardNumber": "455187******0181",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2021",
         "Brand": "Visa"
      },
      "ProofOfSale": "2539492",
      "AcquirerTransactionId": "0510042539492",
      "AuthorizationCode": "759497",
      "Eci": "0",
      "Refunds": [
         {
            "Amount": 10000,
            "Status": 3,
            "ReceivedDate": "2017-05-15 16:25:38"
         }
      ],
      "Chargebacks": [
         {
            "Amount": 10000,
            "CaseNumber": "123456",
            "Date": "2017-06-04",
            "ReasonCode": "104",
            "ReasonMessage": "Outras Fraudes - Cartao Ausente",
            "Status": "Received",
            "RawData": "Client did not participate and did not authorize transaction"
         }
      ],
      "FraudAlert": {
         "Date": "2017-05-20",
         "ReasonMessage": "Uso Ind Numeração",
         "IncomingChargeback": false
      },
      "VelocityAnalysis": {
         "Id": "f8078b32-be17-4c35-b164-ad74c3cd0725",
         "ResultMessage": "Accept",
         "Score": 0
      },
      "PaymentId": "f8078b32-be17-4c35-b164-ad74c3cd0725",
      "Type": "CreditCard",
      "Amount": 10000,
      "ReceivedDate": "2017-05-10 16:25:38",
      "CapturedAmount": 10000,
      "CapturedDate": "2017-05-10 16:25:38",
      "VoidedAmount": 10000,
      "VoidedDate": "2017-05-15 16:25:38",
      "Currency": "BRL",
      "Country": "BRA",
      "Provider": "Simulado",
      "ProviderDescription": "Simulado",
      "ReasonCode": 0,
      "Status": 1,
      "RecurrentPayment": {
        "RecurrentPaymentId": "1069a2c8-83cb-4268-8b62-0a9dc5038665"
        },
      "Links": [
         {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725"
         },
         {
            "Method": "PUT",
            "Rel": "capture",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/capture"
         },
         {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/void"
         }
      ]
   }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`MerchantOrderId`	Número de identificação do pedido.	texto	50	texto alfanumérico
`Customer.Name`	Nome do comprador.	texto	255	texto alfanumérico
`Customer.Identity`	Número do RG, CPF ou CNPJ do cliente.	texto	14	texto alfanumérico
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF ou CNPJ).	texto	255	CPF ou CNPJ
`Customer.Email`	Email do comprador.	texto	255	texto alfanumérico
`Customer.Birthdate`	Data de nascimento do comprador.	data	10	formato AAAA-MM-DD
`Customer.Address.Street`	Endereço de contato do comprador.	texto	255	texto alfanumérico
`Customer.Address.Number`	Número do endereço de contato do comprador.	texto	15	texto alfanumérico
`Customer.Address.Complement`	Complemento do endereço de contato do comprador.	texto	50	texto alfanumérico
`Customer.Address.ZipCode`	CEP do endereço de contato do comprador.	texto	9	texto alfanumérico
`Customer.Address.City`	Cidade do endereço de contato do comprador.	texto	50	texto alfanumérico
`Customer.Address.State`	Estado do endereço de contato do comprador.	texto	2	texto alfanumérico
`Customer.Address.Country`	Pais do endereço de contato do comprador	texto	35	texto alfanumérico
`Customer.Address.District`	Bairro do endereço de contato do comprador.	texto	50	texto alfanumérico
`Customer.DeliveryAddress.Street`	Endereço de entrega do pedido.	texto	255	texto alfanumérico
`Customer.DeliveryAddress.Number`	Número do endereço de entrega do pedido.	texto	15	texto alfanumérico
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega do pedido.	texto	50	texto alfanumérico
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega do pedido.	texto	9	texto alfanumérico
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega do pedido.	texto	50	texto alfanumérico
`Customer.DeliveryAddress.State`	Estado do endereço de entrega do pedido.	texto	2	texto alfanumérico
`Customer.DeliveryAddress.Country`	País do endereço de entrega do pedido.	texto	35	texto alfanumérico
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega do pedido.	texto	50	texto alfanumérico
`Merchant.Id`	Identificador da loja que efetuou essa transação.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Merchant.TradeName`	Nome da loja.	texto	50	texto alfanumérico
`Payment.Provider`	Nome do provedor do meio de pagamento.	texto	15	Consulte os anexos.
`Payment.Type`	Tipo do meio de pagamento.	texto	100	Ex.: “CreditCard”
`Payment.Amount`	Valor do pedido, em centavos.	número	15	10000
`Payment.ServiceTaxAmount`	Montante do valor da autorização que deve ser destinado à taxa de serviço. Obs.: Esse valor não é adicionado ao valor da autorização.	número	15	10000
`Payment.Currency`	Moeda na qual o pagamento será feito.	texto	3	BRL / USD / MXN / COP / CLP / ARS / PEN / EUR / PYN / UYU / VEB / VEF / GBP
`Payment.Country`	País na qual o pagamento será feito.	texto	3	BRA
`Payment.Installments`	Número de parcelas.	número	2	6
`Payment.Interest`	Tipo de parcelamento.	texto	10	Loja (“ByMerchant”) ou Emissor (“ByIssuer”)
`Payment.Capture`	Indica se a autorização deve ser com captura automática ou não. Deverá verificar junto à adquirente a disponibilidade desta funcionalidade.	booleano	—	true / false (default)
`Payment.Authenticate`	Indica se a transação deve ser autenticada ou não. Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. `Authenticate` deve ser “false” quando `Recurrent` é “true”.	booleano	—	true / false (default)
`Payment.Recurrent`	Indica se a transação é do tipo recorrente ou não. Obs.: Este campo igual a “true” não irá originar uma nova recorrência; apenas permitirá a realização de uma transação sem a necessidade de envio do CVV. Somente para transações Cielo. `Authenticate` deve ser “false” quando `Recurrent` é “true”.	booleano	—	true / false (default)
`Payment.SoftDescriptor`	Texto que será impresso na fatura do portador.	texto	13	texto alfanumérico
`Payment.ExtraDataCollection.Name`	Nome do campo em que será gravado o dado extra.	texto	50	texto alfanumérico
`Payment.ExtraDataCollection.Value`	Valor do campo em que será gravado o dado extra.	texto	1024	texto alfanumérico
`Payment.AcquirerTransactionId`	Id da transação no provedor do meio de pagamento.	texto	40	texto alfanumérico
`Payment.ProofOfSale`	Número do comprovante de venda.	texto	20	texto alfanumérico
`Payment.AuthorizationCode`	Código de autorização.	texto	300	texto alfanumérico
`Payment.Refunds.Amount`	Valor reembolsado, em centavos.	número	15	10000
`Payment.Refunds.Status`	Status do reembolso.	número	1	Received = 1 Sent = 2 Approved = 3 Denied = 4 Rejected = 5
`Payment.Refunds.ReceivedDate`	Data de recebimento do reembolso.	texto	19	AAAA-MM-DD HH:mm:SS
`Payment.Chargebacks[n].Amount`	Valor do chargeback, em centavos.	número	15	10000
`Payment.Chargebacks[n].CaseNumber`	Número do caso relacionado ao chargeback.	texto	16	Texto alfanumérico
`Payment.Chargebacks[n].Date`	Data do chargeback.	data	10	AAAA-MM-DD
`Payment.Chargebacks[n].ReasonCode`	Código do motivo do chargeback. Lista de Valores - ReasonCode.	texto	10	texto alfanumérico
`Payment.Chargebacks[n].ReasonMessage`	Mensagem de motivo do chargeback. Lista de Valores - ReasonMessage.	texto	512	texto alfanumérico
`Payment.Chargebacks[n].Status`	Status do chargeback. Lista de Valores - Status.	texto	32	texto
`Payment.Chargebacks[n].RawData`	Dado enviado pela adquirente, podendo ser o titular do cartão ou outra mensagem.	texto	512	texto alfanumérico
`Payment.FraudAlert.Date`	Data do alerta de fraude.	data	10	AAAA-MM-DD
`Payment.FraudAlert.ReasonMessage`	Mensagem de motivo do alerta de fraude.	texto	512	texto alfanumérico
`Payment.FraudAlert.IncomingChargeback`	Flag que identifica se a transação possui um chargeback ocorrido antes do alerta de fraude.	booleano	5	Texto
`Payment.PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Payment.ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	19	AAAA-MM-DD HH:mm:SS
`Payment.ReasonCode`	Código de retorno da adquirência.	texto	32	texto alfanumérico
`Payment.ReasonMessage`	Mensagem de retorno da adquirência.	texto	512	texto alfanumérico
`Payment.CapturedAmount`	Valor capturado.	número	15	10000
`Payment.CapturedDate`	Data da captura.	texto	19	AAAA-MM-DD HH:mm:SS
`Payment.VoidedAmount`	Valor cancelado/estornado, em centavos.	número	15	10000
`Payment.VoidedDate`	Data do cancelamento/estorno.	texto	19	AAAA-MM-DD HH:mm:SS
`Payment.Status`	Status da transação.	byte	2	Ex.: “1”
`RecurrentPayment.RecurrentPaymentID`	Caso a transação tenha surgido de um pedido recorrente, retorna o RecurrentPaymentID desse pedido	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Payment.Provider`	Provedor utilizado.	texto	32	Simulado
`Payment.ProviderDescription`	Nome do adquirente que processou a transação.	texto	512	Simulado
`CreditCard.CardNumber`	Número do cartão do comprador.	texto	19	—
`CreditCard.Holder`	Nome do portador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	texto	25	—
`CreditCard.ExpirationDate`	Data de validade impresso no cartão.	texto	7	MM/AAAA
`CreditCard.Brand`	Bandeira do cartão.	texto	10	—
`CreditCard.SaveCard`	Identifica se o cartão será salvo para gerar o token (CardToken).	booleano	—	true / false (default)

Transação de Boleto Registrado

Para consultar uma transação de boleto registrado via PaymentID, é necessário o envio de mensagem HTTP do método GET para o recurso Payment, conforme o exemplo:

Requisição

--request GET "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`PaymentId`	Número de identificação do pagamento.	GUID	36	Sim (envio no endpoint)

Resposta

{
  "MerchantOrderId": "2017051001",
  "Customer": {
    "Name": "Nome do Cliente",
    "Identity": "12345678909",
    "Address": {
        "Street": "GONCALO DA CUNHA",
        "Number": "111",
        "ZipCode": "04140040",
        "City": "SAO PAULO",
        "State": "SP",
        "Country": "BRA",
        "District": "CHACARA INGLESA"
     }
  },
  "Payment": {
     "Instructions": "",
     "ExpirationDate": "2018-06-27",
     "Demonstrative": "",
     "Url": "https://www.pagador.com.br/post/pagador/reenvia.asp/3fda2279-1c45-4271-9656-XXXXXXXXXX",
     "BoletoNumber": "123464",
     "BarCodeNumber": "9999990276000001234864001834099999999",
     "DigitableLine": "99999.39027 60000.012348 64001.834007 7 75680999999999",
     "Assignor": "RAZAO SOCIAL DA LOJA LTDA.",
     "Address": "",
     "Identification": "01234567000189",
     "CreditDate": "2018-06-28",
     "PaymentId": "99992279-1c45-4271-9656-ccbde4ea9999",
     "Type": "Boleto",
     "Amount": 182000,
     "ReceivedDate": "2018-06-26 23:33:07",
     "CapturedAmount": 182000,
     "CapturedDate": "2018-06-27 01:45:57",
     "Currency": "BRL",
     "Country": "BRA",
     "Provider": "Bradesco2",
     "ReturnUrl": "https://www.loja.com.br/notificacao",
     "ExtraDataCollection": [],
     "ReasonCode": 0,
     "Status": 2,
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725"
      },
      {
        "Method": "PUT",
        "Rel": "capture",
        "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/capture"
      },
      {
        "Method": "PUT",
        "Rel": "void",
        "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/void"
      }
    ]
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  "MerchantOrderId": "2017051001",
  "Customer": {
    "Name": "Nome do Cliente",
    "Identity": "12345678909",
    "Address": {
        "Street": "GONCALO DA CUNHA",
        "Number": "111",
        "ZipCode": "04140040",
        "City": "SAO PAULO",
        "State": "SP",
        "Country": "BRA",
        "District": "CHACARA INGLESA"
     }
  },
  "Payment": {
     "Instructions": "",
     "ExpirationDate": "2018-06-27",
     "Demonstrative": "",
     "Url": "https://www.pagador.com.br/post/pagador/reenvia.asp/3fda2279-1c45-4271-9656-XXXXXXXXXX",
     "BoletoNumber": "123464",
     "BarCodeNumber": "9999990276000001234864001834099999999",
     "DigitableLine": "99999.39027 60000.012348 64001.834007 7 75680999999999",
     "Assignor": "RAZAO SOCIAL DA LOJA LTDA.",
     "Address": "",
     "Identification": "01234567000189",
     "CreditDate": "2018-06-28",
     "PaymentId": "99992279-1c45-4271-9656-ccbde4ea9999",
     "Type": "Boleto",
     "Amount": 182000,
     "ReceivedDate": "2018-06-26 23:33:07",
     "CapturedAmount": 182000,
     "CapturedDate": "2018-06-27 01:45:57",
     "Currency": "BRL",
     "Country": "BRA",
     "Provider": "Bradesco2",
     "ReturnUrl": "https://www.loja.com.br/notificacao",
     "ExtraDataCollection": [],
     "ReasonCode": 0,
     "Status": 2,
     "RecurrentPayment": {
        "RecurrentPaymentId": "1069a2c8-83cb-4268-8b62-0a9dc5038665"
        },
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725"
      },
      {
        "Method": "PUT",
        "Rel": "capture",
        "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/capture"
      },
      {
        "Method": "PUT",
        "Rel": "void",
        "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/void"
      }
    ]
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`MerchantOrderId`	Número de identificação do pedido.	texto	50	texto alfanumérico
`Customer.Name`	Nome do comprador.	texto	255	texto alfanumérico
`Customer.Identity`	Número do RG, CPF ou CNPJ do cliente.	texto	14	texto alfanumérico
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF ou CNPJ).	texto	255	CPF ou CNPJ
`Customer.Email`	E-mail do comprador.	texto	255	texto alfanumérico
`Customer.Birthdate`	Data de nascimento do comprador.	data	10	formato AAAA-MM-DD
`Customer.Address.Street`	Endereço de contato do comprador.	texto	255	texto alfanumérico
`Customer.Address.Number`	Número do endereço de contato do comprador.	texto	15	texto alfanumérico
`Customer.Address.Complement`	Complemento do endereço de contato do comprador.	texto	50	texto alfanumérico
`Customer.Address.ZipCode`	CEP do endereço de contato do comprador.	texto	9	texto alfanumérico
`Customer.Address.City`	Cidade do endereço de contato do comprador.	texto	50	texto alfanumérico
`Customer.Address.State`	Estado do endereço de contato do comprador.	texto	2	texto alfanumérico
`Customer.Address.Country`	País do endereço de contato do comprador.	texto	35	texto alfanumérico
`Customer.Address.District`	Bairro do endereço de contato do comprador.	texto	50	texto alfanumérico
`Customer.DeliveryAddress.Street`	Endereço de entrega do pedido.	texto	255	texto alfanumérico
`Customer.DeliveryAddress.Number`	Número do endereço de entrega do pedido.	texto	15	texto alfanumérico
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega do pedido.	Texto	50	Texto alfanumérico
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega do pedido.	texto	9	texto alfanumérico
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega do pedido.	texto	50	texto alfanumérico
`Customer.DeliveryAddress.State`	Estado do endereço de entrega do pedido.	texto	2	texto alfanumérico
`Customer.DeliveryAddress.Country`	País do endereço de entrega do pedido.	texto	35	texto alfanumérico
`Customer.DeliveryAddress.District`	Bairro do comprador.	texto	50	texto alfanumérico
`Payment.Provider`	Nome do provedor do meio de pagamento.	texto	15	Consulta os provedores disponíveis nos anexos
`Payment.Type`	Tipo do meio de pagamento.	texto	100	Ex.: Boleto
`Payment.Amount`	Valor do pedido, em centavos.	número	15	10000
`Payment.CapturedAmount`	Valor pago do boleto, em centavos.	número	15	10000
`Payment.Instructions`	Texto sobre alguma instrução específica para o boleto.	texto	Veja as Regras Específicas por Banco.	Ex.: “Não pagar após o vencimento”
`Payment.Demonstrative`	Texto sobre alguma informação específica para o boleto.	texto	Veja as Regras Específicas por Banco.	Ex.: “Boleto referente ao pedido número 99999”
`Payment.Url`	URL para apresentação do boleto.	texto	-	Ex.: “https://www.pagador.com.br/post/pagador/reenvia.asp/3fda2279-1c45-4271-9656-XXXXXXXXXX”
`Payment.BoletoNumber`	Nosso número.	número	Veja as Regras Específicas por Banco.	Ex.: “12345678”
`Payment.BarCodeNumber`	Código de barras do boleto.	texto	44	Ex.: “99999390276000001234864001834007775680099999”
`Payment.DigitableLine`	Linha digitável do boleto.	texto	54	Ex.: “99999.39027 60000.012348 64001.834007 7 75680000199999”
`Payment.Assignor`	Nome do cedente do boleto.	texto	200	Ex.: “RAZAO SOCIAL DA LOJA LTDA”
`Payment.Address`	Endereço do cedente do boleto.	texto	160	Ex.: “Alameda Xingu 512”
`Payment.Identification`	CNPJ do cedente.	texto	18	Ex.: “11.355.111/0001-11”
`Payment.ExpirationDate`	Data de vencimento do boleto.	texto	AAAA-MM-DD	Ex.: “2018-06-21”
`Payment.CreditDate`	Data de crédito do valor pago do boleto.	texto	AAAA-MM-DD	Ex.: “2018-06-19”
`Payment.CapturedDate`	Data de pagamento do boleto.	texto	AAAA-MM-DD HH:mm:SS	Ex.: “2018-06-19 01:45:57”
`Payment.ReceivedDate`	Data em que a transação foi recebida pela Braspag.	texto	AAAA-MM-DD HH:mm:SS	Ex.: “2018-06-19 01:45:57”
`Payment.ReturnUrl`	URL da loja para onde o cliente é redirecionado.	texto	-	Ex.: “https://www.loja.com.br”
`Payment.Currency`	Moeda na qual o pagamento será feito.	texto	3	BRL / USD / MXN / COP / CLP / ARS / PEN / EUR / PYN / UYU / VEB / VEF / GBP
`Payment.Country`	País na qual o pagamento será feito.	texto	3	BRA
`Payment.ExtraDataCollection.Name`	Nome do campo em que será gravado o dado extra.	texto	50	texto alfanumérico
`Payment.ExtraDataCollection.Value`	Valor do campo em que será gravado o dado extra.	texto	1024	texto alfanumérico
`Payment.PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Payment.ReasonCode`	Código de retorno da adquirência.	texto	32	texto alfanumérico
`Payment.Status`	Status da transação.	byte	2	Ex.: 1
`RecurrentPayment.RecurrentPaymentID`	Caso a transação tenha surgido de um pedido recorrente, retorna o RecurrentPaymentID desse pedido	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Consultando uma Venda pelo Identificador da Loja

Não é possível consultar um pagamento diretamente pelo identificador enviado pela loja (MerchantOrderId), mas é possível obter todos os PaymentIds associados ao identificador.

Para consultar uma venda pelo identificador da loja, é necessário o envio de mensagem HTTP do método GET para o recurso /sales, conforme o exemplo:

Requisição

--request GET "https://apiquerysandbox.braspag.com.brv2/sales?merchantOrderId={merchantOrderId}"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`MerchantOrderId`	Campo identificador do pedido na loja.	texto	36	Sim (envio no endpoint)

Resposta

{
    "Payment": [
        {
            "PaymentId": "5fb4d606-bb63-4423-a683-c966e15399e8",
            "ReceveidDate": "2015-04-06T10:13:39.42"
        },
        {
            "PaymentId": "6c1d45c3-a95f-49c1-a626-1e9373feecc2",
            "ReceveidDate": "2014-12-19T20:23:28.847"
        }
    ]
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
    "ReasonCode": 0,
    "ReasonMessage": "Successful",
    "Payments": [
        {
            "PaymentId": "5fb4d606-bb63-4423-a683-c966e15399e8",
            "ReceveidDate": "2015-04-06T10:13:39.42"
        },
        {
            "PaymentId": "6c1d45c3-a95f-49c1-a626-1e9373feecc2",
            "ReceveidDate": "2014-12-19T20:23:28.847"
        }
    ]
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Consultando um Pedido Recorrente

Para consultar um pedido de recorrência, é necessário o envio de mensagem HTTP do método GET conforme o exemplo:

Requisição

--request GET "https://apiquerysandbox.braspag.com.br/v2/RecurrentPayment/{RecurrentPaymentId}"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja na API.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla na API.	texto	40	Sim (envio no header)
`RequestId`	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`RecurrentPaymentId`	Campo identificador da recorrência.	texto	36	Sim (envio no endpoint)

Resposta

{
  "Customer": {
    "Name": "Nome do Cliente"
  },
  "RecurrentPayment": {
    "Installments": 1,
    "RecurrentPaymentId": "f5a83c14-0254-4e73-bdd3-9afba1007266",
    "NextRecurrency": "2017-06-11",
    "StartDate": "2017-05-11",
    "EndDate": "2019-12-31",
    "Interval": "Monthly",
    "Amount": 10000,
    "Country": "BRA",
    "CreateDate": "2017-05-11T00:00:00",
    "Currency": "BRL",
    "CurrentRecurrencyTry": 1,
    "OrderNumber": "2017051120",
    "Provider": "Simulado",
    "RecurrencyDay": 11,
    "SuccessfulRecurrences": 1,
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/RecurrentPayment/f5a83c14-0254-4e73-bdd3-9afba1007266"
      }
    ],
    "RecurrentTransactions": [
      {
        "PaymentNumber": 0,
        "RecurrentPaymentId": "f5a83c14-0254-4e73-bdd3-9afba1007266",
        "TransactionId": "cd694ffb-c0c4-47db-9390-737df70a2012",
        "TryNumber": 1,
        "Links": [
          {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/cd694ffb-c0c4-47db-9390-737df70a2012"
          }
        ]
      }
    ],
    "Status": 1
  }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  "Customer": {
    "Name": "Nome do Cliente"
  },
  "RecurrentPayment": {
    "Installments": 1,
    "RecurrentPaymentId": "f5a83c14-0254-4e73-bdd3-9afba1007266",
    "NextRecurrency": "2017-06-11",
    "StartDate": "2017-05-11",
    "EndDate": "2019-12-31",
    "Interval": "Monthly",
    "Amount": 10000,
    "Country": "BRA",
    "CreateDate": "2017-05-11T00:00:00",
    "Currency": "BRL",
    "CurrentRecurrencyTry": 1,
    "OrderNumber": "2017051120",
    "Provider": "Simulado",
    "RecurrencyDay": 11,
    "SuccessfulRecurrences": 1,
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.braspag.com.br/v2/RecurrentPayment/f5a83c14-0254-4e73-bdd3-9afba1007266"
      }
    ],
    "RecurrentTransactions": [
      {
        "PaymentNumber": 0,
        "RecurrentPaymentId": "f5a83c14-0254-4e73-bdd3-9afba1007266",
        "TransactionId": "cd694ffb-c0c4-47db-9390-737df70a2012",
        "TryNumber": 1,
        "Links": [
          {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/cd694ffb-c0c4-47db-9390-737df70a2012"
          }
        ]
      }
    ],
    "Status": 1
  }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`RecurrentPaymentId`	Campo identificador da próxima recorrência.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`NextRecurrency`	Data da próxima recorrência.	texto	7	05/2019 (MM/YYYY)
`StartDate`	Data do início da recorrência.	texto	7	05/2019 (MM/YYYY)
`EndDate`	Data do fim da recorrência.	texto	7	05/2019 (MM/YYYY)
`Interval`	Intervalo entre as recorrências.	texto	10	“Monthly” / “Bimonthly” / “Quarterly” / “SemiAnnual” / “Annual”
`CurrentRecurrencyTry`	Número atual da tentativa de recorrência.	número	1	1
`OrderNumber`	Identificação do pedido na loja.	texto	50	2017051101
`Status`	Status do pedido recorrente.	número	1	1- Ativo / 2- Finalizado / 3- Desativado pelo Usuário / 4- Desativado por Número Máximo de Tentativas / 5- Desativado por Cartão de Crédito Expirado
`RecurrencyDay`	Dia da recorrência.	número	2	22
`SuccessfulRecurrences`	Quantidade de recorrências realizadas com sucesso.	número	2	5
`RecurrentTransactions.RecurrentPaymentId`	Id da recorrência.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`RecurrentTransactions.TransactionId`	Payment ID da transação gerada na recorrência.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`RecurrentTransactions.PaymentNumber`	Número da recorrência. A primeira é zero.	número	2	3
`RecurrentTransactions.TryNumber`	Número da tentativa atual na recorrência específica.	número	2	1

Post de Notificação

Para receber a notificação de alteração de status da transação (ex.: confirmação de pagamento ou devolução), configure o campo “URL de Notificação” durante o cadastro de sua loja na Braspag. O endereço deve ser HTTPS e não se deve utilizar uma porta fora do padrão HTTPS (443).

Veja o fluxo percorrido pelo post de notificação:

Post de Notificação

Os parâmetros serão enviados à URL cadastrada, conforme demonstrado no exemplo abaixo.

Notificação Enviada

{
   "RecurrentPaymentId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "PaymentId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "ChangeType": 2
}

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`RecurrentPaymentId`	Identificador que representa o pedido recorrente (aplicável somente para `ChangeType` 2 ou 4).	GUID	36	Não
`PaymentId`	Identificador que representa a transação.	GUID	36	Sim
`ChangeType`	Especifica o tipo de notificação. Obs.: Consulte a tabela abaixo.	Número	1	Sim

ChangeType	Descrição
1	Mudança de status do pagamento.
2	Recorrência criada.
3	Mudança de status do Antifraude.
4	Mudança de status do pagamento recorrente (Ex.: desativação automática).
5	Estorno negado (aplicável para Rede).
6	Boleto registrado pago a menor.
7	Notificação de chargeback. Exclusivo para clientes integrados à Risk Notification API.
8	Alerta de fraude.

Resposta Esperada

É esperado o retorno da loja com a seguinte resposta: HTTP Status Code 200 OK.

ANEXOS

Lista de Providers

As listas a seguir se referem a provedores na integração com a API REST:

Providers para Crédito

Provider	Brand	Descrição
Simulado	—	Provider de Sandbox. Clique aqui para mais detalhes sobre cartões para teste.
Cielo30	Visa, Master, Amex, Elo, Aura, Jcb, Diners, Discover, Hipercard, Sorocred	Provider para transações na plataforma de e-commerce Cielo 3.0.
Getnet	Visa, Master, Elo, Amex, Hipercard	Provider para transações na plataforma de e-commerce Getnet.
Rede2	Visa, Master, Hipercard, Diners, Elo, Amex, Sorocred	Provider para transações na plataforma de e-commerce da Rede (e-Rede) na versão REST.
GlobalPayments	Visa, Master, Elo, Hipercard, Cabal, Amex	Provider para transações na plataforma de e-commerce Global Payments.
Stone	Visa, Master, Hipercard, Elo	Provider para transações na plataforma de e-commerce Stone.
Safra2	Visa, Master, Hipercard, Elo, Amex	Provider para transações na plataforma de e-commerce Safra.
PagSeguro	Visa, Master, Hipercard, Elo, Diners, Amex	Provider para transações na plataforma de e-commerce PagSeguro.
FirstData	Visa, Master, Elo, Hipercard, Cabal, Amex	Provider para transações em guaranis (PYG), pesos argentinos (ARG) e reais (BRL) na plataforma de e-commerce First Data.
Sub1	Visa, Master, Diners, Amex, Discover, Cabal, Naranja e Nevada	Provider para transações em pesos argentinos (ARG) na plataforma legado Sub1 First Data.
Banorte	Visa, Master, Carnet	Provider para transações em pesos mexicanos (MXN) na plataforma de e-commerce Banorte.
Credibanco2	Visa, Master, Diners, Amex, Credential	Provider para transações em pesos colombianos (COP) na plataforma de e-commerce Credibanco.
Transbank2	Visa, Master, Diners, Amex	Provider para transações em pesos chilenos (CLP) na plataforma de e-commerce Transbank.
Banese	Banese	Provider para transações com a bandeira BaneseCard.
BrasilCard	BrasilCard	Provider para transações com a bandeira BrasilCard.
CredSystem	CredSystem	Sistema de cartões em regime de bandeira privativa (Private Label Brand).
Credz	Credz	Sistema de cartões em regime de bandeira privativa (Private Label Brand).
DMCard	DMCard	Sistema de cartões em regime de bandeira privativa (Private Label Brand).

Providers para Débito

Provider	Brand	Descrição
Cielo	Visa, Master	Provider para transações de débito na plataforma legado Cielo 1.5.
Cielo30	Visa, Master	Provider para transações de débito na plataforma de e-commerce Cielo 3.0.
Getnet	Visa, Master	Provider para transações de débito na plataforma de e-commerce GetNet.
Rede2	Visa, Master	Provider para transações de débito na plataforma de e-commerce Rede.
Safra2	Visa, Master	Provider para transações de débito na plataforma de e-commerce Safra.
FirstData	Visa, Master	Provider para transações de débito na plataforma de e-commerce First Data.
GlobalPayments	Visa, Master	Provider para transações de débito na plataforma de e-commerce Global Payments.

Providers para Voucher

Provider	Brand	Descrição
Alelo	Elo	Provider para transações de voucher (vale refeição/alimentação) na plataforma Alelo.
Ticket	Ticket	Provider para transações de voucher (vale refeição/alimentação) na plataforma Ticket.

Providers para Zero Auth via VerifyCard

Providers
Simulado, Cielo30 (Cielo 3.0), Rede2, Getnet, FirstData, GlobalPayments e Safra2.

Providers para Consulta BIN via VerifyCard

Provider
Simulado, Cielo30 (Cielo 3.0)

Providers para Boleto com Registro

Provider
Braspag, Bradesco2, BancoDoBrasil2, ItauShopline, Itau2, Santander2, Caixa2, CitiBank2

Providers para Transferência Eletrônica (Débito Online)

Provider
SafetyPay, PayMeeRedirectCheckout, PayMeeSemiTransparent

Providers para Pix

Provider
Cielo30, Bradesco2

Lista de Status da Transação

Lista de status retornados pela API:

Código	Status do Pagamento	Meio de pagamento	Descrição
0	NotFinished	Todos	Falha ao processar o pagamento. Possíveis causas: dados incorretos, erro na requisição, timeout da adquirente, alguma instabilidade no processamento. Em caso de transação de débito, o comprador pode ter abandonado a compra.
1	Authorized	Todos	Meio de pagamento apto a ser capturado ou pago (boleto). Para transação de boleto, significa que o boleto foi gerado com sucesso. Para transação com cartão, significa que houve a aprovação pelo banco emissor. Contudo, isso não significa que a transação foi concluída - para isso, é necessário uma segunda etapa, a captura da transação ou a efetivação do pagamento.
2	PaymentConfirmed	Todos	Pagamento confirmado e finalizado.
3	Denied	Cartões de crédito e débito (transferência eletrônica) e e-wallets.	Pagamento negado por autorizador. Possíveis causas: limite insuficiente, falta de pagamento do cartão, bandeira indisponível, bloqueio por fraude, entre outros. Para saber o real motivo da negação é necessário olhar o código de retorno gerado durante a transação.
10	Voided	Todos, exceto boleto.	Pagamento cancelado. É a suspensão da transação, isentando de taxa ou valores cobrados. As transações pré-autorizadas podem ser canceladas mesmo após às 23h59 da data de autorização. Já as transações capturadas podem ser canceladas até às 23h59 do mesmo dia da autorização, após esse horário o valor será estornado.
11	Refunded	Cartões de crédito e débito e e-wallets.	Pagamento cancelado/estornado. Significa que foi solicitado o cancelamento da transação, podendo ocorrer a partir das 0h00 do dia após a criação da transação. Independentemente do valor, só é possível realizar uma solicitação de estorno por transação. Isso pode acontecer por conta de dados incorretos ou por solicitação do comprador.
12	Pending	Cartões de crédito e débito (transferência eletrônica), e-wallets e Pix.	Esperando retorno da instituição financeira. Significa que a transação foi enviada para a Braspag em processo de pré-autorização, esperando uma resposta do banco emissor para validá-la.
13	Aborted	Todos	Pagamento cancelado por falha no processamento. Significa que a transação foi cancelada por falha de processamento. Também pode ser abortada, caso o Antifraude negue a transação antes da autorização.
20	Scheduled	Cartão de crédito e e-wallets.	Recorrência agendada. Significa que a transação terá uma recorrência agendada, ou seja, o valor da compra será recolhido no dia em que foi agendado pela loja.

Lista de Status do Antifraude

Código	Descrição
0	Unknown
1	Accept
2	Reject
3	Review
4	Aborted
5	Unfinished

Tabela de MDDs

A estratégia de risco é desenhada de acordo com as necessidades do seu negócio, considerando o nível de relevância dos campos Merchant Defined Data (MDD).

O envio dos MDDs 1, 4, 9, 83 e 84 é obrigatório durante a validação das transações de testes. Caso a sua loja não possa enviar um ou mais MDDs obrigatórios, é necessário indicar à equipe Braspag quais MDDs não serão enviados durante a integração.

Nível de Relevância dos Campos MDD

1 - Relevante
2 - Muito Relevante
3 - Extremamente Relevante

ID	Valor	Tipo	Nível de Relevância	Segmento	Obrigatório?
1	Cliente que efetua o login. Possíveis valores: “{login_do_cliente}” (caso o cliente final efetue login no site para comprar) / “Guest” (caso o cliente final faça a compra como visitante). Obs.: Não enviar o campo caso um terceiro (ex.: um agente) realize a venda diretamente.	string	2	Todos	Sim
2	Quantidade de dias que a pessoa é cliente da loja. Ex.: 314.	int	3	Todos	Não
3	Quantidade de parcelas do pedido.	int	3	Todos	Não
4	Canal de venda. Possíveis valores: “Call Center” (compra pelo telefone) / “Web” (compra pela web) / “Portal” (compra através de agente) / “Quiosque” (compra em quiosque) / “Móvel” (compra por celular ou tablet). Obs.: Se “Call Center”, fundamental o envio também do campo 39 - Nome de usuário do Call Center.	string	3	Todos	Sim
5	Código do cupom/desconto caso o cliente utilize na compra.	string	1	Todos	Não
6	Quantidade em dias desde a última compra realizada pelo cliente. Ex.: 55.	int	3	Todos	Não
7	Código ou nome do seller (vendedor).	string	1	Todos	Não
8	Tentativas realizadas pelo cliente de efetuar o pagamento do mesmo pedido, podendo ser com diferentes cartões de créditos e/ou através de outros meios de pagamento.	int	2	Todos	Não
9	Identifica se cliente irá retirar o produto na loja. Possíveis valores: “SIM” / “NAO”. Obs.: Se “SIM”, fundamental o envio também do campo 22 - Código da loja onde o produto será retirado.	string	3	Varejo ou Cosméticos	Sim
10	Identifica se o pagamento será realizado por outra pessoa que não esteja presente na viagem ou no pacote. Possíveis valores: “SIM” / “NAO”.	string	3	Aéreo ou Turismo	Não
11	Categoria do hotel (quantas estrelas). Possíveis valores: “1” (simples) / “2” (econômico) / “3” (turismo) / “4” (superior) / “5” (luxo).	int	3	Turismo	Não
12	Quantidade em dias desde a data da compra até a data do checkin no hotel. Ex.: 123.	int	3	Turismo	Não
13	Quantidade de diárias no hotel. Ex.: 5.	int	3	Turismo	Não
14	Categoria da viagem ou pacote. Possíveis valores: “Nacional” / “Internacional” / “Nacional/Internacional”.	string	3	Aéreo ou Turismo	Não
15	Nome da companhia áerea / locadora de carro / hotel. Obs.: Enviar o nome de cada uma das empresas separado por “/”.	string	2	Aéreo ou Turismo	Não
16	Código PNR da reserva. Quando houver uma alteração da reserva para este PNR, com antecipação da data de voo, é importante fazer uma nova análise de fraude enviando este PNR novamente. Obs.: Este campo deverá ser enviado quando o campo 17 for igual a “SIM”.	string	3	Aérea	Não
17	Identifica se houve antecipação de reserva. Possíveis valores: “SIM” / “NAO”. Obs.: Se “SIM”, fundamental o envio também do campo 16 - Código PNR da reserva.	string	3	Aéreo	Não
18	Categoria do veículo alugado. Possíveis valores: “1” (básico) / “2” (esportivo) / “3” (prime) / “4” (utilitário) / “5” (blindado).	string	3	Turismo	Não
19	Identifica se o pacote refere-se a cruzeiro. Possíveis valores: “SIM” / “NAO”.	string	2	Turismo	Não
20	Decisão da análise de fraude referente à última compra. Possíveis valores: “ACEITA” / “REJEITADA”.	string	3	Todos	Não
21	Valor do frete. Ex.: 10599 = R$ 105,99.	long	1	Varejo ou Cosméticos	Não
22	Código da loja onde o produto será retirado. Obs.: Este campo deverá ser enviado quando o campo 9 for igual a “SIM”.	string	3	Varejo ou Cosméticos	Não
23	Sufixo (4 últimos dígitos) do cartão de crédito.	int	1	Todos	Não
24	Quantidade de dias desde a primeira compra realizada pelo cliente. Ex.: 150.	int	3	Todos	Não
25	Sexo do cliente. Possíveis valores: “F” (feminino) / “M” (masculino).	string	2	Todos	Não
26	Bin (6 primeiros dígitos) do cartão de crédito.	int	1	Todos	Não
27	Tipo do logradouro do endereço de entrega. Possíveis valores: “R” (residencial) / “C” (comercial).	string	2	Todos	Não
28	Tempo médio em minutos que o cliente levou para realizar a compra.	int	2	Todos	Não
29	Quantidade de tentativas que o cliente realizou para efetuar login.	int	2	Todos	Não
30	Quantidade de páginas web que o cliente visitou nos 30 minutos anteriores à compra.	int	2	Todos	Não
31	Quantidade de trocas de número de cartão de crédito que o cliente efetuou para realizar o pagamento do pedido.	int	2	Todos	Não
32	Identifica se o e-mail foi colado ou digitado. Possíveis valores: “Digitado” / “Colado”.	string	3	Todos	Não
33	Identifica se o número do cartão de crédito foi colado ou digitado. Possíveis valores: “Digitado” / “Colado”.	string	3	Todos	Não
34	Identifica se o e-mail foi confirmado para ativação de conta. Possíveis valores: “SIM” / “NAO”.	string	2	Todos	Não
35	Identifica o tipo de cliente. Possíveis valores: “Local” / “Turista”.	string	2	Turismo	Não
36	Identifica se foi utilizado cartão presente (GiftCard) na compra como forma de pagamento. Possíveis valores: “SIM” / “NAO”.	string	1	Todos	Não
37	Meio de envio do pedido. Possíveis valores: “Sedex” / “Sedex 10” / “1 Dia” / “2 Dias” / “Motoboy” / “Mesmo Dia”.	string	3	Varejo ou Cosméticos	Não
38	Número do telefone do cliente identificado através da bina quando venda é realizada através de Call Center. Formato: DDIDDDNúmero - Ex.: 552121114720.	string	3	Todos	Não
39	Nome de usuário do Call Center. Obs.: Este campo deverá ser enviado quando o campo 4 for igual a “Call Center”.	string	1	Todos	Não
40	Comentários inseridos quando pedido é presente.	string	1	Todos	Não
41	Tipo do documento. Possíveis valores: “CPF” / “CNPJ” / “Passaporte”.	string	2	Todos	Não
42	Idade do cliente.	int	2	Todos	Não
43	Faixa de rendimento do cliente. Ex.: 100000 = R$ 1.000,00	long	2	Todos	Não
44	Quantidade histórica de compras realizadas pelo cliente.	int	3	Todos	Não
45	Identifica se é uma compra realizada por funcionário. Possíveis valores: “SIM” / “NAO”.	string	2	Todos	Não
46	Nome impresso (portador) no cartão de crédito.	string	3	Todos	Não
47	Identifica se o cartão é private label. Possíveis valores: “SIM” / “NAO”.	string	2	Todos	Não
48	Quantidade de meios de pagamentos utilizados para efetuar a compra.	int	2	Todos	Não
49	Valor médio das compras realizadas nos últimos 6 meses. Ex.: 159050 = R$ 1.590,99.	long	3	Todos	Não
50	Fator de desvio de valor da compra atual sobre a média dos últimos 6 meses.	long	3	Todos	Não
51	Identifica se é um cliente VIP com tratamento de risco diferenciado ou lista positiva. Possíveis valores: “SIM” / “NAO”.	string	3	Todos	Não
52	Categoria do produto. Possíveis valores: “Animais e Bichos de Estimação” / “Roupas e Acessórios” / “Negócios e Indústria” / “Câmeras e Óticas” / “Eletrônicos” / “Comidas, Bebidas e Cigarro” / “Móveis” / “Ferramentas” / “Saúde e Beleza” / “Casa e Jardim” / “Malas e Bagagens” / “Adulto” / “Armas e Munição” / “Materiais de Escritório” / “Religião e Cerimoniais” / “Software” / “Equipamentos de Esporte” / “Brinquedos e Jogos” / “Veículos e Peças” / “Livros” / “DVDs e Vídeos” / “Revistas e Jornais” / “Música” / “Outras Categorias Não Especificadas”.	string	2	Todos	Não
53	Identifica se existe rotina de confirmação de celular por SMS. Possíveis valores: “SIM” / “NAO”.	string	2	Todos	Não
54	2ª forma de pagamento.	string	2	Todos	Não
55	3ª forma de pagamento.	string	2	Todos	Não
56	Se a 2ª forma de pagamento for cartão de crédito, enviar a bandeira.	string	1	Todos	Não
57	Se a 3ª forma de pagamento for cartão de crédito, enviar a bandeira.	string	1	Todos	Não
58	Se 2ª forma de pagamento, informar o valor pago. Ex.: 128599 = R$ 1.285,99.	long	2	Todos	Não
59	Se 3ª forma de pagamento, informar o valor pago. Ex.: 59089 = R$ 590,89.	long	2	Todos	Não
60	Quantidade de dias desde a data da última alteração. Ex.: 57.	int	3	Todos	Não
61	Identifica se houve alteração cadastral.	string	1	Todos	Não
62	Quantidade de pontos trocados na última compra.	long	3	Fidelidade	Não
63	Quantidade de pontos restantes no saldo.	long	2	Fidelidade	Não
64	Quantidade de dias desde a última troca de pontos.	long	2	Fidelidade	Não
65	Identificador do cliente no programa de fidelidade.	string	2	Fidelidade	Não
66	Quantidade de minutos recarregados nos últimos 30 dias.	long	2	Digital Goods	Não
67	Quantidade de recargas realizadas nos últimos 30 dias.	long	2	Digital Goods	Não
68	Quantidade de dias entre a data de partida e a data de retorno.	int	2	Aéreo	Não
69	Quantidade de passageiros viajando, independentemente da faixa etária.	int	2	Aéreo	Não
70	Identificador do voô.	string	1	Aéreo	Não
71	Número de infantes viajando.	int	2	Aéreo	Não
72	Número de crianças viajando.	int	2	Aéreo	Não
73	Número de adultos viajando.	int	2	Aéreo	Não
74	Identifica se é um passageiro frequente (frequent flyer). Possíveis valores: “SIM” / “NAO”.	string	2	Aéreo	Não
75	Identificação do passageiro frequente (frequent flyer number).	string	2	Aéreo	Não
76	Categoria do passageiro frequente (frequent flyer). Esta categoria pode variar de acordo com a companhia aérea.	int	2	Aéreo	Não
77	Dia da semana do embarque. Possíveis valores: “Sunday” (Domingo) / “Monday” (Segunda-feira) / “Tuesday” (Terça-feira) / “Wednesday” (Quarta-feira) / “Thursday” (Quinta-feira) / “Friday” (Sexta-feira) / “Saturday” (Sábado).	string	2	Aéreo	Não
78	Código da companhia aérea. Ex.: “JJ” / “LA” / “AA” / “UA” / “G3” etc.	string	1	Aéreo	Não
79	Classe tarifária da passagem. Ex.: “W” / “Y” / “N” etc.	string	2	Aéreo	Não
80	Número do celular do passageiro. Formato: DDIDDDNúmero - Ex.: 5521976781114.	string	2	Aéreo	Não
81	Identifica se o dono do cartão de crédito irá viajar. Possíveis valores: “SIM” / “NAO”.	string	3	Aéreo	Não
82	Identifica se o seller (vendedor) irá trabalhar com revisão manual ou não. Possíveis valores: “SIM” / “NAO”.	string	1	Todos	Não
83	Segmento de negócio. Ex.: Varejo.	string	2	Todos	Sim
84	Nome da plataforma integrada à API Antifraude Gateway Braspag. Caso seja uma integração direta entre a loja e a Braspag, enviar valor igual a “PROPRIA”.	string	3	Todos	Sim
85 a 89	Campos livres e definidos junto ao provedor de Antifraude, conforme as regras de negócio.	—	—	—	Não
90 a 100	Reservados.	—	—	—	Não

Lista de HTTP Status Code

Código HTTP	Mensagem
200	Ok
201	Created
202	Accepted
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
405	Method Not Allowed
500	Internal Server Error
502	Bad Gateway
503	Service Unavailable

Para cada status teremos diferentes cenários, veja alguns exemplos de situações em que cada código pode retornar:

Respostas de sucesso

200 Ok: status informando que a solicitação foi atendida. Pode ser retornado ao obter um AccessToken, por exemplo;
201 Created: status informando que a criação da transação ocorreu corretamente (para todos os tipos de pagamentos: boleto, crédito, débito, transferência eletrônica e e-wallet).

Respostas de erro do Cliente

400 Bad Request: indica alguma falha na requisição (sintaxe JSON inválida);
401 Unauthorized: indica erro de autenticação. Pode ocorrer caso use o MerchantKey errado, por exemplo;
403 Forbidden: não autorizado por conta de restrição de IP na loja;
404 Not Found: o servidor não pode encontrar o recurso solicitado. O endpoint pode estar errado ou, no caso de consulta de pedidos, o pedido pode não existir, pode ter sido criado por outra loja (diferente da loja que você está usando) ou pode ter mais de três meses (período máximo para consultar pedidos na API);
405 Method Not Allowed: o método HTTP está incorreto (POST, PUT, GET, PATCH, DELETE).

Respostas de erro do Servidor

500 Internal Server Error, 502 Bad Gateway ou 503 Service Unavailable: podem ser retornados em alguma falha interna na Braspag, como por exemplo indisponibilidade de algum meio de pagamento ou lentidão.Caso observe um desses retornos, recomendamos contatar o suporte para entender o real motivo.

Lista de Status da Recorrência

Código	Descrição
1	Active.
2	Finished.
3	DisabledByMerchant.
4	DisabledMaxAttempts.
5	DisabledExpiredCreditCard.
6	BoletoWaitingConciliation.

Lista de ReasonCode/ReasonMessage

Reason Code	Reason Message
0	Successful.
1	AffiliationNotFound.
2	InsufficientFunds.
3	CouldNotGetCreditCard.
4	ConnectionWithAcquirerFailed.
5	InvalidTransactionType.
6	InvalidPaymentPlan.
7	Denied.
8	Scheduled.
9	Waiting.
10	Authenticated.
11	NotAuthenticated.
12	ProblemsWithCreditCard.
13	CardCanceled.
14	BlockedCreditCard.
15	CardExpired.
16	AbortedByFraud.
17	CouldNotAntifraud.
18	TryAgain.
19	InvalidAmount.
20	ProblemsWithIssuer.
21	InvalidCardNumber.
22	TimeOut.
23	CartaoProtegidoIsNotEnabled.
24	PaymentMethodIsNotEnabled.
98	InvalidRequest.
99	InternalError.

Códigos de Erros da API

Códigos retornados pela adquirente em caso de erro, identificando o motivo do erro e suas respectivas mensagens. É o ProviderReturnCode e ProviderReturnMessage.

Provider Return Code	Provider Return Message	Descrição
0	Internal error	Dado enviado excede o tamanho do campo.
100	RequestId is required	Campo enviado está vazio ou inválido.
101	MerchantId is required	Campo enviado está vazio ou inválido.
102	Payment Type is required	Campo enviado está vazio ou inválido.
103	Payment Type can only contain letters	Caracteres especiais não permitidos.
104	Customer Identity is required	Campo enviado está vazio ou inválido.
105	Customer Name is required	Campo enviado está vazio ou inválido.
106	Transaction ID is required	Campo enviado está vazio ou inválido.
107	OrderId is invalid or does not exist	Campo enviado excede o tamanho ou contém caracteres especiais.
108	Amount must be greater or equal to zero	Valor da transação deve ser maior que “0”.
109	Payment Currency is required	Campo enviado está vazio ou inválido.
110	Invalid Payment Currency	Campo enviado está vazio ou inválido.
111	Payment Country is required	Campo enviado está vazio ou inválido.
112	Invalid Payment Country	Campo enviado está vazio ou inválido.
113	Invalid Payment Code	Campo enviado está vazio ou inválido.
114	The provided MerchantId is not in correct format	O MerchantId enviado não é um GUID.
115	The provided MerchantId was not found	O MerchantID não existe ou pertence a outro ambiente. (Ex.: Sandbox).
116	The provided MerchantId is blocked	Loja bloqueada, entre em contato com o suporte Braspag.
117	Credit Card Holder is required	Campo enviado está vazio ou inválido.
118	Credit Card Number is required	Campo enviado está vazio ou inválido.
119	At least one Payment is required	Nó `Payment` não enviado.
120	Request IP not allowed. Check your IP White List	IP bloqueado por questões de segurança.
121	Customer is required	Nó `Customer` não enviado.
122	MerchantOrderId is required	Campo enviado está vazio ou inválido.
123	Installments must be greater or equal to one	Número de parcelas deve ser superior a 1.
124	Credit Card is Required	Campo enviado está vazio ou inválido.
125	Credit Card Expiration Date is required	Campo enviado está vazio ou inválido.
126	Credit Card Expiration Date is invalid	Campo enviado está vazio ou inválido.
127	You must provide CreditCard Number	Número do cartão de crédito é obrigatório.
128	Card Number length exceeded	Número do cartão superior a 16 dígitos.
129	Affiliation not found	Meio de pagamento não vinculado à loja ou Provider inválido.
130	Could not get Credit Card	—
131	MerchantKey is required	Campo enviado está vazio ou inválido.
132	MerchantKey is invalid	O Merchantkey enviado não é válido.
133	Provider is not supported for this Payment Type	Provider enviado não existe.
134	FingerPrint length exceeded	Dado enviado excede o tamanho do campo.
135	MerchantDefinedFieldValue length exceeded	Dado enviado excede o tamanho do campo.
136	ItemDataName length exceeded	Dado enviado excede o tamanho do campo.
137	ItemDataSKU length exceeded	Dado enviado excede o tamanho do campo.
138	PassengerDataName length exceeded	Dado enviado excede o tamanho do campo.
139	PassengerDataStatus length exceeded	Dado enviado excede o tamanho do campo.
140	PassengerDataEmail length exceeded	Dado enviado excede o tamanho do campo.
141	PassengerDataPhone length exceeded	Dado enviado excede o tamanho do campo.
142	TravelDataRoute length exceeded	Dado enviado excede o tamanho do campo.
143	TravelDataJourneyType length exceeded	Dado enviado excede o tamanho do campo.
144	TravelLegDataDestination length exceeded	Dado enviado excede o tamanho do campo.
145	TravelLegDataOrigin length exceeded	Dado enviado excede o tamanho do campo.
146	SecurityCode length exceeded	Dado enviado excede o tamanho do campo.
147	Address Street length exceeded	Dado enviado excede o tamanho do campo.
148	Address Number length exceeded	Dado enviado excede o tamanho do campo.
149	Address Complement length exceeded	Dado enviado excede o tamanho do campo.
150	Address ZipCode length exceeded	Dado enviado excede o tamanho do campo.
151	Address City length exceeded	Dado enviado excede o tamanho do campo.
152	Address State length exceeded	Dado enviado excede o tamanho do campo.
153	Address Country length exceeded	Dado enviado excede o tamanho do campo.
154	Address District length exceeded	Dado enviado excede o tamanho do campo.
155	Customer Name length exceeded	Dado enviado excede o tamanho do campo.
156	Customer Identity length exceeded	Dado enviado excede o tamanho do campo.
157	Customer IdentityType length exceeded	Dado enviado excede o tamanho do campo.
158	Customer Email length exceeded	Dado enviado excede o tamanho do campo.
159	ExtraData Name length exceeded	Dado enviado excede o tamanho do campo.
160	ExtraData Value length exceeded	Dado enviado excede o tamanho do campo.
161	Boleto Instructions length exceeded	Dado enviado excede o tamanho do campo.
162	Boleto Demostrative length exceeded	Dado enviado excede o tamanho do campo.
163	Return Url is required	URL de retorno não é valida - Não são aceitas paginação ou extensões (EX.: PHP) na URL de retorno.
166	AuthorizeNow is required	—
167	Antifraud not configured	Antifraude não vinculado ao cadastro do lojista.
168	Recurrent Payment not found	Recorrência não encontrada.
169	Recurrent Payment is not active	Recorrência não está ativa. Execução paralizada.
170	Cartão Protegido not configured	Cartão protegido não vinculado ao cadastro do lojista.
171	Affiliation data not sent	Falha no processamento do pedido, entre em contato com o suporte Braspag.
172	Credential Code is required	Falha na validação das credenciadas enviadas.
173	Payment method is not enabled	Meio de pagamento não vinculado ao cadastro do lojista.
174	Card Number is required	Campo enviado está vazio ou inválido.
175	EAN is required	Campo enviado está vazio ou inválido.
176	Payment Currency is not supported	Campo enviado está vazio ou inválido.
177	Card Number is invalid	Campo enviado está vazio ou inválido.
178	EAN is invalid	Campo enviado está vazio ou inválido.
179	The max number of installments allowed for recurring payment is 1	Campo enviado está vazio ou inválido.
180	The provided Card PaymentToken was not found	Token do cartão protegido não encontrado.
181	The MerchantIdJustClick is not configured	Token do cartão protegido bloqueado.
182	Brand is required	Bandeira do cartão não enviado.
183	Invalid customer bithdate	Data de nascimento inválida ou futura.
184	Request could not be empty	Falha no formato da requisição. Verifique o código enviado.
185	Brand is not supported by selected provider	Bandeira não suportada pela API Braspag.
186	The selected provider does not support the options provided (Capture, Authenticate, Recurrent or Installments)	Meio de pagamento não suporta o comando enviado.
187	ExtraData Collection contains one or more duplicated names	—
188	Avs with CPF invalid	—
189	Avs with length of street exceeded	Dado enviado excede o tamanho do campo.
190	Avs with length of number exceeded	Dado enviado excede o tamanho do campo.
190	Avs with length of complement exceeded	Dado enviado excede o tamanho do campo.
191	Avs with length of district exceeded	Dado enviado excede o tamanho do campo.
192	Avs with zip code invalid	CEP enviado é inválido.
193	Split Amount must be greater than zero	Valor para realização do SPLIT deve ser superior a 0.
194	Split Establishment is Required	SPLIT não habilitado para o cadastro da loja.
195	PlatformId is required	Validados de plataformas não enviado.
196	DeliveryAddress is required	Campo obrigatório não enviado.
197	Street is required	Campo obrigatório não enviado.
198	Number is required	Campo obrigatório não enviado.
199	ZipCode is required	Campo obrigatório não enviado.
200	City is required	Campo obrigatório não enviado.
201	State is required	Campo obrigatório não enviado.
202	District is required	Campo obrigatório não enviado.
203	Cart item name is required	Campo obrigatório não enviado.
204	Cart item quantity is required	Campo obrigatório não enviado.
205	Cart item type is required	Campo obrigatório não enviado.
206	Cart item name length exceeded	Dado enviado excede o tamanho do campo.
207	Cart item description length exceeded	Dado enviado excede o tamanho do campo.
208	Cart item sku length exceeded	Dado enviado excede o tamanho do campo.
209	Shipping addressee sku length exceeded	Dado enviado excede o tamanho do campo.
210	Shipping data cannot be null	Campo obrigatório não enviado.
213	Credit Card Number is invalid	Cartão de crédito enviado é invalido.
214	Credit Card Holder Must Have Only Letters	Portador do cartão não deve conter caracteres especiais.
215	Agency is required in Boleto Credential	Campo obrigatório não enviado.
216	Customer IP address is invalid	IP bloqueado por questões de segurança.
300	MerchantId was not found	—
301	Request IP is not allowed	—
302	Sent MerchantOrderId is duplicated	Houve duplicidade do pedido.
303	Sent OrderId does not exist	—
304	Customer Identity is required	—
306	Merchant is blocked	—
307	Transaction not found	Transação não encontrada ou não existente no ambiente.
308	Transaction not available to capture	Transação não pode ser capturada - Entre em contato com o suporte Braspag.
309	Transaction not available to void	Transação não pode ser cancelada - Entre em contato com o suporte Braspag.
310	Payment method does not support this operation	Comando enviado não suportado pelo meio de pagamento.
311	Refund is not enabled for this merchant	Cancelamento após 24 horas não liberado para o lojista.
312	Transaction not available to refund	Transação não permite cancelamento após 24 horas.
313	Recurrent Payment not found	Transação recorrente não encontrada ou não disponivel no ambiente.
314	Invalid Integration	—
315	Cannot change NextRecurrency with pending payment	—
316	Cannot set NextRecurrency to past date	Não é permitido alterar a data da recorrência para uma data passada.
317	Invalid Recurrency Day	—
318	No transaction found	—
319	Smart Recurrency is not enabled	Recorrência não vinculada ao cadastro do lojista.
320	Cannot Update Affiliation because this recurrency has no affiliation saved	—
321	Cannot Set EndDate to before next recurrency	—
322	Zero Dollar Auth is not enabled	Zero Dollar não vinculado ao cadastro do lojista.
323	Bin Query is not enabled	Consulta de Bins não vinculada ao cadastro do lojista.

Cartões para Teste (Simulado)

O Simulado é um meio de pagamento que emula a utilização de pagamentos com cartão de crédito. Com esse meio de pagamento, é possível simular todos os fluxos de Autorização, Captura e Cancelamento.

Para melhor utilização do meio de pagamento simulado, estamos disponibilizando cartões de testes na tabela abaixo.

Os status das transações serão conforme a utilização de cada cartão.

Status da Transação	Cartões para realização dos testes	Código de Retorno	Mensagem de Retorno
Autorizado	0000000000000000 / 0000000000000001 / 0000000000000004	6	Operação realizada com sucesso
Não Autorizado	0000000000000002	05	Não Autorizada
Não Autorizado	0000000000000003	57	Cartão Expirado
Não Autorizado	0000000000000005	78	Cartão Bloqueado
Não Autorizado	0000000000000006	99	Time Out
Não Autorizado	0000000000000007	77	Cartão Cancelado
Não Autorizado	0000000000000008	70	Problemas com o Cartão de Crédito
Autorização Aleatória	0000000000000009	4 a 99	Operation Successful / Time Out

As informações de código de segurança (CVV) e validade podem ser aleatórias, mantendo o seu formato - “3 dígitos” (CVV) e “MM/YYYY” (Validade). Não utilize pontos ou separadores entre os números do cartão utilizado.

Nota: Se o objetivo for testar uma transação no Pagador salvando o número do cartão, é recomendado usar um gerador de cartões para atender a regra do mod10 (Algoritimo de Luhn), que é empregada nos ambientes Sandbox e de Produção do Cartão Protegido.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].GiftCategory

Valor	Descrição
Yes	Em caso de divergência entre endereços de cobrança e entrega, atribui risco baixo ao pedido.
No	Em caso de divergência entre endereços de cobrança e entrega, atribui risco alto ao pedido (default).
Off	Diferenças entre os endereços de cobrança e entrega não afetam a pontuação.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].HostHedge

Valor	Descrição
Low	Baixa.
Normal	Normal (default).
High	Alta.
Off	Não irá afetar o score da análise de fraude.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].NonSensicalHedge

Valor	Descrição
Low	Baixa.
Normal	Normal (default).
High	Alta.
Off	Não irá afetar o score da análise de fraude.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].ObscenitiesHedge

Valor	Descrição
Low	Baixa.
Normal	Normal (default).
High	Alta.
Off	Não irá afetar o score da análise de fraude.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].TimeHedge

Valor	Descrição
Low	Baixa.
Normal	Normal (default).
High	Alta.
Off	Não irá afetar o score da análise de fraude.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].PhoneHedge

Valor	Descrição
Low	Baixa.
Normal	Normal (default).
High	Alta.
Off	Não irá afetar o score da análise de fraude.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].VelocityHedge

Valor	Descrição
Low	Baixa.
Normal	Normal (default).
High	Alta.
Off	Não irá afetar o score da análise de fraude.

Lista de Valores - Payment.FraudAnalysis.Cart.Items[n].Type

Valor	Descrição
AdultContent	Conteúdo adulto.
Coupon	Cupom aplicado para todo o pedido.
Default	Valor padrão para o tipo do produto. Quando não enviado nenhum outro valor, assume-se o tipo sendo este.
ElectronicGood	Produto eletrônico diferente de software.
ElectronicSoftware	Softwares distribuídos eletronicamente via download.
GiftCertificate	Vale presente.
HandlingOnly	Taxa que você cobra do seu cliente para cobrir os seus custos administrativos de venda. Ex.: Taxa de conveniência / Taxa de instalação.
Service	Serviço que será realizado para o cliente.
ShippingAndHandling	Valor do frete e taxa que você cobra do seu cliente para cobrir os seus custos administrativos de venda.
ShippingOnly	Valor do frete.
Subscription	Assinatura. Ex.: Streaming de vídeos / Assinatura de notícias.

Lista de Valores - Payment.FraudAnalysis.Shipping.Method

Valor	Descrição
SameDay	Entrega no mesmo dia.
OneDay	Entrega no próximo dia.
TwoDay	Entrega em dois dias.
ThreeDay	Entrega em três dias.
LowCost	Entrega de baixo custo.
Pickup	Retirada na loja.
Other	Outro meio de entrega.
None	Sem meio de entrega, pois é um serviço ou assinatura.

Lista de Valores - Payment.FraudAnalysis.Travel.JourneyType

Valor	Descrição
OneWayTrip	Viagem somente de ida.
RoundTrip	Viagem de ida e volta.

Lista de Valores - Payment.FraudAnalysis.Travel.Passengers[n].Rating

Valor	Descrição
Adult	Adulto.
Child	Criança.
Infant	Infante.

Lista de Valores - Payment.FraudAnalysis.Travel.Passengers[n].Status

Valor	Descrição
Standard	Tipo Standard.
Gold	Tipo Gold.
Platinum	Tipo Platinum.

Lista de Valores - Payment.FraudAnalysis.Status

Valor	Descrição
Accept	Transação aceita após análise de fraude.
Review	Transação em revisão após análise de fraude.
Reject	Transação rejeitada após análise de fraude.
Pendent	Transação pendente, pois ao enviar a mesma para análise de fraude ocorreu um timeout na resposta entre Braspag e Cybersource.
Unfinished	Transação não finalizada por algum motivo de validação de contrato ou erro interno.
ProviderError	Transação com erro no provedor ao ser enviada para análise.

Lista de Valores - Payment.FraudAnalysis.FraudAnalysisReasonCode

Valor	Descrição
100	Operação realizada com sucesso.
101	A transação enviada para análise de fraude necessita de um ou mais campos. Verificar no response o campo `ProviderAnalysisResult.Missing`. Possível ação: Reenviar a transação com a informação completa.
102	A transação enviada para análise de fraude possui um ou mais campos com valores inválidos. Verificar no response o campo `ProviderAnalysisResult.Invalid`. Possível ação: Reenviar a transação com as informações corretas.
150	Erro interno. Possível ação: Aguarde alguns minutos e tente reenviar a transação.
151	A transação foi recebida, mas ocorreu time-out no servidor. Este erro não inclui time-out entre o cliente e o servidor. Possível ação: Aguarde alguns minutos e tente reenviar a transação.
152	O pedido foi recebido, mas ocorreu time-out. Possível ação: Aguarde alguns minutos e tente reenviar a transação.
202	Transação recusada pois o cartão expirou ou a data de validade não coincide com a correta. Possível ação: Solicite outro cartão ou outra forma de pagamento.
231	Transação recusada pois o cartão é inválido. Possível ação: Solicite outro cartão ou outra forma de pagamento.
234	Problema com a configuração da loja na Cybersource. Possível ação: Entre em contato com o suporte para corrigir o problema de configuração.
400	A pontuação de fraude ultrapassa o seu limite. Possível ação: Reveja a transação do comprador.
480	A transação foi marcada como revisão pelo DM (Decision Manager).
481	A transação foi rejeitada pelo DM (Decision Manager).

Lista de Valores - Payment.FraudAnalysis.ReplyData.AddressInfoCode

Valor	Descrição
COR-BA	O endereço de cobrança pode ser normalizado.
COR-SA	O endereço de entrega pode ser normalizado.
INTL-BA	O país do endereço de cobrança está fora dos EUA.
INTL-SA	O país do endereço de entrega está fora dos EUA.
MIL-USA	Endereço militar nos EUA.
MM-A	Os endereços de cobrança e entrega usam nomes de ruas diferentes.
MM-BIN	O BIN do cartão (seis primeiros dígitos do número do cartão) não corresponde ao país.
MM-C	Os endereços de cobrança e entrega usam cidades diferentes.
MM-CO	Os endereços de cobrança e entrega usam países diferentes.
MM-ST	Os endereços de cobrança e entrega usam estados diferentes.
MM-Z	Os endereços de cobrança e entrega usam códidos postais diferentes.
UNV-ADDR	O endereço é inverificável.

Lista de Valores - Payment.FraudAnalysis.ReplyData.FactorCode

Valor	Descrição
A	Mudança de endereço excessiva. O comprador mudou o endereço de cobrança duas ou mais vezes nos últimos seis meses.
B	BIN do cartão ou autorização de risco. Os fatores de risco estão relacionados com BIN de cartão de crédito e/ou verificações de autorização do cartão.
C	Elevado número de cartões de créditos. O comprador tem usado mais de seis números de cartões de crédito nos últimos seis meses.
D	Impacto do endereço de e-mail. O comprador usa um provedor de e-mail gratuito ou o endereço de email é arriscado.
E	Lista positiva. O comprador está em sua lista positiva.
F	Lista negativa. O número da conta, endereço, endereço de e-mail ou endereço IP para este fim aparece em sua lista negativa.
G	Inconsistências de geolocalização. O domínio do comprador de e-mail, número de telefone, endereço de cobrança, endereço de envio ou endereço IP é suspeito.
H	Excessivas mudanças de nome. O comprador mudou o nome duas ou mais vezes nos últimos seis meses.
I	Inconsistências de internet. O endereço IP e de domínio de e-mail não são consistentes com o endereço de cobrança.
N	Entrada sem sentido. O nome do comprador e os campos de endereço contêm palavras sem sentido ou idioma.
O	Obscenidades. Dados do comprador contêm palavras obscenas.
P	Mutação de identidade. Vários valores de um elemento de identidade estão ligados ao valor de um elemento de identidade diferente. Por exemplo, vários números de telefones estão ligados a um número de conta única.
Q	Inconsistências do telefone. O número de telefone do comprador é suspeito.
R	Ordem arriscada. A transação, o comprador e o lojista mostram informações correlacionadas de alto risco.
T	Cobertura de horário. O comprador está tentanto uma compra fora do horário esperado.
U	Endereço não verificável. O endereço de cobrança ou de entrega não pode ser verificado.
V	O cartão foi usado muitas vezes nos últimos 15 minutos.
W	Marcado como suspeito. O endereço de cobrança ou de entrega é semelhante a um endereço previamente marcado como suspeito.
Y	O endereço, cidade, estado ou país dos endereços de cobrança e entrega não se correlacionam.
Z	Valor inválido. Como a solicitação contém um valor inesperado, foi substituído por um valor padrão. Embora a transação ainda possa ser processada, examinar o pedido com cuidado para detectar anomalias.

Lista de Valores - Payment.FraudAnalysis.ReplyData.InternetInfoCode

Valor	Descrição
FREE-EM	O endereço de e-mail do comprador é de um provedor de e-mail gratuito.
INTL-IPCO	O país do endereço de e-mail do comprador está fora dos EUA.
INV-EM	O endereço de e-mail do comprador é inválido.
MM-EMBCO	O domínio do endereço de e-mail do comprador não é consistente com o país do endereço de cobrança.
MM-IPBC	O endereço de e-mail do comprador não é consistente com a cidade do endereço de cobrança.
MM-IPBCO	O endereço de e-mail do comprador não é consistente com o país do endereço de cobrança.
MM-IPBST	O endereço IP do comprador não é consistente com o estado no endereço de cobrança. No entanto, este código de informação não pode ser devolvido quando a inconsistência é entre estados imediatamente adjacentes.
MM-IPEM	O endereço de e-mail do comprador não é consistente com o endereço IP.
RISK-EM	O domínio do e-mail do comprador (por exemplo, mail.example.com) está associado com alto risco.
UNV-NID	O endereço IP do comprador é de um proxy anônimo. Estas entidades escondem completamente informações sobre o endereço de IP.
UNV-RISK	O endereço IP é de origem de risco.
UNV-EMBCO	O país do endereço de e-mail não corresponde ao país do endereço de cobrança.

Lista de Valores - Payment.FraudAnalysis.ReplyData.IpRoutingMethod

Valor	Descrição
Anonymizer	Endereços de IP estão escondidos porque o comprador é extremamente cauteloso, quer privacidade absoluta ou é fraudulento.
AOL, AOL dialup, AOL POP and AOL proxy	Membros da AOL. Na maioria dos casos, o país pode ser identificado, mas o estado e cidade não.
Cache proxy	Proxy usado através de um acelerador da internet ou de uma distribuição de conteúdo de serviço. O comprador pode estar localizado em um país diferente do indicado pelo endereço de IP.
Fixed	O endereço de IP está próximo ou no mesmo local que o comprador.
International proxy	Proxy que contém tráfego de vários países. O comprador pode estar localizado em um país diferente do indicado pelo endereço de IP. Em muitos casos, redes corporativas estão roteando o tráfego de escritórios internacionais através de um ponto central, muitas vezes a sede corporativa.
Mobile gateway	Gateway para conectar dispositivos móveis à internet. Muitas operadoras, especialmente na Europa, atendem a mais do que um país e o tráfego ocorre através de hubs de rede centralizados. O comprador pode estar localizado em um país diferente do indicado pelo endereço de IP.
POP	Discagem do comprador em um ISP regional provavelmente perto da localização do endereço de IP, mas possivelmente através de limites geográficos.
Regional proxy	Proxy que contém tráfego de vários estados dentro de um único país. O comprador pode estar localizado em um estado diferente do indicado pelo endereço de IP. Em muitos casos, redes corporativas estão roteando o tráfego de escritórios internacionais através de um ponto central, muitas vezes a sede corporativa.
Satellite	Conexões por satélite. Se o uplink e o downlink estiverem cadastrados, o método “roteamento” é considerado padrão porque o remetente é conhecido. No entanto, se o downlink não está registrado, o comprador pode estar em qualquer lugar dentro do feixe padrão do satélite, que pode abranger um continente ou mais.
SuperPOP	O comprador está discando em um ISP multi-estatal ou multinacional que provavelmente não é compativel à localização do endereço de IP. O comprador pode estar discando através de limites geográficos.
No value returned	O tipo de roteamento é desconhecido.

Lista de Valores - Payment.Chargebacks[n].Status

Valor	Descrição
Received	Chargeback recebido da adquirente.
AcceptedByMerchant	Chargeback aceito pela loja. Neste caso a loja entende que sofreu de fato um chargeback e não irá realizar a contestação.
ContestedByMerchant	Chargeback contestado pela loja. Neste caso a loja enviou os documentos necessários para tentar reverter o chargeback.

Lista de Valores - Payment.Chargebacks[n].ReasonCode e Payment.Chargebacks[n].ReasonMessage

Código	Descrição	Bandeira	Fraude?
137	Mercadoria / Serviço cancelado.	Visa	Não
127	Dados inválidos.	Visa	Não
113	Não autorizada.	Visa	Não
136	Crédito não processado.	Visa	Não
125	Valor incorreto.	Visa	Não
132	Recorrência cancelada.	Visa	Não
123	Moeda incorreta.	Visa	Não
133	Mercadoria / Serviço defeituoso ou diferente do descrito.	Visa	Não
112	Autorização recusada.	Visa	Não
134	Mercadoria falsificada.	Visa	Não
135	Venda enganosa.	Visa	Não
102	Responsabilidade EMV - Sem falsificação.	Visa	Sim
101	Responsabilidade EMV - Falsificação.	Visa	Sim
122	Código de transação incorreto.	Visa	Não
105	Programa Visa de Monitoramento de Fraude.	Visa	Sim
126	Processamento duplicado / pago por outros meios.	Visa	Não
131	Mercadoria / Serviços não recebidos.	Visa	Não
103	Outras Fraudes - cartão presente.	Visa	Sim
121	Apresentação tardia.	Visa	Não
111	Boletim de recuperação de cartões.	Visa	Não
137	Transação de crédito original não aceita.	Visa	Não
104	Outras fraudes - cartão ausente.	Visa	Sim
124	Número de conta incorreto.	Visa	Não
4846	Código correto da moeda da transação não fornecido.	Master	Não
4857	Transação telefônica ativada por cartão.	Master	Não
4859	Serviços não prestados.	Master	Não
4812	Número da conta não consta no arquivo (inexistente).	Master	Não
4807	Arquivo Boletim de Advertência.	Master	Não
4808	Autorização requerida não obtida.	Master	Não
4870	Transferência de responsabilidade do chip.	Master	Sim
4853	Desacordo comercial.	Master	Não
4847	Excede o limite de piso - transação não autorizada.	Master	Não
4837	Sem autorização do portador do cartão.	Master	Sim
4871	Transf. de responsabilidade do chip/senha (Europa).	Master	Sim
4849	Estabelecimento comercial de atividades suspeitas.	Master	Sim
4841	Transação recorrente cancelada.	Master	Não
4842	Apresentação tardia.	Master	Não
4855	Mercadoria não recebida.	Master	Não
4850	Portador não reconhece.	Master	Sim
4840	Processamento fraudulento da transação.	Master	Sim
4863	Portador não reconhece a transação.	Master	Sim
4831	Valor da transação é diferente.	Master	Não
4854	Contestação do portador de cartão (EUA).	Master	Sim
4860	Crédito não processado.	Master	Não
4834	Erro de processamento.	Master	Não
4862	Transação falsificada por fraude da tarja magnética.	Master	Sim
4835	Cartão inválido ou vencido.	Master	Não
4554	Bens e serviços não recebidos.	Amex	Não
4515	Pagamento por outros meios.	Amex	Não
4527	Ausência de impressão.	Amex	Sim
4523	Número de conta de associado do cartão não atribuído.	Amex	Não
4517	Cópia atendida ilegível/incompleta.	Amex	Não
4752	Erro de apresentação de crédito/débito.	Amex	Não
4530	Discrepância de moeda.	Amex	Não
4516	Cópia não atendida.	Amex	Não
4799	Transferência de responsabilidade por fraude/perda/roubo não reconhecida.	Amex	Sim
4536	Apresentação tardia.	Amex	Não
4750	Débito de aluguel de carro não qualificado.	Amex	Não
4755	Sem autorização válida.	Amex	Não
4553	Mercadoria defeituosa ou não conforme descrita.	Amex	Não
4754	Contestação regulatória/legal local.	Amex	Não
4540	Cartão não presente.	Amex	Sim
4544	Cancelamento de bens/serviços recorrentes.	Amex	Não
4513	Crédito não processado.	Amex	Não
4534	ROCs múltiplos.	Amex	Não
4763	Direito de regresso integral por fraude.	Amex	Sim
4507	Valor da transação incorreto ou número de conta.	Amex	Não
4798	Transferência de responsabilidade por fraude.	Amex	Sim
4521	Autorização inválida.	Amex	Não
4512	Múltiplos processamentos.	Amex	Não
41	Transação recorrente cancelada.	Elo	Não
71	Autorização negada.	Elo	Não
74	Apresentação tardia.	Elo	Não
75	Portador não se lembra da transação.	Elo	Sim
62	Transação falsificada (transferência de responsabilidade).	Elo	Sim
82	Duplicidade de processamento.	Elo	Não
53	Mercadoria com defeito ou em desacordo.	Elo	Não
83	Fraude em ambiente de cartão não presente.	Elo	Sim
80	Valor da transação ou número de cartão incorreto.	Elo	Não
76	Moeda inválida.	Elo	Não
30	Serviço não prestado ou mercadoria não recebida.	Elo	Não
72	Sem autorização.	Elo	Não
85	Crédito não processado.	Elo	Não
73	Cartão vencido.	Elo	Não
81	Fraude em ambiente de cartão presente.	Elo	Sim
70	Cartão em boletim.	Elo	Não
86	Pagamentos por outros meios.	Elo	Não
4812	Número da conta não consta no arquivo (inexistente).	Diners	Não
4841	Transação recorrente cancelada.	Diners	Não
4850	Portador não reconhece.	Diners	Sim
4846	Código correto da moeda da transação não fornecido.	Diners	Não
4847	Excede o limite de piso - transação não autorizada.	Diners	Não
4859	Serviços não prestados.	Diners	Não
4831	Valor da transação é diferente.	Diners	Não
4849	Estabelecimento comercial de atividades suspeitas.	Diners	Sim
4835	Cartão inválido ou vencido.	Diners	Não
4842	Apresentação tardia.	Diners	Não
4807	Arquivo boletim de advertência.	Diners	Não
4871	Transferência de responsabilidade do chip/senha (Europa).	Diners	Sim
4855	Mercadoria não recebida.	Diners	Não
4808	Autorização requerida não obtida.	Diners	Não
4837	Sem autorização do portador do cartão.	Diners	Sim
4840	Processamento fraudulento da transação.	Diners	Sim
4853	Desacordo comercial.	Diners	Não
4834	Erro de processamento.	Diners	Não
4808	Autorização requerida não obtida.	Hipercard	Não
4834	Erro de processamento.	Hipercard	Não
4860	Crédito não processado.	Hipercard	Não
4857	Transação telefônica ativada por cartão.	Hipercard	Não
4850	Portador não reconhece.	Hipercard	Sim
4807	Arquivo boletim de advertência.	Hipercard	Não
4859	Serviços não prestados.	Hipercard	Não
4862	Transação falsificada por fraude da tarja magnética.	Hipercard	Sim
4849	Estabelecimento comercial de atividades suspeitas.	Hipercard	Sim
4853	Desacordo comercial.	Hipercard	Não
4837	Sem autorização do portador do cartão.	Hipercard	Sim
4847	Excede o limite de piso - transação não autorizada.	Hipercard	Não
4871	Transferência de responsabilidade do chip/senha (Europa).	Hipercard	Sim
4812	Número da conta não consta no arquivo (inexistente).	Hipercard	Não
4831	Valor da transação é diferente.	Hipercard	Não
4840	Processamento fraudulento da transação.	Hipercard	Sim
4841	Transação recorrente cancelada.	Hipercard	Não
4870	Transferência de responsabilidade do chip.	Hipercard	Sim
4863	Portador não reconhece a transação.	Hipercard	Sim
4842	Apresentação tardia.	Hipercard	Não
4854	Contestação do portador de cartão (EUA).	Hipercard	Sim
4855	Mercadoria não recebida.	Hipercard	Não
4835	Cartão inválido ou vencido.	Hipercard	Não
4846	Código correto da moeda da transação não fornecido.	Hipercard	Não