Skip to main content
GET
/
v1
/
checkouts
/
{checkoutId}
/
{mediumId}
curl https://api.kwugwo.africa/v1/checkouts/chk.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/ussd \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY"

const providers = await fetch(
  `https://api.kwugwo.africa/v1/checkouts/${checkoutId}/${mediumId}`,
  { headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());

<?php
$url = "https://api.kwugwo.africa/v1/checkouts/{$checkoutId}/{$mediumId}";
$ch  = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$providers = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

providers = requests.get(
    f"https://api.kwugwo.africa/v1/checkouts/{checkout_id}/{medium_id}",
    headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()

url := fmt.Sprintf("https://api.kwugwo.africa/v1/checkouts/%s/%s", checkoutId, mediumId)
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

[
  {
    "psp": "paystack",
    "banks": [
      { "code": "058", "name": "GTBank" },
      { "code": "044", "name": "Access Bank" }
    ]
  }
]
Returns the PSP providers that will be used when a customer pays this checkout via the given medium. Useful for diagnostics and for rendering provider-specific inputs (e.g. “which bank do you want to dial?” for ussd).

​
Path parameters

​
checkoutId
string
required
Checkout ID, chk.XXXX.YYYY....
​
mediumId
string
required
Medium identifier, bank_transfer, mobile_money, or ussd.

​
Response

An array of provider entries. The shape varies by medium, but every entry carries at least a psp identifier; mediums like ussd and mobile_money also list the banks or wallet providers each PSP supports. 
curl https://api.kwugwo.africa/v1/checkouts/chk.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/ussd \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY"

const providers = await fetch(
  `https://api.kwugwo.africa/v1/checkouts/${checkoutId}/${mediumId}`,
  { headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());

<?php
$url = "https://api.kwugwo.africa/v1/checkouts/{$checkoutId}/{$mediumId}";
$ch  = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$providers = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

providers = requests.get(
    f"https://api.kwugwo.africa/v1/checkouts/{checkout_id}/{medium_id}",
    headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()

url := fmt.Sprintf("https://api.kwugwo.africa/v1/checkouts/%s/%s", checkoutId, mediumId)
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

[
  {
    "psp": "paystack",
    "banks": [
      { "code": "058", "name": "GTBank" },
      { "code": "044", "name": "Access Bank" }
    ]
  }
]