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)
Propriedade | Descrição | Tipo | Tamanho | Obrigatório |
---|---|---|---|---|
MerchantId | Identificador da loja no Gateway de Pagamentos. | Text | 36 | Sim |
MerchantKey | Chave pública para autenticação dupla no Gateway de Pagamentos. | Text | 40 | Sim |
RequestId | Identificador da requisição, usado quando a loja usa diferentes servidores para cada GET/POST/PUT. | Text | 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 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 |