SDWO

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 and Customer.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 typeBrand
Credit cardVisa, Mastercard, and Elo
Debit cardVisa, 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

https://apisandbox.cieloecommerce.cielo.com.br/1/sales/

Production

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)