Skip to content
/payments

Get payment channels for a country

Request

🔒 Private label — contact sales. Requires a private-label entitlement on your API client.

Get payment channels for a country

Security
oauth2ClientCredentials(Required scopes: payments:read)
Query
countrystringrequired

Country code (e.g., KENYA)

Example:country=KENYA
Headers
org_wallet_refstring

Organization wallet reference, defaults to "1" if not provided

business_idstringrequired

Business identifier for the request

curl -i -X GET \
  'https://developer.boyahq.com/_mock/v2/openapi/payments/channels?country=KENYA' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'business_id: string' \
  -H 'org_wallet_ref: string'

Responses

Payment channels retrieved successfully

Bodyapplication/json
statusbooleanrequired

Request status

Example:true
dataArray of objects(PaymentChannelV1Dto)

List of payment channels

messagestring

Response message

Example:"Country payment channels fetched successfully"
Response
{
  "status": true,
  "data": [
    { … }
  ],
  "message": "Country payment channels fetched successfully"
}