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. Veja abaixo as especificações:
Além dos campos específicos dessa modalidade, para transações SDWO de compra também é obrigatório o envio do Soft Descriptor (campo
Payment.SoftDescriptor
) e CNPJ do portador, caso seja pessoa jurídica (camposCustomer.Identity
eCustomer.IdentityType
). Confira mais detalhes desses campos na tabela de campos da requisição.
Para efetuar testes, é necessário apenas seguir as orientações do menu Sandbox e ferramentas
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
Importante: 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 | post | https://apisandbox.braspag.com.br/v2/sales/ |
Produção | post | 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",
"AdditionalData": {
"Mcc": "1234"
}
}
}
}
Propriedade | Tipo | Tamanho | Obrigatório para transações de SDWO? | Descrição |
---|---|---|---|---|
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.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) |
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. |