> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helloclever.co/llms.txt
> Use this file to discover all available pages before exploring further.

# October 2026

> Platform fees and fund splitting for Clever Connect: split a Payin across Payments Accounts on v2 Payins and Payment Gateway 3 payin links.

October introduces platform fees for Clever Connect. A platform can keep its own fee on a Payin and split the rest across merchant Payments Accounts, on both the v2 Payins API and Payment Gateway 3 payin links.

| Category | Changes |
| - | - |
| [API](#api) | `allocation_profile` on `POST /v2/payins`, accounts endpoint for allocation recipients |
| [Payment Gateway](#payment-gateway) | `allocation_profile` on Payment Gateway 3 payin links |

## API

### Platform fees on v2 Payins

[Create a Payin](/api/payin/create-a-payin) (`POST /v2/payins`) accepts an optional `allocation_profile` object:

| Field | Description |
| - | - |
| `uuid` | An active allocation profile in the Payin currency. |
| `recipients` | Recipient account UUIDs, one per profile slot. Each must be in the Payin currency, appear once, and not be the receiving account. Get the UUIDs from [Get Allocation Recipient Accounts](/api/platform-fee/get-allocation-recipient-accounts). |

When the object is sent, the response and [Get Payin Details](/api/payin/get-payin-details) return the applied split in `allocation_profile`: `platform_fee`, `platform_fee_fixed`, `platform_fee_amount`, and the amount moved to each recipient.

* The platform fee is `amount × platform_fee% + platform_fee_fixed`. Recipients share what is left. The Hello Clever processing fee comes out of the platform fee.
* The request is rejected before any money moves if the profile, recipients, or platform fee are invalid. See the [error list](/developer-reference/api-use-cases/split-payins-with-platform-fees#errors).
* Payins sent without `allocation_profile` are unchanged.

### Listing allocation recipients

[Get Allocation Recipient Accounts](/api/platform-fee/get-allocation-recipient-accounts) (`GET /v2/merchant_allocation_profiles/accounts`) now accepts `app-id` and `secret-key`. Called with the receiving account's keys, it returns the other Payments Accounts in the same currency that can receive a share. The currency is taken from the `app-id`, so no `currency` parameter is needed.

Docs: [Split Payins with platform fees](/developer-reference/api-use-cases/split-payins-with-platform-fees) · [Platform Fees](/platform-overview/clever-concepts/platform-fees)

## Payment Gateway

### Platform fees on payin links

[Create PayIn](/api/gateway3/payin/create-payin) (`POST /v3/payin_links`) accepts the same `allocation_profile` object. Once the customer pays, [Get PayIn details](/api/gateway3/payin/get-payin-details) returns the split in `transaction_info.allocation_profile`.

* If `payin_method_code` is left out, the customer picks the method at checkout and the platform fee is checked against that method's processing fee.
* For card payments, the split is applied after the card is charged, once the card brand and processing fee are known. The Payin moves to **received** when it settles.

Docs: [Split Payins with platform fees](/developer-reference/api-use-cases/split-payins-with-platform-fees#option-b-payment-gateway-3-payin-links)

<Note>
  Fund splitting is available to Clever Connect accounts on Dedicated Balance, for AUD, USD, JPY, VND, ARS, IDR, INR and KES. Hello Clever enables it per currency: contact your account manager.
</Note>


## Related topics

- [Hello Clever MCP](/clever-ai/helloclever-mcp.md)
- [Release Notes](/release-notes/index.md)
- [September 2026](/release-notes/2026-09.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.