Create a splitted credit card payment

Create a credit card payment and split the amount between sellers

EnvironmentMethodEndpoint
Sandboxhttps://apisandbox.cieloecommerce.cielo.com.br/1/sales
Productionhttps://api.cieloecommerce.cielo.com.br/1/sales
⚠️

To submit a transaction from the API E-commerce Cielo to the Split, simply send the parameter Payment.DoSplit as true and add the node Payment.SplitPayments.

Sending fees in the request: If the request includes fees, they will take precedence over the fees registered in the portal e-commerce. Portal e-commerce fees will only apply when no fees are sent or in cases of redistribution.

Split payment example

The transaction amount is BRL 100.00. In this example, following fees were assumed:

Split Fee: 2% MDR + BRL 0.10 Fixed Fee.
Master fee with seller A: 5% MDR (including the 2% Split MDR) + 0.30 Fixed Fee.
Master fee with seller B: 4% MDR (including the 2% Split MDR) + 0.15 Fixed Fee.

Seller A:

  • Credit of BRL 57.00 (BRL 60.00 from the transaction minus 3.00 MDR);
  • Debit of BRL 0.30 Fixed Fee.

The amount receivable by seller A will be BRL 56.70.

Seller B:

  • Credit of R$38.40 (R$40.00 from the transaction minus BRL 1.60 MDR);
  • Debit of R$0.15 Fixed Fee.

The amount receivable by seller B will be BRL 38.25.

Master:

  • Credit of BRL 3.05 (BRL 3.00 MDR + 0.30 Fixed Fee from seller A, combined with BRL 1.60 MDR + 0.15 Fixed Fee from seller B, minus BRL 2.00 Split MDR);
  • Debit of BRL 0.10 (Fixed Fee agreed with the Split).

The amount receivable by the master will be BRL 2.95.

Split:

  • Credit of BRL 2.10 (BRL 2.00 MDR applied on the total transaction amount plus 0.10 Fixed Fee agreed with the Master)

The amount receivable by Split will be BRL 2.10.

See the example request for this scenario in the Example button in the request block.

ℹ️

Alphanumeric CNPJs will be implemented by the Brazilian Federal Revenue Service in July 2026

This change applies only to new registrations. There will be no changes to existing CNPJs.

The alphanumeric CNPJ is already supported by Cielo, with no changes required to your integration.

We recommend checking whether adjustments are needed in your merchant’s own checkout systems.



Visa Intelligent Data Exchange (IDX)

If you use Visa’s IDX authentication service, see Visa Intelligent Data Exchange (IDX).

Body Params
string
required

Order identification number. Warning: Allowed characters are a-z, A-Z, 0-9. Special characters and blank spaces are not allowed. Size: 50.

Customer
object
Payment
object
SplitPayments
object
Headers
string
required

Store identifier in Cielo. Size: 36.

string
required

Public Key for Double Authentication in Cielo. Size: 40.

string

Request identifier, used when the merchant uses different servers for each GET/POST/PUT. Size: 36.

Response

Language
LoadingLoading…
Response
Choose an example:
application/json