Skip to main content
POST
Create Second Split

Endpoint

Overview

Use this endpoint to perform a second split on an existing transaction. This allows you to distribute proceeds to a third merchant account after the original payment has been processed.
This feature requires special configuration. Contact Digitzs support to enable second split functionality for your merchant accounts.

Authentication

Request Body

string
required
Must be "payments"
object
required
Container for payment attributes
string
required
Must be "secondSplit"
string
required
The payment ID of the original transaction to split from
object
required
Split configuration
string
Optional JSON string with additional metadata

Example Request

Response

Success Response (201 Created)

Code Examples

Important Notes

Configuration Required: Second split functionality must be enabled for your merchant accounts. Contact Digitzs support before using this feature.
Available Balance: The second split amount cannot exceed the available balance after the first split and processing fees.
Use Case: This is useful for complex revenue sharing scenarios like referral fees, affiliate commissions, or multi-party marketplaces.

Best Practices

  1. Verify Parent Payment: Ensure the parent payment has settled before creating a second split
  2. Track All Splits: Maintain records of all split transactions for reconciliation
  3. Validate Amount: Check that sufficient funds remain for the second split
  4. Clear Documentation: Document the reason for each split in the miscData field

Next Steps

Get Payment Details

View complete payment details including all splits