Skip to main content
GET
List payment channels
Retrieve every active payment channel (M-Pesa Paybill / Till shortcode) on your account. Use this to discover the channelId values you pass when initiating an STK Push.

Ordering

Channels are returned with the default channel first, then newest to oldest. Soft-deleted channels are never returned.
The channel with "isDefault": true is the one used when you initiate an STK Push without a channelId.

Authorizations

Authorization
string
header
required

Paste your PalPluss API key in the username field and leave the password field empty — it is ignored.

Get your key from console → Settings → API Keys (starts with pk_live_ or pk_test_).

In your own code, send the key directly: Authorization: Basic YOUR_API_KEY

Response

Payment channels retrieved successfully.

success
boolean
required
Example:

true

data
object
required

Response payload. Shape varies by endpoint.

requestId
string<uuid>
required

Unique identifier for this API request. Include in support tickets.

Example:

"c1b2a3d4-e5f6-7890-abcd-ef1234567890"