Payment facilitators

Payment facilitators are intermediaries that provide processing and financial settlement services to receive card payments. In other words, they help mediate financial transactions between shoppers and sellers and between sellers and acquirers, such as Cielo.

Payment facilitators are registered with the card brands according to categories. In Cielo e-commerce, we support the following categories:

  • Sub-acquirers and marketplaces;
  • Wallets (digital wallets), which are subdivided into:
    • SDWO for purchase arrangements;
    • SDWO for fund transfer arrangements;

⚠️

Payment facilitators are subject to Cielo’s internal rules as well as regulations from the Central Bank, Abecs, and card brands. Each of these entities may update their rules at any time, and the facilitator is required to comply with new rules to continue operating.

ℹ️

Cielo Acquirer

During the accreditation process, Cielo performs procedures to identify and classify the facilitator according to their activity. The facilitator is classified according to business model, brand, and payment arrangement, and, based on this classification, is registered with the brands and subject to different rules. The entire accreditation process is accompanied by the Cielo commercial manager.


Payment creation

When submitting a request to create a payment via the Gateway de Pagamento, you must send the parameters described in the Cielo documentation and perform messaging tests in the specified sandbox. If the specific fields for the payment facilitator category are not sent in the transactional messaging, the response will be “Invalid XML.” Additionally, Cielo or the chosen acquirer may request additional specific fields related to certain products, depending on the business model and classification, such as dynamic MCC and Soft Descriptor, as determined by the brands, Central Bank, and Abecs.

See below for the different categories of payment facilitators.


Sub-acquirers and marketplaces

Sub-acquirers are participants that accredit merchants from specific business sectors in order to offer capture solutions better suited to their needs. To do this, the sub-acquirer connects to Cielo (the acquirer) and operates as an intermediary between the acquirer and the merchants. This model is widely used by smaller merchants and niche businesses, as they can offer more customized services.

Marketplaces are companies that advertise third-party products or services on their websites and need to accredit their sellers (sub-sellers) and transfer sales amounts to their clients (sellers).

ℹ️

Settlement of sales amounts

The acquirer settles to the sub-acquirer’s or marketplace’s bank account, and they transfer the sales amounts to their clients (third parties).

To ensure transparency and traceability of financial transactions, sub-acquirers and marketplaces must provide specific data when creating payments via e-commerce. It is mandatory to send:

  • SoftDescriptor;
  • Sub-merchant name;
  • Full address (street, city, state, country) of the sub-merchant;
  • CNPJ/CPF of the sub-merchant;
  • Corporate name;
  • Phone number;
  • Facilitator ID, as registered with the brand;
  • Sub-merchant ID; and
  • Sub-merchant MCC.

👉

See the API Reference for an example request with all required fields for sub-acquirers and marketplaces.


Wallets (digital wallets)

Digital wallets (wallets) allow the shopper to register their credit or debit card on the platform and, through the platform, make payments to wallet partner clients. They also allow payments via QR Code and using the card to deposit balance into the wallet for later use.

There are two classifications:

  • Staged Digital Wallet Operators (SDWO) - purchase arrangement
  • Staged Digital Wallet Operators (SDWO) - fund transfer arrangement

ℹ️

The Consumer Bill Pay Services (CBPS) type from Visa is now classified as SDWO for fund transfer arrangements.


SDWO for fund transfer arrangement

This is when the shopper uses a card (card not present) linked to an SDWO digital wallet to withdraw or send funds, without the immediate purpose of acquiring goods or services.

Some examples of fund transfers are mobile top-ups, public transport card top-ups, and lottery ticket purchases, among others.

The Gateway de Pagamento supports six types of SDWO for fund transfer arrangements. For each type, a [specific MCC must be sent, which may vary by brand].

TypeDescriptionExample
Me2MeTransfer of funds from a card to an account, of the same holder, within the SDWO.Add balance to your digital wallet using a branded card (credit or debit).
P2PTransfer of funds from a card to an account, followed by a transfer to another account of a different holder, within the SDWOAdd balance to another person’s digital wallet using a branded card (credit or debit).
Transfer to another arrangementTransfer of funds from a card to an SDWO account, followed by a transfer to another arrangement (e.g., Pix or another SDWO).Add balance to your (or another person’s) digital wallet, choose to pay with Pix, but the Pix debit is made from a branded card (credit or debit).
Unidentified bill paymentTransfer of funds from a card to an account, for the purpose of paying a bill, within the SDWO, where the payee was not informed by the SDWO.Pay a bill with a branded card (credit or debit) using the digital wallet, and the bill does not have identification.
Identified bill paymentTransfer of funds from a card to an account, for the purpose of paying a bill, within the SDWO, where the payee was informed by the SDWO.Pay a bill with a branded card (credit or debit) using the digital wallet, and the bill has identification.
TollTransfer of funds from a card to an account, of the same holder, within the toll SDWO.Add balance to a toll wallet (prepaid account) using a branded card (credit or debit).

* Currently, the Gateway de Pagamento does not support SDWO for fund transfer arrangements for cryptocurrencies.

👉

See the API Reference for an example request with all required fields for SDWO for fund transfer arrangements and the table with MCC values for each transfer type.