Create a non-authenticated debit card payment

Environment

Method

Endpoint

Sandbox

https://apisandbox.braspag.com.br/v2/sales/

Production

https://apiquerysandbox.braspag.com.br/v2/sales/

Request

{  
   "MerchantOrderId":"2017051001",
   "Customer":{  
      "Name":"Nome do Comprador",
      "Identity":"12345678909",
      "IdentityType":"CPF",
      "Email":"[email protected]",
      "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"
        },
        [...]
    }
}

Property

Description

Type

Size

Required?

Payment.Provider

Name of payment method provider. Applicable to "Cielo30" only.

Text

15

Yes

Payment.Type

Payment method type. In this case, "DebitCard".

Text

100

Yes

Payment.Amount

Order amount in cents.

Number

15

Yes

Payment.Installments

Number of installments. For this type, always use "1".

Number

2

Yes

DeditCard.CardNumber

Customer's card number.

Text

16

Yes

DeditCard.Holder

Name of cardholder printed on the card.

Text

25

Yes

DebitCard.ExpirationDate

Expiration date printed on the card, in the MM/YYYY format.

Text

7

Yes

DebitCard.SecurityCode

Security code printed on the back of the card.

Text

4

Yes

DebitCard.Brand

Card brand. For this type, always use "Elo".

Text

10

Yes

DebitCard.CardOnFile.Usage

"First" if the card has been stored and it is your first use.
"Used" if the card has been stored and it has been used previously in another transaction.

Applicable toProvider Cielo only.

Text

No

DebitCard.CardOnFile.Reason

Indicates the purpose of the card storage, in case the Usage field is "Used".

"Recurring" - Scheduled recurring purchase (e.g.: subscription services).
"Unscheduled" - Unscheduled recurring purchase (e.g.: services apps).
"Installments" - Installment through recurrence.

Applicable toProvider Cielo only.

Text

Conditional

Response

{
 [...]
  "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",
    "Status": 2,
    "ProviderReturnCode": "6",
    "ProviderReturnMessage": "Operation Successful",
    [...]
  }
}
PropertyDescriptionTypeSizeFormat
AcquirerTransactionIdTransaction ID of the payment method provider.Text40Alphanumeric
ProofOfSaleProof of sale reference.Text20Alphanumeric
AuthorizationCodeAuthorization code from the acquirer.Text300Alphanumeric text
PaymentIdOrder identifier field.GUID36xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ReceivedDateDate the transaction was received by Braspag.Text19YYYY-MM-DD HH:mm:SS
ReasonCodeOperation return code.Text32Alphanumeric
ReasonMessageOperation return message.Text512Alphanumeric
StatusTransaction status.Byte2E.g.: 1
ProviderReturnCodeCode returned by the payment provider (acquirer or issuer).Text3257
ProviderReturnMessageMessage returned by the payment provider (acquirer or issuer).Text512Transaction Approved