Quick Start

Go from zero to your first successful test payment.

1. 1

   Create and verify your account

   Sign up for a Starter or Registered Business account. You'll need a Ghana Card number to complete registration.

2. 2

   Generate your API keys

   Once approved, go to API Keys in your dashboard and click Generate API Key. Save your Secret Key immediately — it's only shown once.

3. 3

   Initialize a transaction

   cURL PHP Node.js Python

   curl -X POST https://starpaysgh.com/api/v1/transactions/initialize \
     -H "Authorization: Bearer sk_test_xxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{"amount": 50, "customer_email": "customer@example.com"}'

   $ch = curl_init('https://starpaysgh.com/api/v1/transactions/initialize');
   curl_setopt_array($ch, [
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_POST => true,
       CURLOPT_HTTPHEADER => [
           'Authorization: Bearer sk_test_xxxxxxxxxxxx',
           'Content-Type: application/json',
       ],
       CURLOPT_POSTFIELDS => json_encode([
           'amount' => 50,
           'customer_email' => 'customer@example.com',
       ]),
   ]);
   $response = json_decode(curl_exec($ch), true);
   curl_close($ch);

   const response = await fetch('https://starpaysgh.com/api/v1/transactions/initialize', {
     method: 'POST',
     headers: {
       'Authorization': 'Bearer sk_test_xxxxxxxxxxxx',
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({ amount: 50, customer_email: 'customer@example.com' }),
   });
   const data = await response.json();

   import requests
   
   response = requests.post(
       'https://starpaysgh.com/api/v1/transactions/initialize',
       headers={'Authorization': 'Bearer sk_test_xxxxxxxxxxxx'},
       json={'amount': 50, 'customer_email': 'customer@example.com'},
   )
   data = response.json()

4. 4

   Redirect your customer

   The response includes a checkout_url. Send your customer there to complete payment.

5. 5

   Confirm the result

   Either listen for the webhook, or call the verify endpoint directly.