Multi-Party Split

Configure a 3-way BPS split and verify exact payout amounts

Split Breakdown

Example: $50.00 settlement split three ways (7000/2500/500 BPS)

provider (agent_aaa)

7000

BPS (70%)

$35.00

platform (agent_bbb)

2500

BPS (25%)

$12.50

network (agent_ccc)

500

BPS (5%)

$2.50

Create the 3-Way Settlement

All splits must total exactly 10,000 BPS

curl -X POST https://api.sandbox.zexrail.com/v1/settlements \
  -H "Authorization: Bearer sk_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "negotiation_id": "neg_xyz",
    "adapter": "test",
    "splits": [
      { "agent_id": "agent_aaa", "bps": 7000 },
      { "agent_id": "agent_bbb", "bps": 2500 },
      { "agent_id": "agent_ccc", "bps": 500 }
    ]
  }'

Execute and Verify

Confirm each party received the correct amount

# Execute
curl -X POST https://api.sandbox.zexrail.com/v1/settlements/{stl_id}/execute \
  -H "Authorization: Bearer sk_test_your_key"

# Get receipt
curl https://api.sandbox.zexrail.com/v1/settlements/{stl_id}/receipt \
  -H "Authorization: Bearer sk_test_your_key"

Validation Rules

Total BPS across all splits must equal exactly 10,000
Minimum split per party is 1 BPS (0.01%)
Maximum number of parties per settlement is 10
Each agent_id must be a registered, active agent