Developer-Friendly API

Payment Gateway API for Developers

Integrate EPaySe through a RESTful API with HMAC-SHA256 request signing, webhooks, and a sandbox to test before you go live.

Start Building View Documentation

99.9%

API Uptime (status page)

SDKs Planned

Platform Plugin Available

Developer Support

Choose Your Integration Path

Start accepting payments in the way that works best for your stack.

Sandbox Quick Start

Get started with our RESTful API and make your first transaction in the sandbox

Quick Start Guide

SDKs Planned

PHP, JavaScript, and Python libraries are on the roadmap — the RESTful API works today, no SDK required

View API Reference

WooCommerce Plugin

Accept payments on WooCommerce with the EPaySe plugin, or integrate any other platform through the RESTful API

View Plugins

Simple, Powerful API

Clean, intuitive code that gets you up and running quickly.

<?php
$gateway   = 'https://gateway.epayse.com';
$apiKeyId  = getenv('EPAYSE_API_KEY_ID');
$secretKey = getenv('EPAYSE_SECRET_KEY');   // sk_test_... for sandbox

$path = 'api/v1/transaction/create';
$body = '{"ref":"ORDER-1001","amount":100.5,"currency":"USD","websiteUrl":"https://example.com","redirectUrl":"https://example.com/payment/success","cancelUrl":"https://example.com/payment/cancel","description":"Premium subscription - monthly","customerDetails":{"firstName":"John","lastName":"Doe","email":"[email protected]","country":"US","ip":"203.0.113.10","phoneCode":"US","phoneNumber":"5551234567"}}';
$timestamp = time();
$nonce = bin2hex(random_bytes(16));

$signature = hash_hmac('sha256', implode('|', ['POST', $path, $timestamp, $nonce, $body]), $secretKey);

$ch = curl_init($gateway . '/' . $path);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-Api-Key-Id: ' . $apiKeyId,
        'X-Signature: ' . $signature,
        'X-Timestamp: ' . $timestamp,
        'X-Nonce: ' . $nonce,
        'X-Signature-Version: 3',
    ],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($response['status'] ?? null) !== 'SUCCESS') {
    error_log('EPaySe error: ' . json_encode($response));
    exit(1);
}

// Redirect the customer to the checkout page
header('Location: ' . $gateway . $response['data']['checkoutUrl']);