Decrypted card

Create a payment with e-wallet using a decrypted card

EnvironmentMethodEndpoint
Sandboxhttps://apisandbox.braspag.com.br/v2/sales/
Productionhttps://api.braspag.com.br/v2/sales/

Authorization with a decrypted card occurs when the store itself decrypts the payload received from the wallet and sends it on its own to the Gateway de Pagamento for processing and authorization. In this scenario, send the following request model for authorization:

Request

{
  "MerchantOrderId": "6242-642-723",
  "Customer": {
    "Name": "Guilherme Gama",
    "Identity": "11225468954",
    "IdentityType": "CPF"
  },
  "Payment": {
    "Type": "CreditCard",
    "Amount": 1100,
    "Provider": "Cielo",
    "Installments": 1,
    "CreditCard": {
      "CardNumber":"4532********6521",
      "Holder":"Guilherme Gama",
          "ExpirationDate":"12/2021",
          "SecurityCode":"123",
          "Brand":"Master"
    },
    "Wallet": {
      "Type": "Tipo de wallet",
      "Eci":"7",
      "Cavv":"AM1mbqehL24XAAa0J04CAoABFA=="
    }
  }
}

Below is the list of request fields:

PropertyTypeSizeRequiredDescription
MerchantIdGuid36YesStore identifier at Braspag.
MerchantKeyText40YesPublic key for dual authentication at Braspag.
RequestIdGuid36NoRequest identifier, used when the merchant uses different servers for each GET/POST/PUT.
MerchantOrderIdText50YesOrder ID number.
Customer.NameText255NoCustomer's name.
Customer.StatusText255NoCustomer's registration status ("NEW" / "EXISTING").
Payment.TypeText100YesPayment method type.
Payment.AmountNumber15YesOrder amount in cents.
Payment.InstallmentsNumber2YesNumber of installments.
CreditCard.CardNumber.Text19YesCustomer's card number
CreditCard.SecurityCodeTexto4NãoSecurity code printed on the back of the card.
CreditCard.BrandText10YesCard brand (Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover / Hipercard / Hiper).
Wallet.TypeText255YesWallet type: AndroidPay / ApplePay / SamsungPay
Wallet.WalletkeyText255YesCryptographic key representing card data. Consult the table WalletKey for more information.
Wallet.EciText3YesThe ECI (Electronic Commerce Indicator) represents how safe a transaction is. This value must be taken into account by the merchant when deciding on capturing the transaction.
Wallet.CavvText255YesValidation field returned by Wallet and used as authorization basis.

Response

{
  "MerchantOrderId": "2014111703",
  "Customer": {
    "Name": "[Guest]"
  },
  "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": 0,
    "Capture": false,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "453211******1521",
      "Holder": "Gama Gama",
      "ExpirationDate": "08/2020",
      "SaveCard": false,
      "Brand": "Visa"
    },
    "Tid": "0319040817883",
    "ProofOfSale": "817883",
    "AuthorizationCode": "027795",
    "Wallet": {
      "Type": "TIPO DE WALLET",
      "Eci": 0
    },
    "SoftDescriptor": "123456789ABCD",
    "Amount": 100,
    "ReceivedDate": "2018-03-19 16:08:16",
    "Status": 1,
    "IsSplitted": false,
    "ReturnMessage": "Operation Successful",
    "ReturnCode": "4",
    "PaymentId": "e57b09eb-475b-44b6-ac71-01b9b82f2491",
    "Type": "CreditCard",
    "Currency": "BRL",
    "Country": "BRA",
    "Links": [
        {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491"
        },
        {
            "Method": "PUT",
            "Rel": "capture",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/capture"
        },
        {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/void"
        }
    ]
  }
}

Below is the list of response fields:

PropertyTypeSizeRequiredDescription
ProofOfSaleAuthorization number, identical to NSU.Text6Alphanumeric
TidTransaction ID in the acquirer.Text20Alphanumeric
AuthorizationCodeAuthorization code.Text6Alphanumeric
SoftDescriptorText to be printed on customer’s invoice. Note: Does not allow special characters. Available for VISA/MASTER only.Text13Alphanumeric
PaymentIdOrder identifier field.Guid36xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ECIEletronic Commerce Indicator. Represents how secure a transaction is.Text2E.g.: 7
StatusTransaction status.Byte-2
ReturnCodeReturn code from acquirer.Text32Alphanumeric
ReturnMessageReturn message from acquirer.Text512Alphanumeric
TypeWallet type: ApplePay|, GooglePay or SamsungPayText255Alphanumeric
WalletkeyCryptographic key representing card data. Consult the table WalletKey for more information.Text255Check the WalletKey table