English
Referência da API
AtendimentoAPI Status

Transferência para carteira de pedágio

Transferência de saldo para uma carteira de pedágio usando o cartão de crédito ou débito

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.

⚠️

Identificação de transações oriundas de link de pagamento para cartões da bandeira Elo

A partir de 17 de outubro de 2025 será obrigatório identificar transações oriundas de link de pagamento para cartões da bandeira Elo. Envie o parâmetro Payment.SolutionType = "ExternalLinkPay".

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

AmbienteMétodoEndpoint
Sandbox
post
https://apisandbox.cieloecommerce.cielo.com.br/1/sales
Produção
post
https://api.cieloecommerce.cielo.com.br/1/sales
{
    "MerchantOrderId": "2012345678",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "12345678900",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "CreditCard",
        "Amount": 15700,
        "Installments": 1,
        "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"
            },
            "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âmetroDescriçãoTipoTamanhoObrigatório
Content-TypeTipo de mídia aceito pelo recurso.String40Sim
MerchantIdIdentificador da loja na Cielo.String36Sim
MerchantKeyChave pública para autenticação dupla na Cielo.String40Sim
RequestIdIdentificador da requisição, usado quando a loja usa diferentes servidores para cada GET/POST/PUT.String36Nã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.

ParâmetroDescriçãoTipoTamanhoObrigatório?
MerchantOrderIdIdentificação do pedido. Poderá ser usada para cancelar ou consultar a transação no futuro.
Atenção: Os caracteres permitidos são apenas a-z, A-Z, 0-9. Não são permitidos caracteres especiais e espaços em branco.		string50Sim
Customer.NameNome do comprador.
Atenção: Os caracteres permitidos são apenas a-z, A-Z. Não são permitidos caracteres especiais e números.		string255Sim
Customer.IdentityNúmero do CPF ou CNPJ do comprador.texto14Sim, se o portador for pessoa jurídica (CNPJ).
Customer.IdentityTypeTipo de documento de identificação do comprador (CPF/CNPJ).texto255Sim, se o portador for pessoa jurídica (CNPJ).
Payment.TypeTipo do meio de pagamento. Valor padrão: CreditCard.string-Sim
Payment.AmountValor do pedido (enviado em centavos).integer15Sim
Payment.InstallmentsNúmero de parcelas. Para transações parceladas, o número de parcelas será sempre maior que 1.integer2Sim
SoftDescriptorTexto 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.texto13Sim
Payment.CreditCard.CardNumberNúmero do cartão do comprador.string19Sim
Payment.CreditCard.HolderNome do comprador impresso no cartão. Não aceita caracteres especiais ou acentuação.string25Sim
Payment.CreditCard.BrandBandeira do cartão. Valores possíveis: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.string10Sim
Payment.CreditCard.SecurityCodeCódigo de segurança impresso no verso do cartão.string4Sim
Payment.CreditCard.ExpirationDateData de validade impressa no cartão. Exemplo: MM/AAAA.string7Sim
Payment.Wallet.PlatformOperatorSigla da carteira que está cadastrada na Cielo como carteira digital (verificar sua sigla com seu gestor comercial).string (texto)3Sim
Payment.Wallet.ReceiverData.NameNome do cliente ou estabelecimento recebedor.texto70Sim
Payment.Wallet.ReceiverData.IdentityNúmero do CPF ou CNPJ do recebedor.texto14Sim
Payment.Wallet.ReceiverData.CompanyNameRazão social do estabelecimento recebedor.texto40Sim, se o cliente recebedor for pessoa jurídica (CNPJ).
Payment.Wallet.AdditionalData.MccMCC 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)4Sim
Payment.Wallet.AdditionalData.CashInEnviar como true.boolean-Sim
Payment.SolutionTypeOrigem do pagamento. Obrigatório para transação de cartão da bandeira Elo oriunda de link de pagamento.
Enviar como "ExternalLinkPay". 		string15Não