> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://beta-docs.payabli.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://beta-docs.payabli.com/_mcp/server.

# Split funds from a transaction

With Payabli's split funding functionality, you can use split instructions in the transaction request to distribute the funds from a single transaction to different bank accounts for a paypoint, or to different paypoints set up for split funding.

## Setup

Contact the Payabli team to use this feature. The team will work with you to understand your business needs and design the best configuration.

## Usage

To split funds, send split instructions in the `paymentDetails` object of a transaction request.

Split funding is available in these endpoints:

* [MoneyIn/getpaid](/api-reference/moneyin/make-a-transaction)
* [MoneyIn/authorize](/api-reference/moneyin/authorize-a-transaction)

### Get required values

Split instructions support `recipientEntryPoint`, `accountId`, or both. This means that you can route funds to other paypoints, or to separate bank accounts of a single paypoint. This means that you can route funds to multiple accounts in other eligible paypoints, or to separate bank accounts of a the paypoint that's processing the transaction.

#### Retrieve \`recipientEntryPoint\` values

Find the entrypoint value for the paypoints you want to send funds to. See [Entrypoint Overview](/api-reference/api-overview#entrypoint-vs-entry) for instructions.

#### Retrieve \`accountId\` values

You can retrieve `accountId` values for all a Paypoint's accounts by sending a GET request to the [/Paypoint endpoint](/api-reference/paypoint/get-paypoint-details). They're returned in objects in the `Credentials` array.

#### Click to expand example

In this example, there are two accounts for ACH (187-782 and 187-783) and two accounts for card (187-798 and 187-799)

```json
{
    "isSuccess": true,
    "responseText": "Success",
    "responseCode": 1,
    "": {
        "Paypoint": {
            "IdPaypoint": 187,
            "DbaName": "The Board Haus",
            "LegalName": "Board Haus LLC.",
            "Address1": "1801 Main Avenue",
            "Address2": "",
            "City": "Durango",
            "Zip": "81301",
            "ServiceData": null,
        // Example truncated
            "Credentials": [
                {
                    "Service": "ach",
                    "Mode": 1,
                    "Minticket": 0.0,
                    "Maxticket": 100000.0,
                    "CfeeFix": 0.0,
                    "CfeeFloat": 0.0,
                    "CfeeMin": 0.0,
                    "CfeeMax": 0.0,
                    "ReferenceId": 348,
                    "AccountId": "187-782"
                },
                {
                    "Service": "ach",
                    "Mode": 0,
                    "Minticket": 0.0,
                    "Maxticket": 100000.0,
                    "CfeeFix": 0.0,
                    "CfeeFloat": 0.0,
                    "CfeeMin": 0.0,
                    "CfeeMax": 0.0,
                    "ReferenceId": 348,
                    "AccountId": "187-783"
                },
                {
                    "Service": "card",
                    "Mode": 0,
                    "Minticket": 0.0,
                    "Maxticket": 100000.0,
                    "CfeeFix": 0.0,
                    "CfeeFloat": 0.0,
                    "CfeeMin": 0.0,
                    "CfeeMax": 0.0,
                    "ReferenceId": 358,
                    "AccountId": "187-798"
                },
                {
                    "Service": "card",
                    "Mode": 1,
                    "Minticket": 0.0,
                    "Maxticket": 100000.0,
                    "CfeeFix": 0.0,
                    "CfeeFloat": 0.0,
                    "CfeeMin": 0.0,
                    "CfeeMax": 0.0,
                    "ReferenceId": 358,
                    "AccountId": "187-799"
                },
    
                // Example truncated
            ]
        },
    },
}
```

### Split instructions

Send split instructions in the `splitFunding` array inside the `paymentDetails` object in the request. See [Example request](#example-request) for help.

> **Warning**
>
> The amounts in the split instructions must add up to match the transaction net total *exactly*, or the request will fail.

**`splitFunding`** `array`

An array of `splitFundingContent` objects.

#### properties

**`splitFundingContent`** `object`

The split funding instruction's content.

#### properties

**`recipientEntryPoint`** `string`

Entrypoint ID for a recipient entrypoint.

---

**`accountId`** `string`

Account ID of the account that the split funds should be deposited in.

---

**`amount`** `number`

Double. The amount of the split.

---

**`description`** `string`

A description or note to describe the split. Payabli strongly recommends that you use this field on every refund split. This helps identify the purpose of the refund split for reconciliation by the merchant.

---

---

---

## Example request

**`Split a GetPaid transaction`**

```bash Split a GetPaid transaction

curl --request POST \
     --url 'https://api-sandbox.payabli.com/api/MoneyIn/getpaid?forceCustomerCreation=false' \
     --header 'accept: application/json' \
     --header 'content-type: application/*+json' \
     --header 'requestToken: API TOKEN' \
     --data 
{
  "entryPoint": "41035afaa7",
  "accountId": "187-234",
  "paymentMethod": {
    "method": "card",
    "cardnumber": "4111111111111111",
    "cardexp": "12/25",
    "cardcvv": "999",
    "cardzip": "85284",
    "cardHolder": "Lisandra Olonets"
  },
"paymentDetails": {
  "totalAmount": 123.45,
  "serviceFee": 23.45,
  "splitFunding": [
    {
      "recipientEntryPoint": "41035afaa7",
      "accountId": "187-300", 
      "description": "Monthly maintenance fee",
      "amount": 50.45
    },
    {
      "recipientEntryPoint": "3005cdba0",
      "accountId": "230-391",
      "description": "Payment toward special assessment",  
      "amount": 30.33
    },
    {
      "recipientEntryPoint": "995d16ccba",
      "accountId": "298-239",
      "description": "Security deposit",
      "amount": 19.22
    }
  ]
},
  "customerData": {
    "customerId": "4440"
  }
}
```

## Example response

The success response is the standard transaction success response.

**`Success response`**

```json Success response
{
    "responseText": "Success",
    "isSuccess": true,
    "pageIdentifier": null,
    "responseData": {
        "authCode": "TAS726",
        "referenceId": "245-d6af5e23b5db43fbbb2bea04614d2735",
        "resultCode": 1,
        "resultText": "Approved",
        "avsResponseText": null,
        "cvvResponseText": null,
        "customerId": 4440,
        "methodReferenceId": null
    }
}
```