Payments

Split Payments

Use split payments when a single customer payment must be reconciled across platform and merchant parties.

MarketplaceNeroConnectSplit amounts

Create split payment

POST/split-payments

Creates a payment that can be allocated across recipients or connected account components where enabled.

Parameter	Type	Required	Description
`amount`	decimal	Yes	Total payment amount in major units.
`currency`	string	Yes	Currency code.
`description`	string	Optional	Description for dashboard and reconciliation.
`reference`	string	Optional	Your platform reference.
`splits`	array	Yes	List of split allocations. Each item should include a recipient/account reference and amount.
`connect_application_fee`	decimal	Optional	Platform fee where applicable.

 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $secretKey,
        'Accept: application/json',
        'Content-Type: application/json',
        'X-NeroPay-Timestamp: ' . $timestamp,
        'X-NeroPay-Signature: ' . $signature,
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => $rawBody,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $response;

{
  "success": true,
  "data": {
    "id": "split_nero_123",
    "status": "pending",
    "amount": "50.00",
    "currency": "GBP",
    "splits": [
      {
        "account_id": "NP6454f52b_6165",
        "amount": "45.00"
      },
      {
        "account_id": "platform",
        "amount": "5.00"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "validation_failed",
    "message": "The split total must match the payment amount.",
    "details": {
      "amount": [
        "The amount field is required."
      ]
    }
  }
}

NeroPay Docs

Split Payments

Split Payments

Create split payment