TemboPay Business API

// Node.js Integration Service
const axios = require('axios');

class TemboPayService {
    constructor() {
        this.baseUrl = process.env.TEMBOPAY_BASE_URL || 'https://tembopay.africa';
        this.environment = process.env.TEMBOPAY_ENVIRONMENT || 'sandbox'; // sandbox or production
        this.merchantKey = process.env.TEMBOPAY_MERCHANT_KEY; // Use appropriate prefix
        this.apiKey = process.env.TEMBOPAY_API_KEY; // Use appropriate prefix
    }

    async initiatePayment(paymentData) {
        try {
            const response = await axios.post(`${this.baseUrl}/api/v1/initiate-payment`, paymentData, {
                headers: {
                    'Content-Type': 'application/json',
                    'X-Environment': this.environment,
                    'X-Merchant-Key': this.merchantKey,
                    'X-API-Key': this.apiKey
                }
            });

            return response.data;
        } catch (error) {
            throw new Error(`TemboPay API Error: ${error.message}`);
        }
    }

    async verifyPayment(transactionId) {
        try {
            const response = await axios.get(`${this.baseUrl}/api/v1/verify-payment/${transactionId}`, {
                headers: {
                    'Accept': 'application/json',
                    'X-Environment': this.environment,
                    'X-Merchant-Key': this.merchantKey,
                    'X-API-Key': this.apiKey
                }
            });

            return response.data;
        } catch (error) {
            throw new Error(`TemboPay API Error: ${error.message}`);
        }
    }
}

// Express.js Route Example
const express = require('express');
const app = express();
const tembopay = new TemboPayService();

app.post('/initiate-payment', async (req, res) => {
    const paymentData = {
        payment_amount: req.body.amount,
        currency_code: 'USD',
        ref_trx: `ORDER_${Date.now()}`,
        description: req.body.description,
        success_redirect: `${req.protocol}://${req.get('host')}/payment/success`,
        cancel_redirect: `${req.protocol}://${req.get('host')}/payment/cancelled`,
        ipn_url: `${req.protocol}://${req.get('host')}/webhooks/tembopay`,
        allow_payment_methods: ['stripe', 'paypal'],
    };

    try {
        const result = await tembopay.initiatePayment(paymentData);
        res.redirect(result.payment_url);
    } catch (error) {
        res.status(500).json({ error: error.message });
    }
});

module.exports = TemboPayService;

# Python/Django Integration Service
import os
import requests
from django.conf import settings

class TemboPayService:
    def __init__(self):
        self.base_url = getattr(settings, 'TEMBOPAY_BASE_URL', 'https://tembopay.africa')
        self.environment = getattr(settings, 'TEMBOPAY_ENVIRONMENT', 'sandbox')  # sandbox or production
        self.merchant_key = getattr(settings, 'TEMBOPAY_MERCHANT_KEY')  # Use appropriate prefix
        self.api_key = getattr(settings, 'TEMBOPAY_API_KEY')  # Use appropriate prefix

    def initiate_payment(self, payment_data):
        try:
            headers = {
                'Content-Type': 'application/json',
                'X-Environment': self.environment,
                'X-Merchant-Key': self.merchant_key,
                'X-API-Key': self.api_key
            }

            response = requests.post(
                f"{self.base_url}/api/v1/initiate-payment",
                headers=headers,
                json=payment_data,
                timeout=30
            )

            response.raise_for_status()
            return response.json()

        except requests.RequestException as e:
            raise Exception(f'TemboPay API Error: {str(e)}')

    def verify_payment(self, transaction_id):
        try:
            headers = {
                'Accept': 'application/json',
                'X-Environment': self.environment,
                'X-Merchant-Key': self.merchant_key,
                'X-API-Key': self.api_key
            }

            response = requests.get(
                f"{self.base_url}/api/v1/verify-payment/{transaction_id}",
                headers=headers,
                timeout=30
            )

            response.raise_for_status()
            return response.json()

        except requests.RequestException as e:
            raise Exception(f'TemboPay API Error: {str(e)}')

# Django Settings Configuration
TEMBOPAY_BASE_URL = 'https://tembopay.africa'
TEMBOPAY_ENVIRONMENT = 'sandbox'  # Change to 'production' for live
TEMBOPAY_MERCHANT_KEY = os.environ.get('TEMBOPAY_MERCHANT_KEY')  # Use appropriate prefix
TEMBOPAY_API_KEY = os.environ.get('TEMBOPAY_API_KEY')  # Use appropriate prefix

# Django View Example
from django.shortcuts import redirect
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
import json

tembopay = TemboPayService()

@csrf_exempt
def initiate_payment(request):
    if request.method == 'POST':
        data = json.loads(request.body)
        
        payment_data = {
            'payment_amount': data['amount'],
            'currency_code': 'USD',
            'ref_trx': f'ORDER_{int(time.time())}',
            'description': data['description'],
            'success_redirect': request.build_absolute_uri('/payment/success/'),
            'cancel_redirect': request.build_absolute_uri('/payment/cancelled/'),
            'ipn_url': request.build_absolute_uri('/webhooks/tembopay/'),
            'allow_payment_methods': ['stripe', 'paypal'],
        }

        try:
            result = tembopay.initiate_payment(payment_data)
            return redirect(result['payment_url'])
        except Exception as e:
            return JsonResponse({'error': str(e)}, status=500)

# Environment Variables Setup
export TEMBOPAY_ENVIRONMENT="sandbox"  # or "production"
export TEMBOPAY_MERCHANT_KEY="test_merchant_your_key"  # or "merchant_your_key" for production
export TEMBOPAY_API_KEY="test_your_api_key"  # or "your_api_key" for production

# Initiate Payment
curl -X POST "https://tembopay.africa/api/v1/initiate-payment" \
  -H "Content-Type: application/json" \
  -H "X-Environment: $TEMBOPAY_ENVIRONMENT" \
  -H "X-Merchant-Key: $TEMBOPAY_MERCHANT_KEY" \
  -H "X-API-Key: $TEMBOPAY_API_KEY" \
  -d '{
    "payment_amount": 250.00,
    "currency_code": "USD",
    "ref_trx": "ORDER_12345",
    "description": "Premium Subscription",
    "success_redirect": "https://yoursite.com/payment/success",
    "cancel_redirect": "https://yoursite.com/payment/cancelled",
    "ipn_url": "https://yoursite.com/api/webhooks/tembopay",
    "allow_payment_methods": ["stripe", "paypal"]
  }'

# Verify Payment
curl -X GET "https://tembopay.africa/api/v1/verify-payment/TXNQ5V8K2L9N3XM1" \
  -H "Accept: application/json" \
  -H "X-Environment: $TEMBOPAY_ENVIRONMENT" \
  -H "X-Merchant-Key: $TEMBOPAY_MERCHANT_KEY" \
  -H "X-API-Key: $TEMBOPAY_API_KEY"

# Environment-specific credential examples:
# Sandbox: test_merchant_xxxxx, test_api_key_xxxxx
# Production: merchant_xxxxx, api_key_xxxxx