Menu
Feedback
Start here
Tutorials


Tutorials
Payment Settings
Split Payment
8 min read

This is a marketplace payment solution.

To guarantee that our marketplace clients automatically divide the payment between all sellers, set a commission based on a fixed percentage, and remain operating in accordance with current regulations, VTEX offers the Split Payment.

Below are two examples of split payment application scenarios where a consumer adds products from different sellers to the same cart:

  1. When the marketplace is responsible for processing payment for the purchase, VTEX automatically divides this payment so that each beneficiary receives their share directly into their own bank account, thus carrying out the Payout Split.
  2. When the cart involves sellers who are responsible for processing their own payment method (without depending on the marketplace), VTEX creates different payment transactions for the Marketplace and the sellers, performing the Transaction Split.

The distribution of purchase amounts is always carried out in accordance with pre-defined commission percentage agreements between the marketplace and sellers.

Check below for more details about each of the split payment models:

CharacteristicsPayout SplitTransaction Split
Payment providerPayment provider of the marketplacePayment provider of the seller.
Number of transactionsOnly one transactionOne transaction to each seller
Number of purchases in the customer’s credit card statementOnly oneOne purchase to each seller.
  • This fact may lead to misunderstandings and increase disputes and chargebacks.
  • Fees negotiationMarketplace will be responsible for negotiating all fees.
  • In scale, this can be positive to increase bargain power.
  • Marketplace will be responsible for negotiating all fees. In scale, this can be positive to increase bargain power.
    Anti fraud assessmentAs only one transaction is generated, the entire order is assessed by one anti-fraud.As multiple transactions are generated, each of them run into a different analysis. If one transaction is denied, all others are automatically denied as well
    Payment providers integratedSee which payment providers use Payout Split in the List of Payment Providers by CountryAll payment providers integrated to VTEX.
    CostCosts according to the negotiated fee.
    • Usually costs more than non-split transactions.
    • Carts that only have marketplace products, will still be processed taking into consideration the negotiated fee, potentially increasing cost.
    No additional costs, VTEX clients will only be responsible for their usual fees with payment providers
    Checkout ExperienceNo limitations regarding payment methods and payment conditions. Those will be defined by the marketplace.
    • The payment provider must also support Split in specific payment methods (Pix, for example). Nowadays our partners support split with one or two credit cards, debit cards and boleto (Brazil).
    Only displays payment methods accepted by all sellers fulfilling the order. In other words, payments by credit card, cash or card promissory (promissories that can be splited), will only be available if all sellers involved in the order accept them. Incompatible with:
    • Boleto (Brazil).
    • Pix (Brazil).
    • Cards with 3DS2 or any authentication.
    Ideal for
    • Marketplaces that want to charge automatic commissions, avoiding the risk of delinquency.
    • Marketplaces whose sellers do not have a payment provider.
    • Marketplaces that want to have more control over the payment flow of sellers.
    • Marketplaces that want to process transactions with Pix (Brazil), boleto (Brazil) and credit cards with 3DS2 or any other authentication.
    • Marketplaces that don't want to be merchants of record (common for B2B businesses from Europe and the United States).
    • Cases in which the seller has more decision power than the marketplace and only accepts that the payment is processed by their own payment provider.
    • Marketplaces that have urgency to implement split and do not have partners supporting split in their countries.
    • Marketplaces that don't want to have all the chargeback risks.
    Benefits
    • Marketplaces automatically define commissions.
    • Optimized experience: only one purchase in the credit card statement.
    • Marketplace gains more control over the payment flow.
    • Compatible with Pix (Brazil), boleto (Brazil) and cards with 3DS2 or any authentication.
    • The marketplace can define payment methods that are applicable to any order, no matter the sellers involved.
    • More flexibility for each seller to choose their anti-fraud provider.
    • Payment settlement can occur at different times for each participant.
    • Marketplace is not liable for chargebacks.

    Payout Split

    This split payment model enables marketplace clients to gain more control and visibility over payouts and commissions. And grants more control over the payment flow as VTEX holds the seller's payment until the order is invoiced.

    Marketplaces can indicate how the purchase amount should be split and which percentage is reserved for the marketplace itself defining automatic commissions per total cost of products, freight, or SKU's category for each seller with the transaction being processed only by the marketplace payment provider who will be responsible for paying out each seller.

    For example, a shopper adds two products to the same shopping cart. One of them will be fulfilled by the marketplace itself and the other one belongs to a seller called Seller A. However, only one transaction is generated, meaning that the end consumer will only see one line in the credit card statement.

    The payment is distributed as follows:

    {"base64":"  ","img":{"width":933,"height":438,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":120655,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/split-payment_1.png"}}

    As you can see, our Gateway calculates and distributes payouts for each recipient when the order is invoiced and sends that info to the payment provider. The distribution is done according to the amount destined to each merchant in the order and the commissions taken by the marketplace.

    {"base64":"  ","img":{"width":1014,"height":539,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":179321,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/split-payment_2.png"}}

    Our Payout Split solution has some limitations that are important to consider:

    • Combined Payment Methods: it does not support when one of them does not support Split. Example: gift card + credit card (gift card does not support Split). Currently, it is only possible to have the split payment when the combined methods are two credit cards due to a checkout limitation.

    • Change Order: it does not work with changes in values or items after the order is placed. Orders containing splits can be partially refunded, but not cancelled.

    • VTEX Subscriptions: it does not support marketplace orders.

    • Sellers ID: CNPJ is the primary key to make the split, so the recipients (marketplaces or sellers) need to be legal entities.

    • Same CNPJ: since the CNPJ is the primary key to make the Split, it is not possible for two or more recipients/sales participants with the same CNPJ to be seen as different "entities".

    • Parties Involved: it does not allow to Split the payment with recipients who are not selling products in the cart. For example: to split the freight directly to the carrier.

    • Nominal Fees: it does not allow nominal fees. Currently, it is only possible to apply percentage commissions on products and/or freight.

    • Assigning transactions to the provider: today it is only possible to assign a preferred affiliation at the gateway to process Split using commercial conditions for the SKUs that are sold by the Seller. However, there are limitations:

      • If the seller and the marketplace have the same SKU, the cart will always go to the Split payment method.
      • The list of SKUs has to be constantly updated.
    • Transaction interest: it is not possible to select who will receive the interest information (marketplace or seller). All transactions in which the customer made interest payments are automatically sent to the marketplace.

    Transaction Split

    In the Transaction Split, the marketplace is not a "centralizer" of the payouts. Right after the shopper completes the purchase, our checkout system creates one or multiple transactions (one per seller).

    The payment is not always processed by the marketplace payment provider, but by each merchant’s payment provider (each seller’s payment provider is responsible for processing their portion of the transaction).

    Meaning that the marketplace has less control over the payment flow. Unlike the other model, VTEX does not hold payment until the order is invoiced, each share will be automatically sent to the respective participant right after the checkout

    For example, a shopper adds two products to the same shopping cart. One of them will be fulfilled by the marketplace itself and the other one belongs to a seller called Seller A.

    {"base64":"  ","img":{"width":1021,"height":434,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":146805,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/split-payment_3.png"}}

    In the Transaction Split, the marketplace has no need to make any configuration. The seller is the one that needs to configure their own payment method in the affiliation with a given marketplace. Find out more at Send the Seller White Label payment methods to the Marketplace.

    {"base64":"  ","img":{"width":843,"height":615,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":90005,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/split-payment_4.png"}}

    The transaction split has a few limitations that must be taken into account:

    • Setting Commissions: in this model marketplaces cannot automatically receive commissions, as the transaction is not processed by its payment provider. Marketplaces will have to manually collect their commission from sellers, potentially increasing marketplace default risk.
    • Payment Methods: it is incompatible with boleto (Brazil), Pix (Brazil), Payment Apps and credit cards with 3DS2 or any payment method with authentication.
    • Intercessing Payment Methods: Intercesses payment methods, meaning that it only allows payments with credit card, cash and promissory if all involved merchants accept them.
    • Fraud Mitigation: every merchant will have to analyse fraud risk on their own. If one of the merchants' fraud providers deny a transaction, all other transactions will also be declined.
    • For non-VTEX sellers: if the seller is a non-VTEX seller it is necessary that it uses a Gateway account, which is a type of account that allows the seller to configure payment methods.
    • Parties Involved: it does not allow to Split the payment with recipients who are not selling products in the cart. For example: to split the freight directly to the carrier.
    • VTEX Subscriptions: it does not support marketplace orders.

    Combining Split Models

    When Transaction Split and Payout Split are combined, the Transaction Split will prevail. That is, for sellers who choose to use their payment methods, their portion of the transaction will be processed at their own gateway and the values of the other sales participants will continue to be processed by the marketplace.

    Contributors
    2
    Photo of the contributor
    Photo of the contributor
    + 2 contributors
    Was this helpful?
    Yes
    No
    Suggest Edits (GitHub)
    Setting up WebPay2P gateway
    « Previous
    Adding BIN information
    Next »
    Contributors
    2
    Photo of the contributor
    Photo of the contributor
    + 2 contributors
    On this page
    Still got questions?
    Ask the community
    Find solutions and share ideas in the VTEX Community
    Join our community
    Request VTEX support
    For personalized assistance, contact our experts
    Open a support ticket
    GitHubDeveloper PortalCommunityFeedback