Criar transação com cartão de crédito tokenizado

O CardToken é o cartão tokenizado retornado ao salvar o cartão durante a autorização .

Este é um exemplo de como usar o CardToken já existente 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, é preciso solicitar esta informação ao portador para cada nova transação.
  • Para criar transações recorrentes (que permitem transacionar sem utilizar o CVV), entre em contato com o nosso Suporte.

O nó CreditCard dentro do nó Payment será alterado conforme exemplo a seguir:

Requisição

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

{
  "MerchantOrderId": "2017051001",
  "Customer": {
    "Name": "Aline de Souza",
    "Identity": "12345678900",
    "IdentityType": "CPF",
    "Email": "[email protected]",
    "Birthdate": "1990-01-01",
    "IpAddress": "127.0.0.1",
    "Address": {
      "Street": "Rua das Rosas",
      "Number": "123",
      "Complement": "Apartamento 101",
      "ZipCode": "12345987",
      "City": "São Paulo",
      "State": "SP",
      "Country": "BR",
      "District": "Centro"
    },
    "DeliveryAddress": {
      "Street": "Rua das Rosas",
      "Number": "123",
      "Complement": "Apartamento 101",
      "ZipCode": "12345987",
      "City": "São Paulo",
      "State": "SP",
      "Country": "BR",
      "District": "Centro"
    }
  },
  "Payment": {
    "Provider": "Simulado",
    "Type": "CreditCard",
    "DoSplit": true,
    "Amount": 10000,
    "Currency": "BRL",
    "Country": "BRA",
    "Installments": 1,
    "Capture": true,
    "Authenticate": false,
    "Recurrent": false,
    "SoftDescriptor": "Mensagem",
    "CreditCard": {
      "CardToken": "1be20054-7042-4e7d-a154-bb413c911597",
      "SecurityCode": "123",
      "Brand": "Visa"
    },
    "InitiatedTransactionIndicator": {
      "Category": "C1",
      "Subcategory": "Standingorder"
    },
    "SplitPayments": [
      {
        "SubordinateMerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
        "Amount": 5000,
        "Fares": {
          "Mdr": 5,
          "Fee": 30
        }
      },
      {
        "SubordinateMerchantId": "9140ca78-39667-44a5-bd44-793370afef94",
        "Amount": 5000,
        "Fares": {
          "Mdr": 4,
          "Fee": 15
        }
      }
    ]
  }
}
PropriedadeDescriçãoTipoTamanhoObrigatório?
Payment.ProviderNome do provedor do meio de pagamento.Texto15Sim
Payment.TypeTipo do meio de pagamento.Texto100Sim
Payment.AmountValor do pedido, em centavos.Número15Sim
Payment.InstallmentsNúmero de parcelas.Número2Sim
CreditCard.CardTokenToken no Cartão Protegido que representa os dados do cartão.GUID36xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
CreditCard.SecurityCodeCódigo de segurança impresso no verso do cartão. Para processar vendas sem o CVV, é necessário solicitar liberação na adquirente.Texto4Não
CreditCard.BrandBandeira do cartão.Texto10Sim
InitiatedTransactionIndicator.CategoryObrigatório para bandeira Mastercard. Categoria do indicador de início da transação. Válido apenas para bandeira Mastercard.
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.
Texto2Não
InitiatedTransactionIndicator.SubcategoryObrigatório para bandeira Mastercard. Subcategoria do indicador. Válido apenas para bandeira Mastercard.
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 <a href="https://docs.cielo.com.br/gateway/page/cit-mit" target="_blank">Indicador de Início da Transação</a>.
Texto--Não

Resposta

{  
   [...]
   },
     "Payment": {
        "Provider": "Simulado",
        "Type": "CreditCard",
        "Amount": 10000,
        "Currency": "BRL",
        "Country": "BRA",
        "Installments": 1,
        "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",
   [...]
  }
}
PropriedadeDescriçãoTipoTamanhoFormato
AcquirerTransactionIdId da transação no provedor de meio de pagamento.Texto40Texto alfanumérico
ProofOfSaleNúmero do comprovante de venda.Texto20Texto alfanumérico
AuthorizationCodeCódigo de autorização.Texto300Texto alfanumérico
PaymentIdCampo identificador do pedido.GUID36xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ReceivedDateData em que a transação foi recebida pelo Split.Texto19AAAA-MM-DD HH:mm:SS
ReasonCodeCódigo de retorno da operação.Texto32Texto alfanumérico
ReasonMessageMensagem de retorno da operação.Texto512Texto alfanumérico
StatusStatus da transação.Byte2Ex.: 1
ProviderReturnCodeCódigo retornado pelo provedor do meio de pagamento (adquirente ou emissor).Texto3257
ProviderReturnMessageMensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor).Texto512Transação Aprovada