Se categoriza como uma SDWO (Staged Digital Wallet Operators) uma empresa que oferece serviços de carteira digital/wallet, ou seja, que permite que o portador pague a aquisição de um produto ou serviço por meio de sua própria plataforma, seja com cadastro de cartões de crédito ou debito, ou geração de QR code.
Para transacionar como SDWO, o estabelecimento precisa se registrar junto as bandeiras. Para isso, procure seu gestor comercial Cielo para mais informações.
No caso de transações de e‑commerce de uma SDWO com cartão de crédito ou débito (não originadas por um QR Code), é necessário que a carteira mande alguns dados adicionais na transação, para que as bandeiras possam identificar e diferenciar esse tipo de transação.
Além dos campos específicos dessa modalidade, para transações SDWO de compra também é obrigatório enviar:
Soft Descriptor (campo
Payment.SoftDescriptor);CNPJ do portador, caso seja pessoa jurídica (campos
Customer.IdentityeCustomer.IdentityType);Razão social (
CompanyName).Confira mais detalhes desses campos na tabela de campos da requisição abaixo.
Para enviar o MCC do varejista na transação de SDWO, a orientação do mercado é utilizar a tabela da ABECS (Associação Brasileira das Empresas de cartões de crédito e Serviços) que realiza o de‑para de CNAEs para os MCCS de toda a indústria. Essa tabela é atualizada constantemente e está disponível online no site da ABECS no seguinte link: ABECS.
Para transações SDWO de boleto identificado e não identificado da bandeira Mastercard o MCC deve ser 6540.
Bandeiras e cartões aceitos para SDWO
A marcação de SDWO é apenas aceita para as seguintes modalidades e bandeiras:
- Visa/Elo‑ crédito e débito
- Mastercard – crédito e débito.
Aceita cartões estrangeiros.
AtençãoPara a bandeira Visa, a carteira digital SDWO deve estar localizada no mesmo país que o varejista que recebe o pagamento da carteira digital.
Requisição
Ambiente | Método | Endpoint |
|---|---|---|
Sandbox | post |
|
Produção | post |
|
{
"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"
}
}
}
}Propriedade | Tipo | Tamanho | Obrigatório para transações de SDWO? | Descrição |
|---|---|---|---|---|
| texto | 14 | Sim, se o portador for pessoa jurídica (CNPJ) | Número do CPF ou CNPJ do comprador. |
| texto | 255 | Sim, se o portador for pessoa jurídica (CNPJ) | Tipo de documento de identificação do comprador (CPF/CNPJ). |
| texto | 13 | Sim | Texto que será impresso na fatura bancária do portador.\ |
| string (texto) | 3 | Sim | Sigla da carteira que está cadastrada aqui na Cielo como carteira digital (verificar sua sigla com seu gestor comercial) |
| texto | 70 | Sim | Nome do cliente ou estabelecimento recebedor. |
| número | 14 | Sim | Número do CPF ou CNPJ do recebedor. |
| texto | 40 | Sim, se o portador for pessoa jurídica (CNPJ) | Razão social do estabelecimento recebedor. |
| string (numérico) | 4 | Sim | MCC do varejista subjacente (pra transações de compra); MCC da carteira digital (para transações de abastecimento de crédito na carteira caso aplicável – no qual é necessária a marcação de cash in também vista nessa sessão) |