API Reference.

use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://sandbox-api.gbemidebe.com',
    'headers'  => [
        'Authorization' => 'Bearer ' . $apiKey,
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
]);

$response = $client->post('/api/v1/sdk/init', [
    'json' => [
        'country'         => 'NG',
        'currency'        => 'NGN',
        'purchase_amount' => 50000,
    ],
]);

$body = json_decode($response->getBody(), true);
$sessionToken = $body['data']['gbemidebe_session_token'];
$entryFee     = $body['data']['entry_fee'];

// Store $sessionToken in your session / checkout state
// Display $entryFee to the customer with the compliance_text

const response = await fetch(
  'https://sandbox-api.gbemidebe.com/api/v1/sdk/init',
  {
    method:  'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type':  'application/json',
      'Accept':        'application/json',
    },
    body: JSON.stringify({
      country:          'NG',
      currency:         'NGN',
      purchase_amount:  50000,
    }),
  }
);

const { data } = await response.json();
const { gbemidebe_session_token, entry_fee, compliance_text } = data;

// Persist session token; show entry_fee + compliance_text to user

$response = $client->post('/api/v1/sdk/entry', [
    'json' => [
        'gbemidebe_session_token' => $sessionToken,
        'transaction_id'          => 'TXN-20251201-0001',
        'flow_type'               => 'psp_customer',
        'customer_token'          => $customerId,
        'customer_ip'             => $request->ip(),
        'customer_user_agent'     => $request->userAgent(),
        'reference'               => $orderId,
        'metadata'                => ['order_id' => $orderId],
    ],
]);

$entry = json_decode($response->getBody(), true)['data'];
$entryId = $entry['entry_id'];

// Pass $entryId to your payment gateway as metadata
// e.g. Paystack: "gbemidebe_entry_id" => $entryId

const res = await fetch(
  'https://sandbox-api.gbemidebe.com/api/v1/sdk/entry',
  {
    method:  'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type':  'application/json',
      'Accept':        'application/json',
    },
    body: JSON.stringify({
      gbemidebe_session_token: sessionToken,
      transaction_id:          'TXN-20251201-0001',
      flow_type:               'psp_customer',
      customer_token:          customerId,
      customer_ip:             req.ip,
      customer_user_agent:     req.headers['user-agent'],
      reference:               orderId,
      metadata:                { order_id: orderId },
    }),
  }
);

const { data } = await res.json();
const { entry_id } = data;

// Forward entry_id to your payment gateway metadata

try {
    // Run your payment gateway charge
    $charge = $gateway->charge([
        'amount'   => $totalAmount,
        'metadata' => ['gbemidebe_entry_id' => $entryId],
    ]);

    // Confirm success
    $client->post('/api/v1/sdk/entry/confirm', [
        'json' => [
            'transaction_id'  => $transactionId,
            'payment_status'  => 'success',
            'failure_reason'  => null,
        ],
    ]);
} catch (\Exception $e) {
    // Confirm failure — always call, even on error
    $client->post('/api/v1/sdk/entry/confirm', [
        'json' => [
            'transaction_id'  => $transactionId,
            'payment_status'  => 'failed',
            'failure_reason'  => $e->getMessage(),
        ],
    ]);
    throw $e;
}

async function confirmEntry(transactionId, status, reason = null) {
  return fetch(
    'https://sandbox-api.gbemidebe.com/api/v1/sdk/entry/confirm',
    {
      method:  'POST',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type':  'application/json',
        'Accept':        'application/json',
      },
      body: JSON.stringify({
        transaction_id:  transactionId,
        payment_status:  status,
        failure_reason:  reason,
      }),
    }
  );
}

try {
  const charge = await processPayment(totalAmount, { gbemidebe_entry_id: entryId });
  await confirmEntry(transactionId, 'success');
} catch (err) {
  await confirmEntry(transactionId, 'failed', err.message);
  throw err;
}