Create a debit transaction

ℹ️

Send Payment.Type as "DebitCard";

Send the Payment.DebitCard node;

Do not include the Payment.FraudAnalysis node, as the transaction does not require fraud analysis;

The debit transaction must be submitted for authentication. Therefore, send the Payment.ExternalAuthentication node with the data received during the 3DS authentication process. For more details on 3DS integration, visit 3DS authentication manual.

TLID Mastercard

The Transaction Link Identifier (TLID), sent and returned in the TransactionLinkId field, is a unique identifier generated by the Mastercard card brand during a CIT, used to link related MITs. The TLID applies to the VerifyCard response (response only) and to credit, debit, and recurring transactions.

For Mastercard, send IssuerTransactionId and TransactionLinkId together in MITs: both parameters are mandatory.

Phase	Description
Phase 1	Current. The `TransactionLinkId` field is available in the responses of VerifyCard by card number, credit card payment creation, debit card payment creation, and in the query by `PaymentId`.
Phase 2	Required inclusion of the `TransactionLinkId` in the request (MIT) starting Oct 23, 2026.

Scheduled recurrence: in subsequent transactions, the IssuerTransactionId and TransactionLinkId fields are sent automatically.

The TransactionLinkId sent in the request must have exactly 22 characters (A-Z, a-z, 0-9, hyphen, and underscore). If the value is outside this format, Cielo ignores it without returning an error. When Cielo sends the TLID to the card brand, the response also includes SentTransactionLinkId, with the value that was sent. The VerifyCard request does not accept the field.

See more details in Brand identifiers for Cielo acquirer.

Request

Ambiente	Método	Endpoint
Sandbox	post	`https://apisandbox.braspag.com.br/v2/sales/`
Produção	post	`https://api.braspag.com.br/v2/sales/`

{
  "MerchantOrderId": "202301131052",
  "Customer": {
    "Name": "Aline De Souza",
    "Identity": "12345678909",
    "IdentityType": "CPF",
    "Email": "[email protected]",
    "Birthdate": "1990-01-01",
    "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": "DebitCard",
    "DoSplit": true,
    "Amount": 10000,
    "capture": true,
    "installments": 1,
    "softdescriptor": "teste",
    "Returnurl": "https://www.UrlDeRetornoDoLojista.com.br/",
    "Authenticate": true,
    "Recurrent": false,
    "Tip": false,
    "DebitCard": {
      "CardNumber": "5200000000002151",
      "Holder": "Aline De Souza",
      "ExpirationDate": "03/2031",
      "SecurityCode": "079",
      "SaveCard": false,
      "Brand": "Master",
      "CardOnFile": {
        "Usage": "Used"
      }
    },
    "ExternalAuthentication": {
      "Cavv": "AAABB2gHA1B5EFNjWQcDAAAAAAB=",
      "Xid": "Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
      "Eci": 5,
      "Version": "2",
      "ReferenceId": "a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
    },
    "InitiatedTransactionIndicator": {
      "Category": "C1",
      "Subcategory": "Standingorder"
    }
  },
  "splitpayments": [
    {
      "subordinatemerchantid": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
      "amount": 5000,
      "fares": {
        "mdr": 5,
        "fee": 30
      }
    },
    {
      "subordinatemerchantid": "9140ca78-3955-44a5-bd44-793370afef94",
      "amount": 5000,
      "fares": {
        "mdr": 4,
        "fee": 15
      }
    }
  ]
}

Below are the header properties for this request:

Header parameters:

Property	Type	Size	Required	Description
`Content-Type`	Text	--	Yes	application/json
`MerchantId`	Text	36	Yes	Store identifier at Gateway de Pagamento.
`MerchantKey`	Text	40	Yes	Public key for dual authentication at Gateway de Pagamento.
`RequestId`	Text	36	No	Store-defined request identifier used when the merchant uses different servers for each.

Body parameters:

