Staged Digital Wallet Operators (SDWO) are digital wallets that allow the storage of payment information and the execution of online transactions.
Check out the request examples for SDWOs of each category accepted in Cielo e-commerce:
For of e-commerce transactions from an SDWO with a credit or debit card (not originated by a QR Code), it is necessary for the wallet to send some additional data in the transaction so that the card brands can identify and differentiate this type of transaction.
In addition to the specific fields for this modality, for SDWO purchase transactions it is also mandatory to send:
- Soft Descriptor (field
Payment.SoftDescriptor
); - Holder's CNPJ, if a legal entity (fields
Customer.Identity
andCustomer.IdentityType
); - Company name (
CompanyName
).
To test SDWO transactions, you must follow the guidelines in the Sandbox and tools menu.
To send the merchant's MCC in the SDWO transaction, the market guidance is to use the Abecs table (Brazilian Association of Credit Card and Services Companies), which maps CNAEs to MCCs for the entire industry. This table is constantly updated and is available online on the ABECS website at the following link: https://abecs.org.br/portal-mcc
For SDWO transactions with identified and unidentified boleto of the Mastercard brand, the MCC must be 6540.
Brands and cards accepted for SDWO
The SDWO marking is only accepted for the following modalities and brands:
Card type | Brand |
---|---|
Credit card | Visa, Mastercard, and Elo |
Debit card | Visa, Mastercard, and Elo |
Foreign cards are accepted.
Attention
For the Visa brand, the SDWO digital wallet must be located in the same country as the merchant receiving the payment from the digital wallet.
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": "Comprador Carteira",
"Identity": "11225468954",
"IdentityType": "CPF"
},
"Payment": {
"Type": "CreditCard",
"Amount": 15700,
"Installments": 1,
"SoftDescriptor": "CARTEIRA*NOMELOJA",
"CreditCard": {
"CardNumber": "4532110000001234",
"Brand": "Visa",
"SecurityCode": "123"
},
"Wallet": {
"PlatformOperator": "ABC",
"ReceiverData": {
"Name": "NOME CLIENTE RECEBEDOR",
"Identity": "11225468954",
"CompanyName": "NOME RAZAO SOCIAL"
},
"AdditionalData": {
"Mcc": "1234"
}
}
}
}
Property | Type | Size | Required | Description |
---|---|---|---|---|
Customer.Identity | text | 14 | Yes for SDWO transactions | Shopper's CPF or CNPJ number |
Customer.IdentityType | text | 255 | Yes for SDWO transactions | Shopper ID Type (CPF/CNPJ). |
SoftDescriptor | text | 13 | Yes for SDWO transactions | Text that will be printed on the shopper's bank invoice. Does not allow special characters. Needs to include Wallet name*merchant name. |
Wallet.PlatformOperator | string (text) | 3 | Yes for SDWO transactions | Acronym for the wallet that's registered in Cielo (check with you commercial manager at Cielo) |
Wallet.ReceiverData.Name | text | 70 | Yes | Name of the recipient customer or establishment. |
Wallet.ReceiverData.Identity | number | 14 | Yes | CPF or CNPJ number of the recipient. |
Wallet.ReceiverData.CompanyName | text | 40 | Yes | Corporate name of the recipient establishment. |
Wallet.AdditionalData.Mcc | string (number) | 4 | Yes for SDWO transactions | Merchant's MCC (for purchase transactions); E-wallet's MCC (for credit supply transactions in the wallet, if applicable – in which the cash in markup also seen in this session is required) |