Transferência para outro arranjo

Transferência de fundos para outro arranjo, como outra carteira ou pagar via Pix usando o cartão

A transferência para outro arranjo se refere à transferência de fundos de um cartão para uma conta SDWO, seguida de uma transferência para outro arranjo (ex. Pix ou outra SDWO). Por exemplo, ao colocar saldo na sua carteira digital (ou de outra pessoa), e escolher a opção pagar com Pix mas o débito do Pix será feito em um cartão da bandeira (seja crédito ou débito).

Confira a seguir um exemplo da requisição de SDWO do tipo transferência para outro arranjo:

Requisição

{
    "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": "123",
            "ExpirationDate": "12/2030"
        },
        "Wallet": {
            "PlatformOperator": "ABC",
            "TransferType": "Pix",
            "ReceiverData": {
                "Name": "Alan de Souza",
                "Identity": "11122233344",
                "CompanyName": "NOME RAZAO SOCIAL"
            },
            "AdditionalData": {
                "Mcc": "6054",
                "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 transferência para outro arranjo.

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 carteira*nome 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.TransferType

Tipo de transferência para outro arranjo. Valores possíveis:
-"Pix"para Pix
-"Exchange" para câmbio
-"Others" para outro arranjo (outra carteira).

texto

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 para outro arranjo, 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