Register seller

ℹ️
Only sellers with a national CNPJ or CPF are accepted in Split de Pagamento.

In Split de Pagamento, the master must register all sellers who will make sales on its platform.

The master must provide the seller’s information such as identification and contact details, bank account for settlement, address, fees agreed between master and seller, and additional documents.

How to register a seller

There are two ways to register a seller in Split de Pagamento:

Through the Split de Pagamento portal – learn more at How to register sellers in the Split de Pagamento Portal.
Through the Onboarding API 2.0

Register a seller via API

The master must request the seller registration by sending a request with the seller’s data:

Seller Data	Parameters (Node)
Identification and contact data	`Body`
Bank account data	`BankAccount`
Address	`Address`
Fee agreements	`Agreements`
Attached documents	`Attachments`

The seller can be registered with a CPF or CNPJ. If the document is a CPF, also send the fields BirthdayDate and BusinessActivity, as described in the request property table.

Check the instructions to register a seller via API.

Register a new seller enabling Pix via API

To register a new seller with Pix payment method enabled, you must send specific values in the following parameters:

In Agreements.MerchantDiscountRates.PaymentArrangement.Product, send the value "Pix";
In Agreements.MerchantDiscountRates.PaymentArrangement.Brand, send the value "PixCielo".

Request example

},
    "MerchantDiscountRates": {
      "PaymentArrangement": {
        "Product": "Pix",
        "Brand": "PixCielo"
      }

Enable Pix in batch for already registered sellers

With this option, you can update the agreements of seller registrations in batch, including the Pix payment method for multiple sellers at the same time. The update of the seller registration to enable Pix will return RequestId as the response.

Fee Agreements

In Split de Pagamento, there are options for fee agreements between the master and its sellers:

Do not register a fee: when fees are not defined at the time of seller registration, the master must provide the fees for each transaction, either during transaction capture or when issuing the boleto. If no fees are registered and no fee is provided in the transaction, Split de Pagamento will replicate the same agreements between the master and Split de Pagamento for the master and the seller.
Global fee (single MDR): set a single fee for all agreements.
Fee by payment method: the master must define the fees charged per transaction by payment arrangements and installment ranges.

Create a user for the seller

If necessary, the master can allow the seller to access the Split de Pagamento portal. To do this, the master must send to support:

The seller’s MerchantId
The seller’s email
The seller’s username