SDWO

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.Identity e Customer.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ção

Para 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

https://apisandbox.braspag.com.br/v2/sales/

Produção

https://api.braspag.com.br/v2/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"
            }
        }
    }
}

Propriedade

Tipo

Tamanho

Obrigatório para transações de SDWO?

Descrição

Customer.Identity

texto

14

Sim, se o portador for pessoa jurídica (CNPJ)

Número do CPF ou CNPJ do comprador.

Customer.IdentityType

texto

255

Sim, se o portador for pessoa jurídica (CNPJ)

Tipo de documento de identificação do comprador (CPF/CNPJ).

SoftDescriptor

texto

13

Sim

Texto que será impresso na fatura bancária do portador.\
Não permite caracteres especiais.\
Necessário preencher com Nome da carteira*nome do lojista.

Wallet.PlatformOperator

string (texto)

3

Sim

Sigla da carteira que está cadastrada aqui na Cielo como carteira digital (verificar sua sigla com seu gestor comercial)

Wallet.ReceiverData.Name

texto

70

Sim

Nome do cliente ou estabelecimento recebedor.

Wallet.ReceiverData.Identity

número

14

Sim

Número do CPF ou CNPJ do recebedor.

Wallet.ReceiverData.CompanyName

texto

40

Sim, se o portador for pessoa jurídica (CNPJ)

Razão social do estabelecimento recebedor.

Wallet.AdditionalData.Mcc

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)