Skip to main content

Split Examples

Here are a series of example to explain how splits will work and how settlements will be performed.

Before we start, let's have the following models and fee structures:

  • Entity 812ea4b5-8767-4154-b711-4ffd7c69b634
    • Name: Cookie Shop
    • Charge Rate: 2.70%
    • Charge Fixed: 1.00 SAR
  • Platform 335f8c46-1f16-4743-83fe-f23155eade75
    • Name: Millennium Stores
    • Charge Rate: 2.50%
    • Charge Fixed: 1.00 SAR
  • Beneficiary fdec38c1-2d34-4469-88b4-f53474174329

Example #1​

A merchant is making a payment of 1500.00 SAR and the platform is going to charge the merchant 14% extra charge on the payment.

The payment request should have the following splits defined:

  • #split_1: 129000
  • #target_1: 812ea4b5-8767-4154-b711-4ffd7c69b634
  • #split_2: 21000
  • #target_2: 335f8c46-1f16-4743-83fe-f23155eade75

Here is how the payment will be processed and settlements will go:

  • Entity fee: 41.5 + 6.23 (VAT) = 47.73
  • Platform fee: 38.5 + 5.78 (VAT) = 44.28
  • Platform Cut: 3.45

After fee is calculated, the following splits will be made:

  • Entity Split: 1290.00 - 47.73 = 1242.27
  • Platform Split: 210.00 + 3.45 = 213.45
  • Gateway Split: 44.28
  • Total: 1500.00

Example #2​

If we take Example #1 but added the following to shift fee collection from the entity to the platform instead:

  • #fee_source: 335f8c46-1f16-4743-83fe-f23155eade75

The following splits will be made:

  • Entity Split: 1290.00
  • Platform Split: 210.00 - 47.73 + 3.45 = 165.72
  • Gateway Split: 44.28
  • Total: 1500.00

Example #3​

A merchant is making a payment of 1800.00 SAR and the platform is going to charge the merchant 5% extra charge on the payment + 30 shipping fee for the beneficiary (which we will assume they are the shipping company here).

The payment request should have the following splits defined:

  • #split_1: 168000
  • #target_1: 812ea4b5-8767-4154-b711-4ffd7c69b634
  • #split_2: 9000
  • #target_2: 335f8c46-1f16-4743-83fe-f23155eade75
  • #split_3: 3000
  • #target_3: fdec38c1-2d34-4469-88b4-f53474174329

Here is how the payment will be processed and settlements will go:

  • Entity fee: (48.6 + 1) + 7.44 (VAT) = 57.04
  • Platform fee: 46 + 6.9 (VAT) = 52.9
  • Platform Cut: 4.14

After fee is calculated, the following splits will be made:

  • Entity Split: 1680.00 - 57.04 = 1622.96
  • Platform Split: 90.00 + 4.14 = 94.14
  • Beneficiary Split: 30.00
  • Gateway Split: 52.9
  • Total: 1800.00