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

EnvironmentMethodEndpoint
Sandboxhttps://apisandbox.cieloecommerce.cielo.com.br/1/sales/
Productionhttps://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"
            }
        }
    }
}
PropertyTypeSizeRequiredDescription
Customer.Identitytext14Yes for SDWO transactionsShopper's CPF or CNPJ number
Customer.IdentityTypetext255Yes for SDWO transactionsShopper ID Type (CPF/CNPJ).
SoftDescriptortext13Yes for SDWO transactionsText that will be printed on the shopper's bank invoice.
Does not allow special characters.
Needs to include Wallet name*merchant name.
Wallet.PlatformOperatorstring (text)3Yes for SDWO transactionsAcronym for the wallet that's registered in Cielo (check with you commercial manager at Cielo)
Wallet.ReceiverData.Nametext70YesName of the recipient customer or establishment.
Wallet.ReceiverData.Identitynumber14YesCPF or CNPJ number of the recipient.
Wallet.ReceiverData.CompanyNametext40YesCorporate name of the recipient establishment.
Wallet.AdditionalData.Mccstring (number)4Yes for SDWO transactionsMerchant'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)