Cash In

Uma transação do tipo Cash In é uma operação de adição de créditos em uma carteira digital. Os estabelecimentos que operam com esse tipo de transação devem ser registrados como carteira digital junto as bandeiras e devem estar cadastrados com um dos seguintes MCCs (Códigos de categoria do estabelecimento):

ECCHAVEMCCBANDEIRAS ACEITAS
20000197008c08a0d0f00b73dedd2673a06fa725b0bd8edbf71c4c7dd0614bf408e4d161206051/6540/6538/4829Mastercard
20000197008c08a0d0f00b73dedd2673a06fa725b0bd8edbf71c4c7dd0614bf408e4d161206051/6540Visa
20000198538c08a0d0f00b73dedd2673a06fa725b0bd8edbf71c4c7dd0614bf408e4d161206051Elo

Além disso, precisam enviar alguns dados adicionais na transação, para que as bandeiras possam identificar e diferenciar esse tipo de transação. Veja as especificações:

Além dos campos específicos dessa modalidade, para transações Cash In também é obrigatório o envio do Soft Descriptor (campo Payment.SoftDescriptor) e CPF ou CNPJ do portador (campo Customer.Identity e campo Customer.IdentityType). No caso de Cash In, o campo do Soft Descriptor precisa ser preenchido com nome da carteira*nome do portador. Confira mais detalhes na tabela de campos da requisição.

Importante: A marcação de Cash In é apenas aceita para as seguintes modalidades e bandeiras: Visa/Mastercard só crédito; Elo débito e crédito. Não é aceita para cartão estrangeiro.

Requisição

{
  "MerchantOrderId": "2012345678",
  "Customer": {
    "Name": "Comprador Carteira",
    "Identity": "11225468954",
    "IdentityType": "CPF"
  },
  "Payment": {
    "Type": "CreditCard",
    "Amount": 15700,
    "Installments": 1,
    "SoftDescriptor": "CARTEIRA*NOMEPORTADOR",
    "CreditCard": {
      "CardNumber": "4532110000001234",
      "Brand": "Visa",
      "SecurityCode": "123"
    },
    "Wallet": {
      "PlatformOperator": "ABC",
      "AdditionalData": {
        "CashIn": "true"
        "Mcc": "1234"
      }
    }
  }
}
PropriedadeTipoTamanhoObrigatórioDescrição
Wallet.PlatformOperatorstring (texto)3Sim, para transações de Cash InSigla da carteira que está cadastrada aqui na Cielo como carteira digital (verificar sua sigla com seu gestor comercial)
Wallet.AdditionalData.CashInstring (texto)-Sim, para transações de Cash InEnviar como “True” se for uma transação de Cash In
Wallet.AdditionalData.Mccstring (numérico)4Sim, para transações de Cash InMCC do varejista subjacente (para transações de compra); MCC da carteira digital (para transações de abastecimento de crédito na carteira caso aplicável - no qual é necessária a marcação de cash in também vista nessa sessão)
Customer.Identitytexto14Sim, para transações de Cash InNúmero do CPF ou CNPJ do comprador.
Customer.IdentityTypeTexto255Sim, para transações de Cash InTipo de documento de identificação do comprador (CPF/CNPJ).
SoftDescriptortexto13Sim, para transações de Cash InTexto que será impresso na fatura bancária do portador.
Não permite caracteres especiais.
Necessário preencher com Nome da carteira*nome do portador.