Toll

The transfer of funds from a card to an account, within the toll wallet, either with the same or different ownership. It is used to add balance to the toll wallet (prepaid account) using a branded credit or debit card.

post

ℹ️
Alphanumeric CNPJs will be implemented by the Brazilian Federal Revenue Service in July 2026
This change applies only to new registrations. There will be no changes to existing CNPJs.
The alphanumeric CNPJ is already supported by Cielo, with no changes required to your integration.
We recommend checking whether adjustments are needed in your merchant’s own checkout systems.

See below for an example of a SDWO toll-type request, with the parameter CashIn = true and the ReceiverData node, which represents the receiver's data if the ownership is different:

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": "2012345678",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "12345678900",
        "IdentityType": "CPF"
    },
    "Payment": {
      	"Provider":"Cielo30",      
				"Type": "CreditCard",
        "Amount": 15700,
     	 	"Installments": 1,
				"Capture":true,
        "SoftDescriptor": "CARTEIRA*NOMELOJA",
        "CreditCard": {
            "CardNumber": "4532110000001234",
            "Holder": "Aline de Souza",
            "Brand": "Visa",
            "SecurityCode": "333",
            "ExpirationDate": "12/2035"
        },
        "Wallet": {
            "PlatformOperator": "ABC",
            "ReceiverData": {
                "Name": "NOME DO RECEBEDOR",
                "Identity": "11122233344",
                "CompanyName": "NOME RAZAO SOCIAL"
            },
            "AdditionalData": {
                "Mcc": "4784",
                "CashIn": true
            }
        }
    }
}

{
    "MerchantOrderId": "2012345678",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "12345678900",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "CreditCard",
        "Amount": 15700,
        "Installments": 1,
        "SoftDescriptor": "CARTEIRA*NOMELOJA",
        "SolutionType": "ExternalLinkPay",
        "CreditCard": {
            "CardNumber": "4532110000001234",
            "Holder": "Aline de Souza",
            "Brand": "Visa",
            "SecurityCode": "333",
            "ExpirationDate": "12/2035"
        },
        "Wallet": {
            "PlatformOperator": "ABC",
            "ReceiverData": {
                "Name": "NOME DO RECEBEDOR",
                "Identity": "11122233344",
                "CompanyName": "NOME RAZAO SOCIAL"
            },
            "AdditionalData": {
                "Mcc": "4784",
                "CashIn": true
            }
        }
    }
}

Header parameters

Property	Description	Type	Size	Required
`MerchantId`	Merchant identifier in Gateway de Pagamento.	Text	36	Yes
`MerchantKey`	Public key for dual authentication in Gateway de Pagamento.	Text	40	Yes
`RequestId`	Request identifier, used when the merchant uses different servers for each GET/POST/PUT.	Text	36	No

Body parameters

Check the standard credit or debit card request to verify other optional fields. The table below presents the exclusive parameters for SDWO toll-type transactions.

Parameter	Description	Type	Size	Required?
`MerchantOrderId`	Order identification. Can be used to cancel or query the transaction in the future. Note: Only characters a-z, A-Z, 0-9 are allowed. Special characters and spaces are not permitted.	string	50	Yes
`Customer.Name`	Shopper's name. Note: Only characters a-z, A-Z are allowed. Special characters and numbers are not permitted.	string	255	Yes
`Customer.Identity`	Shopper's CPF or CNPJ number. Allows submission of alphanumeric CNPJs.	text	14	Yes, if the holder is a legal entity (CNPJ).
`Customer.IdentityType`	Type of shopper's identification document (CPF/CNPJ).	text	255	Yes, if the holder is a legal entity (CNPJ).
`Payment.Provider`	Provider name	text	15	Yes
`Payment.Type`	Type of payment method. Default value: CreditCard.	string		Yes
`Payment.Amount`	Order amount (sent in cents).	integer	15	Yes
`Payment.Installments`	Number of installments. For installment transactions, the number of installments will always be greater than 1.	integer	2	Yes
`Payment.Capture`	Boolean that identifies whether the authorization should be with automatic capture (“true”) or later capture (“false”).	boolean		Não (Default false)
`SoftDescriptor`	Text that will be printed on the shopper's bank statement. Special characters are not allowed. Must be filled in the format *WalletNamemerchantname**.	text	13	Yes
`Payment.CreditCard.CardNumber`	Shopper's card number.	string	19	Yes
`Payment.CreditCard.Holder`	Shopper's name printed on the card. Special characters or accents are not accepted.	string	25	Yes
`Payment.CreditCard.Brand`	Card brand. Possible values: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.	string	10	Yes
`Payment.CreditCard.SecurityCode`	Security code printed on the back of the card.	string	4	Yes
`Payment.CreditCard.ExpirationDate`	Expiration date printed on the card. Example: MM/YYYY.	string	7	Yes
`Payment.Wallet.PlatformOperator`	Acronym of the wallet registered at Cielo as a digital wallet (check your acronym with your account manager).	string (text)	3	Yes
`Payment.Wallet.ReceiverData.Name`	Name of the receiving customer or establishment.	text	70	Yes
`Payment.Wallet.ReceiverData.Identity`	CPF or CNPJ number of the receiver.	text	14	Yes
`Payment.Wallet.ReceiverData.CompanyName`	Corporate name of the receiving establishment.	text	40	Yes, if the receiving customer is a legal entity (CNPJ).
`Payment.Wallet.AdditionalData.Mcc`	Digital wallet MCC for toll-type fund transfer transactions, according to the card brand. See the MCC Table for SDWO Fund Transfer Arrangement.	string (numeric)	4	Yes
`Payment.Wallet.AdditionalData.CashIn`	Send as true.	boolean		Yes
`Payment.SolutionType`	Payment origin. Required for Elo brand card transactions originating from a payment link. Send as "ExternalLinkPay".	string	15	No