Errors

{
    "status": "error",
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid or has been revoked.",
    "param": null
}

// --- Creating checkout ---
let checkoutUrl: string;

try {
    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_${orderId}_attempt_1`,
                'Content-Type': 'application/json',
            },
            body: JSON.stringify({
                type: 'checkout',
                amount: 5000,
                currency: 'GHS',
                recipient: { name: 'Jane Doe', email: 'jane@example.com' },
                redirect_url: 'https://yourapp.com/payment/callback',
                meta: { orderId },
            }),
        },
    );

    const payload = await response.json();

    if (!response.ok || !payload.success) {
        console.error('[Seev] Checkout failed:', payload);
        return res
            .status(400)
            .json({ error: 'Could not initiate payment. Please try again.' });
    }

    checkoutUrl = payload.data.checkout_url;
} catch (error) {
    if (error instanceof Error) {
        // Log the raw message for debugging
        console.error('[Seev] Checkout request failed:', error.message);

        // Return a generic message to the client — never expose raw API errors
        return res
            .status(500)
            .json({ error: 'Could not initiate payment. Please try again.' });
    }
}

// --- Verifying the result after redirect ---
try {
    const response = await fetch(
        `https://api.seevplus.com/api/v1/developer/payments/${encodeURIComponent(sessionRef)}`,
    );
    const result = await response.json();
    const status = result?.data?.status;

    if (status === 'completed' || status === 'success') {
        // Fulfil the order
    } else {
        // Payment declined — prompt the user to retry
        return res.status(400).json({ error: 'Payment was not completed.' });
    }
} catch (error) {
    if (error instanceof Error) {
        console.error('[Seev] Verification error:', error.message);
        return res
            .status(400)
            .json({ error: 'Could not verify this payment.' });
    }
}

switch (errorCode) {
    case 'CHARGE_FAILED':
        return 'Your payment was declined. Please try a different payment method.';
    case 'CHARGE_EXPIRED':
        return 'Your payment session timed out. Please start again.';
    default:
        return 'Something went wrong. Please try again or contact support.';
}