Disbursements

SplashPay Disbursements enables businesses to send money securely and reliably to customers, suppliers, employees, and partners. Using a single API integration, you can initiate payouts to:

Mobile Money wallets
Bank accounts
Selcom Pesa wallets

Every disbursement is tracked using a unique reference and supports real-time status updates through webhooks.

Features

Single API for all payout channels
Mobile Money and bank disbursements
Selcom Pesa wallet transfers
Account and wallet name lookup
Idempotent requests
Wallet balance validation
Real-time webhook notifications
Transaction status tracking
Secure API authentication

Base URL

https://api.splashpay.co.tz/api/v1

Authentication

Every request must include your API credentials.

Header	Required	Description
X-API-KEY	✅	Merchant API Key
X-API-SECRET	✅	Merchant API Secret
Idempotency-Key	✅	Prevent duplicate requests
Content-Type	✅	application/json

Example

X-API-KEY: pk_live_xxxxxxxxxxxxx
X-API-SECRET: sk_live_xxxxxxxxxxxxx
Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000
Content-Type: application/json

Supported Disbursement Channels

Channel	Description
Mobile Money	Send funds to supported mobile wallets
Bank	Transfer funds to bank accounts
Selcom Pesa	Transfer funds to Selcom Pesa wallets

Typical Workflow

Verify the recipient

Optionally verify the recipient using the Name Lookup API before initiating the disbursement.

Initiate the disbursement

Submit a payout request using the appropriate endpoint for the destination channel.

Receive the response

SplashPay validates your request and submits it to the payment provider.

Track the transaction

Monitor the payout using the Status API or receive automatic webhook notifications.

Transaction Status

Status	Description
pending	Request received and awaiting processing
processing	Submitted to the payment provider
paid	Funds successfully delivered
failed	Provider rejected or failed the transfer
cancelled	Transaction cancelled

Idempotency

All disbursement requests must include an Idempotency-Key. Using the same key ensures that retrying a request due to network issues does not create duplicate payouts. Example

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

Security

SplashPay protects your payouts using:

API Key authentication
API Secret authentication
HTTPS encryption
Idempotent requests
Request validation
Transaction auditing
Webhook signature verification

Getting Started

Collections

Disbursements

Overview

Disbursements

Features

Base URL

Authentication

Supported Disbursement Channels

Typical Workflow

Transaction Status

Idempotency

Security

​Disbursements

​Features

​Base URL

​Authentication

​Supported Disbursement Channels

​Typical Workflow

​Transaction Status

​Idempotency

​Security

Disbursements

Features

Base URL

Authentication

Supported Disbursement Channels

Typical Workflow

Transaction Status

Idempotency

Security