A transferência de fundos de um cartão para uma conta, dentro da carteira de pedágio, de mesma titularidade ou titularidade diferente. É usada para colocar saldo na carteira de pedágio (conta pré-paga) usando um cartão de crédito ou débito da bandeira.
CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.
O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.
Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.
Confira a seguir um exemplo da requisição de SDWO do tipo pedágio, com envio do parâmetro CashIn = true e do nó ReceiverData, que representa os dados do recebedor, caso a titularidade seja diferente:
Requisição
Ambiente | Método | Endpoint |
|---|---|---|
Sandbox | post |
|
Produção | post |
|
{
"MerchantOrderId": "2012345678",
"Customer": {
"Name": "Aline de Souza",
"Identity": "12345678900",
"IdentityType": "CPF"
},
"Payment": {
"Provider":"Cielo30",
"Type": "CreditCard",
"Amount": 15700,
"Installments": 1,
"Capture":true,
"SoftDescriptor": "CARTEIRA*NOMELOJA",
"CreditCard": {
"CardNumber": "4532110000001234",
"Holder": "Aline de Souza",
"Brand": "Visa",
"SecurityCode": "333",
"ExpirationDate": "12/2035"
},
"Wallet": {
"PlatformOperator": "ABC",
"ReceiverData": {
"Name": "NOME DO RECEBEDOR",
"Identity": "11122233344",
"CompanyName": "NOME RAZAO SOCIAL",
"WalletId": "12345678900",
"CountryCode": "076"
},
"AdditionalData": {
"Mcc": "4784",
"CashIn": true
}
}
}
}{
"MerchantOrderId": "2012345678",
"Customer": {
"Name": "Aline de Souza",
"Identity": "12345678900",
"IdentityType": "CPF"
},
"Payment": {
"Type": "CreditCard",
"Amount": 15700,
"Installments": 1,
"SoftDescriptor": "CARTEIRA*NOMELOJA",
"SolutionType": "ExternalLinkPay",
"CreditCard": {
"CardNumber": "4532110000001234",
"Holder": "Aline de Souza",
"Brand": "Visa",
"SecurityCode": "333",
"ExpirationDate": "12/2035"
},
"Wallet": {
"PlatformOperator": "ABC",
"ReceiverData": {
"Name": "NOME DO RECEBEDOR",
"Identity": "11122233344",
"CompanyName": "NOME RAZAO SOCIAL"
},
"AdditionalData": {
"Mcc": "4784",
"CashIn": true
}
}
}
}Parâmetros no cabeçalho (header)
| Parâmetro | Descrição | Tipo | Tamanho | Obrigatório |
|---|---|---|---|---|
Content-Type | Tipo de mídia aceito pelo recurso. | String | 40 | Sim |
MerchantId | Identificador da loja na Cielo. | String | 36 | Sim |
MerchantKey | Chave pública para autenticação dupla na Cielo. | String | 40 | Sim |
RequestId | Identificador da requisição, usado quando a loja usa diferentes servidores para cada GET/POST/PUT. | String | 36 | Não |
Parâmetros no corpo (body)
Confira a requisição padrão de cartão de crédito ou débito para verificar os demais campos opcionais. A tabela abaixo apresenta os parâmetros exclusivos para transação de SDWO do tipo pedágio.
Importante
MastercardA partir de 30/10/2026, será obrigatório o envio dos campos do remetente:
Customer.Name;
Customer.Identity;
Customer.IdentityType.e do destinatário, quando aplicável:
Payment.Wallet.ReceiverData.Name;
Payment.Wallet.ReceiverData.Identity;
Payment.Wallet.ReceiverData.CompanyName.
VisaPara transações com bandeira Visa, é obrigatório o envio dos campos:
Payment.Wallet.ReceiverData.CountryCode;Payment.Wallet.PlatformOperator.
Parâmetro | Descrição | Tipo | Tamanho | Obrigatório? |
|---|---|---|---|---|
| Identificação do pedido. Poderá ser usada para cancelar ou consultar a transação no futuro. | string | 50 | Sim |
| Nome ou razão social do comprador. Deve ser enviado o nome da pessoa física quando | string | 255 | Sim |
| Número do CPF ou CNPJ do comprador. | string | 14 | Sim, se o portador for pessoa jurídica (CNPJ). |
| Tipo de documento de identificação do comprador (CPF/CNPJ). | texto | 255 | Sim, se o portador for pessoa jurídica (CNPJ). |
| Nome do provedor | texto | 15 | Sim |
| Tipo do meio de pagamento. Valor padrão: CreditCard. | string | Sim | |
| Valor do pedido (enviado em centavos). | integer | 15 | Sim |
| Número de parcelas. Para transações parceladas, o número de parcelas será sempre maior que 1. | integer | 2 | Sim |
| Booleano que identifica que a autorização deve ser com captura automática (“true”) ou captura posterior (“false”). | Booleano | Não (Default false) | |
| Texto que será impresso na fatura bancária do portador. Não permite caracteres especiais. Necessário preencher no formato Nome da carteira*nome do lojista. | texto | 13 | Sim |
| Número do cartão do comprador. | string | 19 | Sim |
| Nome do comprador impresso no cartão. Não aceita caracteres especiais ou acentuação. | string | 25 | Sim |
| Bandeira do cartão. Valores possíveis: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover. | string | 10 | Sim |
| Código de segurança impresso no verso do cartão. | string | 4 | Sim |
| Data de validade impressa no cartão. Exemplo: MM/AAAA. | string | 7 | Sim |
| Sigla da carteira que está cadastrada na Cielo como carteira digital (verificar sua sigla com seu gestor comercial). | string (texto) | 3 | Sim |
| Nome do cliente ou estabelecimento recebedor. | texto | 70 | Sim |
| Número do CPF ou CNPJ do recebedor. | texto | 14 | Sim |
| Razão social do estabelecimento recebedor. | texto | 40 | Sim, se o cliente recebedor for pessoa jurídica (CNPJ). |
| Identificador da carteira digital (wallet) do estabelecimento ou pessoa recebedora, quando aplicável ao arranjo. | texto | 20 | Sim |
| Código do país do destinatário/recebedor, com base na ISO 3166. Ex.: código ISO 3166 do Brasil é o 076. | texto | 3 | Sim |
| MCC da carteira digital para transações de transferência de fundos do tipo pedágio, conforme a bandeira do cartão. Consulte a Tabela de MCCs para SDWO de arranjo de transferência de fundos. | string (numérico) | 4 | Sim |
| Enviar como true. | boolean | Sim | |
| Origem do pagamento. Obrigatório para transação de cartão da bandeira Elo oriunda de link de pagamento. | string | 15 | Não |