Property	Type	Size	Required	Description
`MerchantOrderId`	Text	50	Yes	Order ID number.
`Customer.Name`	Text	255	No	Customer's name. Warning: Only a-z, A-Z characters are allowed. Special characters and numbers are not allowed.
`Customer.Identity`	Text	14	No	Customer's ID number. Allows submission of alphanumeric CNPJs.
`Customer.IdentityType`	Text	255	No	ustomer's ID document type (CPF or CNPJ).
`Customer.Email`	Text	255	No	Customer's email address.
`Customer.IpAddress`	Text	45	No	Customer's IP address. IPv4 and IPv6 support.
`Customer.Address.Street`	Text	255	No	Customer's address street.
`Customer.Address.Number`	Text	15	No	Customer's contact address number.
`Customer.Address.Complement`	Text	50	No	Customer's contact address additional information.
`Customer.Address.ZipCode`	Text	9	No	Customer's contact address zip code.
`Customer.Address.City`	Text	50	No	Customer's contact address city.
`Customer.Address.State`	Text	2	No	Customer's contact address state.
`Customer.Address.Country`	Text	35	No	Customer's contact address country.
`Customer.Address.District`	Text	50	No	Customer's neighborhood.
`Customer.DeliveryAddress.Street`	Text	255	No	Delivery address street.
`Customer.DeliveryAddress.Number`	Text	15	No	Delivery address number.
`Customer.DeliveryAddress.Complement`	Text	50	No	Delivery address additional information.
`Customer.DeliveryAddress.ZipCode`	Text	9	No	Delivery address zip code.
`Customer.DeliveryAddress.City`	Text	50	No	Delivery address city.
`Customer.DeliveryAddress.State`	Text	2	No	Delivery address state.
`Customer.DeliveryAddress.Country`	Text	35	No	Delivery address country.
`Customer.DeliveryAddress.District`	Text	50	No	Delivery address neighborhood.
`Payment.Provider`	Text	15	Yes	Name of payment method provider.
`Payment.Type`	Text	100	Yes	Payment method type. In this case, "DebitCard".
`Payment.Amount`	Number	15	Yes	Order amount in cents.
`Payment.Installments`	Number	2	No	Number of installments.
`Payment.ReturnUrl`	Text	1024	Yes	URL to which the user will be redirected at the end of the payment.
`Payment.Tip`	Boolean	--	No	Tipping is a type of transaction available for credit or debit card, tokenized or not. If "true", the transaction is identified as a tip, otherwise send Tip as "false".
`DoSplit`	Boolean	--	Yes	Indicates whether the transaction will be split among multiple participants. Possible values: true / false
`SplitPayments.SubordinateMerchantId`	Text	36	No	`MerchantId` (identifier) of the seller.
`SplitPayments.Amount`	Number	--	No	Gross amount of the seller's share in the transaction, in cents. The fee discount will be calculated by the Split.
`SplitPayments.Fares.Mdr`	Text	--	No	MDR(%) of the master to be discounted from the value referring to the participation of the seller. Type: decimal.
`SplitPayments.Fares.Fee`	Number	--	No	Fixed Fee(R$) to be discounted from the value referring to the participation of the seller, in cents.
`Payment.DebitCard.CardNumber`	Text	16	Yes	Customer's card number. Size: 16.
`Payment.DebitCard.Holder`	Text	25	Yes	Name of the cardholder printed on the card.
`Payment.DebitCard.ExpirationDate`	Text	7	Yes	Expiration date printed on the card, in the MM/YYYY format.
`Payment.DebitCard.SecurityCode`	Text	4	Yes	Security code printed on the back of the card. Not a required field. To process transactions without CVV, the store must have authorization from the acquirer.
`Payment.DebitCard.Brand`	Text	10	Yes	Card brand. Click here to access the list of possible values.
`Payment.DebitCard.CardOnFile.Usage`	Text	--	No	"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 to Cielo, Rede e Safra. Saiba mais em Card On File.
`Payment.Authenticate`	Boolean	--	Yes	Defines whether the buyer will be directed to the issuer for card authentication. Yes, if the authentication is validated.
`Payment.ExternalAuthentication.Cavv`	Text	--	Yes	Signature returned in successful authentication scenarios. ⚠️This field is required for transactions authenticated by the issuer or the network and for authorization requests with Data Only.
`Payment.ExternalAuthentication.Xid`	Text	28	Yes	Field required only when the 3DS version is “2” or higher. XID returned in the authentication process. Size: 28.
`Payment.ExternalAuthentication.Eci`	Number	2	Yes	Electronic Commerce Indicator returned in the authentication process.
`Payment.ExternalAuthentication.ReferenceId`	Text	36	Yes	Field required only when the 3DS version is “2” or higher. RequestID returned in the authentication process. Size: 36. * The `ReferenceId` is not returned in all authentications. * Sending is recommended if the `ReferenceId` was returned in the script.
`Payment.ExternalAuthentication.DataOnly`	Text	--	No	Defines if it is a 3DS authentication transaction of the Data Only type. Submission is required in the case of a Data Only transaction.
`Payment.ExternalAuthentication.Version`	Text	5	No	⚠️ Required for transactions with 3DS authentication. Version of the 3DS protocol applied in the authentication process. Possible values: - Visa and Mastercard: "2.2.0" - Elo and Amex: "2.1.0"
`Payment.InitiatedTransactionIndicator.Category`	Text	2	No	Transaction Initiator Indicator category. Valid for brands Mastercard and Hipercard. Possible values: - “C1”: transaction initiated by the cardholder; - “M1”: recurring payment or installment initiated by the merchant - “M2”: transaction initiated by the merchant.
`Payment.InitiatedTransactionIndicator.Subcategory`	Text	--	No	Indicator subcategory. Valid for brands Mastercard and Hipercard. Possible values: If `InitiatedTransactionIndicator.Category` = "C1" or "M1" CredentialsOnFile StandingOrder Subscription Installment If `InitiatedTransactionIndicator.Category` = "M2" PartialShipment RelatedOrDelayedCharge NoShow Resubmission Please refer to Transaction Initiator Indicator. tables for the full list.
`Payment.IssuerTransactionId`	Text	30	No	Transaction identifier generated by the card brand, returned in the CIT or in VerifyCard. Send in recurring, incremental, and re-authorized MITs. Mandatory for the Visa, Mastercard, Elo, and Amex card brands.
`Payment.TransactionLinkId`	Text	22	No	Unique identifier generated by the Mastercard card brand (TLID), used to link the CIT to related subsequent MITs, such as recurring payments, future installments, post-authorization charges, and card-on-file payments. Send the original value together with `IssuerTransactionId`: both are mandatory for Mastercard, and sending the `TransactionLinkId` is mandatory starting Oct 23, 2026. Format: 22 alphanumeric characters (A-Z, a-z, case-sensitive), and may include hyphen (-) and underscore (_). If the value is null, empty, or outside this format, Cielo ignores it without returning an error.

