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.

⚠️
Identification of transactions originating from payment links for Elo cards
Starting October 17, 2025, it will be mandatory to identify transactions originating from payment links for Elo-branded cards. Send the parameter Payment.SolutionType = "ExternalLinkPay".

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

Environment	Method	Endpoint
Sandbox	post	`https://apisandbox.cieloecommerce.cielo.com.br/1/sales/`
Production	post	`https://api.cieloecommerce.cielo.com.br/1/sales/`

{
    "MerchantOrderId": "2012345678",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "12345678900",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "CreditCard",
        "Amount": 15700,
        "Installments": 1,
        "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 the Cielo E-commerce API.	GUID	36	Yes
`MerchantKey`	Public key for dual authentication in the Cielo E-commerce API.	string	40	Yes
`RequestId`	Request identifier, used when the merchant uses different servers for each GET/POST/PUT.	GUID	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.	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.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
`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

⚠️Identification of transactions originating from payment links for Elo cards

Request

⚠️
Identification of transactions originating from payment links for Elo cards