New service | **Last updated**: 01 July 2025

# Split a payment

### Example use case

This example outlines a split payment journey within a food delivery marketplace platform. Ensuring a seamless experience for customer, restaurant and driver.

**Scenario:** A customer orders a food delivery from a local restaurant, the Baker Street Café, to their home.

1. **Order placement:** Customer makes food order for £100.
2. **Order acceptance and delivery:** Restaurant accepts order and sends food via delivery driver.
3. **Payment distribution:** The food delivery marketplace splits the `"totalAmount": 10000` as follows:
  * **restaurant:** `"amount": 9000`, with a `commission` of 1% being taken by the food delivery marketplace. The marketplace therefore receives £0.10 in their virtual Worldpay bank account, leaving £89.10 to be paid out to `partyReference: "The Baker Street Café"`
  * **delivery driver:** `"amount": 1000`, with a `fee` of £2 being taken by the food delivery marketplace, which they will receive in their virtual Worldpay bank account. Leaving £8 to be paid out to `"partyReference": John Watson"`


## Request

Best Practice
Only split a payment once you have submitted the final amount to be authorized.

`POST` `https://try.access.worldpay-bsh.securedataplatform.com/splitPayments`

#### Request examples

#### Request schema

### Deductions

Optional commissions and fees are deducted per `lineItem`.

In the [above example](#request-examples) where `"itemReference"="aaa1"` and the `"amount": 90`, a `commission` of 1% is taken against the £90. Leaving £89.10 to be paid out to `"partyReference": "The Baker Street Café"`.

There is also a second deduction taken against `"itemReference"="bbb2"` with `"amount": 10`. In the request a flat `fee` of £2 is taken. The remainder of £8 will be paid out to `"partyReference": "John Watson"`

#### Example extract


```
"deductions": [
        {
          "type": "commission",
          "value": {
            "type": "percentage",
            "amount": 1
          },
          "description": "Deduction description"
        }
```

View our full request and response schema in our [API reference](/products/split-payments/openapi).

## Response

#### Example response

#### Response schema

#### Errors

Check out our API reference for the full [error code schema](/products/split-payments/openapi/other/splitpayments#other/splitpayments/response&c=201).

Note
If you have set `fulfillment.auto` to `false` you **must** now settle your payment.

**Next Steps**

[Settle your purchase](/products/split-payments/manage)
[Refund your purchase](/products/split-payments/manage#refund-a-payment)