Response

{
    "MerchantOrderId": "30082019",
    "Customer": {
        "Name": "Comprador Accept",
        "Identity": "18160361106",
        "IdentityType": "CPF",
        "Email": "[email protected]",
        "Mobile": "5521995760078"
    },
    "Payment": {
        "DebitCard": {
            "CardNumber": "448153******6111",
            "Holder": "Yamilet Taylor",
            "ExpirationDate": "12/2019",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "Authenticate": true,
        "IssuerTransactionId": "580027442382078",
        "ExternalAuthentication":{
            "Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
            "Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
            "Eci":"5",
            "Version":"2",
            "ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
        },
        "ReturnUrl": "https://www.UrlDeRetornoDoLojista.com.br/",        
        "ProofOfSale": "439387",
        "AcquirerTransactionId": "0830110439387",
        "SoftDescriptor": "teste",
        "SplitPayments": [
            {
                "SubordinateMerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
                "Amount": 5000,
                "Fares": {
                    "Mdr": 5.0,
                    "Fee": 30
                },
                "Splits": [
                    {
                        "MerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
                        "Amount": 4720
                    },
                    {
                        "MerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
                        "Amount": 280
                    }
                ]
            },
            {
                "SubordinateMerchantId": "9140ca78-3955-44a5-bd44-793370afef94",
                "Amount": 5000,
                "Fares": {
                    "Mdr": 4.0,
                    "Fee": 15
                },
                "Splits": [
                    {
                        "MerchantId": "9140ca78-3955-44a5-bd44-793370afef94",
                        "Amount": 4785
                    },
                    {
                        "MerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
                        "Amount": 215
                    }
                ]
            }
        ],
        "PaymentId": "5bb92d7c-4f3e-40dc-9f83-bd09c02fea38",
        "Type": "DebitCard",
        "Amount": 10000,
        "ReceivedDate": "2019-08-30 11:04:33",
        "Currency": "BRL",
        "Country": "BRA",
        "Provider": "Simulado",
        "ReasonCode": 9,
        "ReasonMessage": "Waiting",
        "Status": 0,
        "ProviderReturnCode": "1",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/5bb92d7c-4f3e-40dc-9f83-bd09c02fea38"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/5bb92d7c-4f3e-40dc-9f83-bd09c02fea38/void"
            }
        ]
    }
}

The following table presents the card brand identifier parameters that may be returned by the API.

Property	Description	Type	Size
`Payment.IssuerTransactionId`	Transaction identifier generated by the card brand and returned in the CIT response. Store the value to send it in subsequent MITs: sending is mandatory, for all card brands, in recurring, incremental, and re-authorized transactions. See more details in Brand identifiers for Cielo acquirer.	Text	30
`Payment.TransactionLinkId`	Unique identifier (TLID) generated by Mastercard and returned in the response, used to link the CIT to subsequent MITs. For Mastercard, send the original `TransactionLinkId` together with `IssuerTransactionId`: both are mandatory, and sending the `TransactionLinkId` is mandatory starting Oct 23, 2026. See more details in Brand identifiers for Cielo acquirer. *Format*: 22 alphanumeric characters (A–Z, a–z), case-sensitive, and may include hyphens (-) and underscores ().	Text	22
`Payment.SentTransactionLinkId`	TLID that the merchant sent in the request and that Cielo forwarded to the card brand. The field only appears when Cielo sent the TLID. See more details in Brand identifiers for Cielo acquirer.	Text	22