Checkout API

curl -X POST "https://api.seevplus.com/api/v1/developer/payments" \
  -H "Authorization: Bearer $SEEV_CHECKOUT_API_KEY" \
  -H "Idempotency-Key: order_123_attempt_1" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "checkout",
    "recipient": {
      "name": "Kwame Asante",
      "email": "kwame@example.com"
    },
    "items": [
      {
        "name": "Web Development",
        "description": "Landing page design",
        "quantity": 1,
        "price": 800,
        "image": "https://example.com/web-development.png"
      },
      {
        "name": "Hosting (1 year)",
        "description": "Cloud hosting plan",
        "quantity": 1,
        "price": 200,
        "image": ""
      }
    ],
    "currency": "GHS",
    "channels": ["mobile_money"],
    "redirect_url": "https://yourapp.com/payment/callback",
    "meta": {
      "orderId": "order_123"
    }
  }'

const response = await fetch(
    'https://api.seevplus.com/api/v1/developer/payments',
    {
        method: 'POST',
        headers: {
            Authorization: `Bearer ${process.env.SEEV_CHECKOUT_API_KEY}`,
            'Idempotency-Key': 'order_123_attempt_1',
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            type: 'checkout',
            recipient: { name: 'Kwame Asante', email: 'kwame@example.com' },
            items: [
                {
                    name: 'Web Development',
                    description: 'Landing page design',
                    quantity: 1,
                    price: 800, // GHS 8.00
                    image: 'https://example.com/web-development.png',
                },
                {
                    name: 'Hosting (1 year)',
                    description: 'Cloud hosting plan',
                    quantity: 1,
                    price: 200, // GHS 2.00
                    image: '',
                },
            ],
            currency: 'GHS',
            channels: ['mobile_money'],
            redirect_url: 'https://yourapp.com/payment/callback',
            meta: { orderId: 'order_123' },
        }),
    },
);

const payload = await response.json();

if (response.status !== 201) {
    throw new Error(payload.error ?? 'checkout creation failed');
}

console.log(payload.data.checkout_url);

import os
import requests

response = requests.post(
    "https://api.seevplus.com/api/v1/developer/payments",
    headers={
        "Authorization": f"Bearer {os.environ['SEEV_CHECKOUT_API_KEY']}",
        "Idempotency-Key": "order_123_attempt_1",
        "Content-Type": "application/json",
    },
    json={
        "type": "checkout",
        "recipient": {"name": "Kwame Asante", "email": "kwame@example.com"},
        "items": [
            {
                "name": "Web Development",
                "description": "Landing page design",
                "quantity": 1,
                "price": 800,  # GHS 8.00
                "image": "https://example.com/web-development.png",
            },
            {
                "name": "Hosting (1 year)",
                "description": "Cloud hosting plan",
                "quantity": 1,
                "price": 200,  # GHS 2.00
                "image": "",
            },
        ],
        "currency": "GHS",
        "channels": ["mobile_money"],
        "redirect_url": "https://yourapp.com/payment/callback",
        "meta": {"orderId": "order_123"},
    },
    timeout=30,
)

payload = response.json()

if response.status_code != 201:
    raise RuntimeError(payload.get("error", "checkout creation failed"))

print(payload["data"]["checkout_url"])

<?php

$body = [
    'type' => 'checkout',
    'recipient' => ['name' => 'Kwame Asante', 'email' => 'kwame@example.com'],
    'items' => [
        [
            'name' => 'Web Development',
            'description' => 'Landing page design',
            'quantity' => 1,
            'price' => 800, // GHS 8.00
            'image' => 'https://example.com/web-development.png',
        ],
        [
            'name' => 'Hosting (1 year)',
            'description' => 'Cloud hosting plan',
            'quantity' => 1,
            'price' => 200, // GHS 2.00
            'image' => '',
        ],
    ],
    'currency' => 'GHS',
    'channels' => ['mobile_money'],
    'redirect_url' => 'https://yourapp.com/payment/callback',
    'meta' => ['orderId' => 'order_123'],
];

$curl = curl_init('https://api.seevplus.com/api/v1/developer/payments');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SEEV_CHECKOUT_API_KEY'),
        'Idempotency-Key: order_123_attempt_1',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($body),
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);

$payload = json_decode($response, true);

if ($status !== 201) {
    throw new RuntimeException($payload['error'] ?? 'checkout creation failed');
}

echo $payload['data']['checkout_url'];

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    body, err := json.Marshal(map[string]any{
        "type": "checkout",
        "recipient": map[string]string{
            "name":  "Kwame Asante",
            "email": "kwame@example.com",
        },
        "items": []map[string]any{
            {
                "name":        "Web Development",
                "description": "Landing page design",
                "quantity":    1,
                "price":       800, // GHS 8.00
                "image":       "https://example.com/web-development.png",
            },
            {
                "name":        "Hosting (1 year)",
                "description": "Cloud hosting plan",
                "quantity":    1,
                "price":       200, // GHS 2.00
                "image":       "",
            },
        },
        "currency":     "GHS",
        "channels":     []string{"mobile_money"},
        "redirect_url": "https://yourapp.com/payment/callback",
        "meta":         map[string]string{"orderId": "order_123"},
    })
    if err != nil {
        panic(err)
    }

    req, err := http.NewRequest(
        http.MethodPost,
        "https://api.seevplus.com/api/v1/developer/payments",
        bytes.NewReader(body),
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer "+os.Getenv("SEEV_CHECKOUT_API_KEY"))
    req.Header.Set("Idempotency-Key", "order_123_attempt_1")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload struct {
        Error string `json:"error"`
        Data  struct {
            CheckoutURL string `json:"checkout_url"`
        } `json:"data"`
    }
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    if resp.StatusCode != http.StatusCreated {
        panic(payload.Error)
    }

    fmt.Println(payload.Data.CheckoutURL)
}

curl -X GET \
  "https://api.seevplus.com/api/v1/developer/payments/$SESSION_REF"

const response = await fetch(
    `https://api.seevplus.com/api/v1/developer/payments/${sessionRef}`,
);

const payload = await response.json();

if (!response.ok) {
    throw new Error(payload.error ?? 'verification failed');
}

const paid = ['completed', 'success'].includes(payload.data.status);

import requests

response = requests.get(
    f"https://api.seevplus.com/api/v1/developer/payments/{session_ref}",
    timeout=30,
)

payload = response.json()

if not response.ok:
    raise RuntimeError(payload.get("error", "verification failed"))

paid = payload["data"]["status"] in ("completed", "success")

<?php

$curl = curl_init(
    'https://api.seevplus.com/api/v1/developer/payments/' . rawurlencode($sessionRef)
);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);

$payload = json_decode($response, true);

if ($status < 200 || $status >= 300) {
    throw new RuntimeException($payload['error'] ?? 'verification failed');
}

$paid = in_array($payload['data']['status'], ['completed', 'success'], true);

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
)

func main() {
    sessionRef := "SESSION_REFERENCE"

    resp, err := http.Get(
        "https://api.seevplus.com/api/v1/developer/payments/" + url.PathEscape(sessionRef),
    )
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload struct {
        Error string `json:"error"`
        Data  struct {
            Status string `json:"status"`
        } `json:"data"`
    }
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    if resp.StatusCode < 200 || resp.StatusCode >= 300 {
        panic(payload.Error)
    }

    paid := payload.Data.Status == "completed" || payload.Data.Status == "success"
    fmt.Println(paid)
}