Transferência para carteira de pedágio

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

Ambiente	Método	Endpoint
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â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.

Parâmetro	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantOrderId`	Identificaçã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.	string	50	Sim
`Customer.Name`	Nome do comprador. Atenção: Os caracteres permitidos são apenas a-z, A-Z. Não são permitidos caracteres especiais e números.	string	255	Sim
`Customer.Identity`	Número do CPF ou CNPJ do comprador.	texto	14	Sim, se o portador for pessoa jurídica (CNPJ).
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF/CNPJ).	texto	255	Sim, se o portador for pessoa jurídica (CNPJ).
`Payment.Type`	Tipo do meio de pagamento. Valor padrão: CreditCard.	string	-	Sim
`Payment.Amount`	Valor do pedido (enviado em centavos).	integer	15	Sim
`Payment.Installments`	Número de parcelas. Para transações parceladas, o número de parcelas será sempre maior que 1.	integer	2	Sim
`SoftDescriptor`	Texto que será impresso na fatura bancária do portador. Não permite caracteres especiais. Necessário preencher no formato *Nome da carteiranome do lojista**.	texto	13	Sim
`Payment.CreditCard.CardNumber`	Número do cartão do comprador.	string	19	Sim
`Payment.CreditCard.Holder`	Nome do comprador impresso no cartão. Não aceita caracteres especiais ou acentuação.	string	25	Sim
`Payment.CreditCard.Brand`	Bandeira do cartão. Valores possíveis: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.	string	10	Sim
`Payment.CreditCard.SecurityCode`	Código de segurança impresso no verso do cartão.	string	4	Sim
`Payment.CreditCard.ExpirationDate`	Data de validade impressa no cartão. Exemplo: MM/AAAA.	string	7	Sim
`Payment.Wallet.PlatformOperator`	Sigla da carteira que está cadastrada na Cielo como carteira digital (verificar sua sigla com seu gestor comercial).	string (texto)	3	Sim
`Payment.Wallet.ReceiverData.Name`	Nome do cliente ou estabelecimento recebedor.	texto	70	Sim
`Payment.Wallet.ReceiverData.Identity`	Número do CPF ou CNPJ do recebedor.	texto	14	Sim
`Payment.Wallet.ReceiverData.CompanyName`	Razão social do estabelecimento recebedor.	texto	40	Sim, se o cliente recebedor for pessoa jurídica (CNPJ).
`Payment.Wallet.AdditionalData.Mcc`	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
`Payment.Wallet.AdditionalData.CashIn`	Enviar como true.	boolean	-	Sim
`Payment.SolutionType`	Origem do pagamento. Obrigatório para transação de cartão da bandeira Elo oriunda de link de pagamento. Enviar como "ExternalLinkPay".	string	15	Não