asokawotulo/jokul-php

PHP client for Jokul API

2.0.0 2021-11-22 06:29 UTC

Requires

• php: >=7.2.0
• guzzlehttp/guzzle: >=6.0

Requires (Dev)

• phpunit/phpunit: ^8.5.13
• vlucas/phpdotenv: ^5.3

MIT

• Asoka Wotulo

README

This library is an abstraction of Jokul's API for applications written with PHP.

Table of Contents

• Links
• Installation
• Usage
  • Initialization
  • Generate Signature
  • Jokul Checkout

Links

• Main documentation
• Dashboard
  • Sandbox
  • Production

Installation

composer require asokawotulo/jokul-php

Usage

Initialization

Get the Client ID and Secret Key from Business Account > Service

use Jokul\Jokul;

Jokul::setClientId('MCH-xxxx-xxxxxxxxxxxxx');
Jokul::setSecretKey('SK-xxxxxxxxxxxxxxxxxxxx');
Jokul::setEnv(Jokul::PRODUCTION); // or Jokul::SANDBOX

Generate Signature

use Jokul\Jokul;
use Jokul\Utils;

$requestTarget = '/api/target';
$secretKey = Jokul::getSecretKey();
$clientId = Jokul::getClientId();
$requestId = Utils::generateRequestId();
$requestTimestamp = Utils::generateRequestTimestamp();

$signature = Utils::generateSignature(
	$secretKey,
	$clientId,
	$requestId,
	$requestTimestamp,
	$requestTarget,
);

Jokul Checkout

$checkoutData = [
	'order' => [
		'amount' => 20000,
		'invoice_number' => 'INV-123',
	],
	'payment' => [
		'payment_due_date' => 60
	]
];

$response = \Jokul\Checkout::create($checkoutData);

echo $response['payment']['url'];