Facilitadores de Pagamento

Todos os clientes de E-Commerce que são Facilitadores de Pagamento, por obrigatoriedade das bandeiras e do Banco Central devem enviar campos específicos na mensageria transacional. A Cielo transmitirá as informações para as bandeiras por meio da mensageria transacional no momento da autorização.

Os campos específicos estão contidos dentro do nó PaymentFacilitator. Além dos campos deste nó, os facilitadores também precisam enviar obrigatoriamente o campo SoftDescriptor do nó Payment. Veja a seguir o exemplo do envio e da resposta.

Atenção: As bandeiras, ao identificarem inconformidade devido ao não envio dos dados obrigatórios na mensageria transacional, aplicarão multas à Cielo as quais serão repassadas ao Facilitador responsável pelo envio dos dados transacionais.

A bandeira Visa, desde 15 de abril de 2023, atualizou as regras para marketplace e todos os merchants que atuam como Facilitadores de Pagamentos e que tenham clientes que operam como Marketplace Estrangeiro precisam, obrigatoriamente, enviar o indicador de varejo estrangeiro para evitar multa pela bandeira. O parâmetro específico é o Payment.PaymentFacilitator.SubEstablishment.CountryCode, que indica o codigo do país.

Requisição

{
  "MerchantOrderId": "2222222222",
  "Customer": {
    "Name": "Comprador Teste",
    "Identity": "11225468954",
    "IdentityType": "CPF",
    "Email": "[email protected]",
    "Birthdate": "1991-01-02",
    "Address": {
      "Street": "Rua Teste",
      "Number": "123",
      "Complement": "AP 123",
      "ZipCode": "12345987",
      "City": "Rio de Janeiro",
      "State": "RJ",
      "Country": "BRA"
    },
    "DeliveryAddress": {
      "Street": "Rua Teste",
      "Number": "123",
      "Complement": "AP 123",
      "ZipCode": "12345987",
      "City": "Rio de Janeiro",
      "State": "RJ",
      "Country": "BRA"
    }
  },
  "Payment": {
    "Type": "CreditCard",
    "Amount": 157000,
    "Currency": "BRL",
    "Country": "BRA",
    "Provider": "Cielo",
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": "ByMerchant",
    "Capture": false,
    "Authenticate": false,
    "Recurrent": false,
    "SoftDescriptor": "123456789ABCD",
    "CreditCard": {
      "CardNumber": "4024007197692931",
      "Holder": "Teste Holder",
      "ExpirationDate": "12/2021",
      "SecurityCode": "123",
      "SaveCard": "false",
      "Brand": "Visa"
    },
    "PaymentFacilitator": {
      "EstablishmentCode": "1234",
      "SubEstablishment": {
        "EstablishmentCode": "1234",
        "Identity": "11111111000100",
        "Mcc": "1234",
        "Address": "Alameda Grajau, 512",
        "City": "Barueri",
        "State": "SP",
        "CountryCode": "076",
        "PostalCode": "06455914",
        "PhoneNumber": "1155855585"
      }
    }
  }
}

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
`Payment.PaymentFacilitator.EstablishmentCode`	texto	11	Obrigatório para facilitadores	Código do estabelecimento do Facilitador. "Facilitator ID” (Cadastro do facilitador com as bandeiras) O código é diferente por bandeira, podendo variar inclusive o tamanho do campo: Bandeira Mastercard –06 dígitos Bandeira Visa –08 dígitos Bandeira ELO –de 04 à 05 dígitos Bandeira Hipercard –06 dígitos Para demais bandeiras, como Amex e JCB, o campo pode ser preenchido com “0” zeros.
`Payment.PaymentFacilitator.SubEstablishment.EstablishmentCode`	texto	15	Obrigatório para facilitadores	Código do estabelecimento do sub Merchant. “Sub-Merchant ID” (Cadastro do subcredenciado com o facilitador)
`Payment.PaymentFacilitator.SubEstablishment.Identity`	texto	14	Obrigatório para facilitadores	CNPJ ou CPF do sub-merchant.
`Payment.PaymentFacilitator.SubEstablishment.Mcc`	texto	4	Obrigatório para facilitadores	MCC do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.Address`	texto	22	Obrigatório para facilitadores	Endereço do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.City`	texto	13	Obrigatório para facilitadores	Cidade do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.State`	texto	2	Obrigatório para facilitadores	Estado do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.PostalCode`	texto	9	Obrigatório para facilitadores	Código postal do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.CountryCode`	texto	3	Obrigatório para facilitadores	Código país do sub-merchant com base no ISO 3166 Ex: código ISO 3166 do Brasil é o 076. Lista completa online.
`Payment.PaymentFacilitator.SubEstablishment.PhoneNumber`	texto	13	Obrigatório para facilitadores	Número de telefone do sub Merchant.
`Payment.Softdescriptor`	texto	13	Obrigatório para facilitadores	Texto impresso na fatura bancaria comprador. Deve ser preenchido de acordo com os dados do sub Merchant.

*Evite utilizar acentos pois eles são considerados como dois caracteres.

⚠️
Atenção
Os campos não devem ser enviados com espaçamento a esquerda. Sujeito a rejeição na liquidação das transações.

Resposta

{
  "MerchantOrderId": "2014111701",
  "Customer": {
    "Name": "Comprador Teste",
    "Identity": "11225468954",
    "IdentityType": "CPF",
    "Email": "[email protected]",
    "Birthdate": "1991-01-02",
    "Address": {
      "Street": "Rua Teste",
      "Number": "123",
      "Complement": "AP 123",
      "ZipCode": "12345987",
      "City": "Rio de Janeiro",
      "State": "RJ",
      "Country": "BRA"
    },
    "DeliveryAddress": {
      "Street": "Rua Teste",
      "Number": "123",
      "Complement": "AP 123",
      "ZipCode": "12345987",
      "City": "Rio de Janeiro",
      "State": "RJ",
      "Country": "BRA"
    }
  },
  "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": 0,
    "Capture": false,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "402400******2931",
      "Holder": "Teste Holder",
      "ExpirationDate": "12/2021",
      "SaveCard": false,
      "Brand": "Visa"
    },
    "Tid": "1223092935684",
    "ProofOfSale": "2935684",
    "AuthorizationCode": "065158",
    "SoftDescriptor": "123456789ABCD",
    "Provider": "Simulado",
    "IsQrCode": false,
    "PaymentFacilitator": {
      "EstablishmentCode": "1234",
      "SubEstablishment": {
        "EstablishmentCode": "1234",
        "Identity": "11111111000100",
        "Mcc": "1234",
        "Address": "Alameda Grajau, 512",
        "City": "Barueri",
        "State": "SP",
        "CountryCode": "076",
        "PostalCode": "06455914",
        "PhoneNumber": "1155855585"
      }
    },
    "Amount": 157000,
    "ReceivedDate": "2019-12-23 09:29:34",
    "Status": 1,
    "IsSplitted": false,
    "ReturnMessage": "Operation Successful",
    "ReturnCode": "4",
    "PaymentId": "365c3a0d-fd86-480b-9279-4ba3da21333c",
    "Type": "CreditCard",
    "Currency": "BRL",
    "Country": "BRA",
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/sales/365c3a0d-fd86-480b-9279-4ba3da21333c"
      },
      {
        "Method": "PUT",
        "Rel": "capture",
        "Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/sales/365c3a0d-fd86-480b-9279-4ba3da21333c/capture"
      },
      {
        "Method": "PUT",
        "Rel": "void",
        "Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/sales/365c3a0d-fd86-480b-9279-4ba3da21333c/void"
      }
    ]
  }
}

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
`Payment.PaymentFacilitator.EstablishmentCode`	texto	11	Obrigatório para facilitadores	Código do estabelecimento do Facilitador. "Facilitator ID” (Cadastro do facilitador com as bandeiras) O código é diferente por bandeira, podendo variar inclusive o tamanho do campo: Bandeira Mastercard –06 dígitos Bandeira Visa –08 dígitos Bandeira ELO –de 04 à 05 dígitos Bandeira Hipercard –06 dígitos Para demais bandeiras, como Amex e JCB, o campo pode ser preenchido com “0” zeros.
`Payment.PaymentFacilitator.SubEstablishment.EstablishmentCode`	texto	15	Obrigatório para facilitadores	Código do estabelecimento do sub Merchant. “Sub-Merchant ID” (Cadastro do subcredenciado com o facilitador)
`Payment.PaymentFacilitator.SubEstablishment.Identity`	texto	14	Obrigatório para facilitadores	CNPJ ou CPF do sub-merchant.
`Payment.PaymentFacilitator.SubEstablishment.Mcc`	texto	4	Obrigatório para facilitadores	MCC do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.Address`	texto	22	Obrigatório para facilitadores	Endereço do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.City`	texto	13	Obrigatório para facilitadores	Cidade do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.State`	texto	2	Obrigatório para facilitadores	Estado do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.PostalCode`	texto	9	Obrigatório para facilitadores	Código postal do sub Merchant.
`Payment.PaymentFacilitator.SubEstablishment.CountryCode`	texto	3	Obrigatório para facilitadores	Código país do sub-merchant com base no ISO 3166. Ex: código ISO 3166 do Brasil é o 076. Lista completa online
`Payment.PaymentFacilitator.SubEstablishment.PhoneNumber`	texto	13	Obrigatório para facilitadores	Número de telefone do sub Merchant.
`Payment.Softdescriptor`	texto	13	Obrigatório para facilitadores	Texto impresso na fatura bancaria comprador. Deve ser preenchido de acordo com os dados do sub Merchant.

*Evite utilizar acentos pois eles são considerados como dois caracteres.

Requisição

⚠️Atenção

Resposta

⚠️
Atenção