JJuma Global logo Developer Docs
JJuma Pay Documentation

Integration Guides

This section shows a complete PHP integration flow that matches the existing Jjuma Pay API rules, webhook headers, and response format.

Integration Guides

Security Never expose your Secret API Key or Webhook Secret in HTML, browser JavaScript, frontend applications, mobile applications, or public repositories. Keep protected credentials on your server.

This section shows a complete PHP integration flow that matches the existing Jjuma Pay API rules, webhook headers, and response format.

Server requirements

  • PHP 7.4 or newer
  • PHP cURL and PHP JSON extensions
  • HTTPS with a valid SSL certificate
  • A public webhook URL
  • Access to your merchant database
  • PHP 8.1 or newer is recommended

Credential types

  • Public API Key: use it for the create-payment request from your server-side checkout flow.
  • Secret API Key: keep it on the server for backend verification and transaction lookup.
  • Webhook Secret: use it only to verify JJuma webhook signatures on your server.

File structure

  • config.php
  • jjuma-client.php
  • pay.php
  • success.php
  • cancel.php
  • webhook.php