adwapay / adwapay-php

v1.1.0 2026-08-17 05:05 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *

MIT

• ADWAPAY

• payment
• webhook
• mobile money
• Orange Money
• mtn momo
• Cameroon
• xaf
• adwapay

Published on Packagist.org on 2026-08-17 05:06 UTC

README

SDK marchand ADWAPAY (PHP ≥ 7.4) pour encaisser par Mobile Money au Cameroun (Orange Money, MTN MoMo…). Merchant SDK for accepting Mobile Money payments via ADWAPAY.

Installation

composer require adwapay/adwapay-php

Usage

use Adwapay\AdwapayClient;
use Adwapay\Webhook;

$adwapay = new AdwapayClient(
    'https://apiv05.adwapay.com',
    getenv('ADWAPAY_MERCHANT_KEY'),
    getenv('ADWAPAY_SUBSCRIPTION_KEY'),
    getenv('ADWAPAY_APPLICATION')
);

// Lien de paiement / payment link
$link = $adwapay->createPaymentLink(['amount' => 5000, 'orderRef' => 'CMD-42']);
// → redirigez le client vers $link['url']

// Remboursement / refund
$adwapay->createRefund(['footprint' => $fp, 'amount' => 1500, 'idempotencyKey' => 'r-42']);

// Abonnements / subscriptions
$plan = $adwapay->createSubscriptionPlan(['name' => 'Pro', 'amount' => 2000, 'intervalDays' => 30]);
$adwapay->createSubscription(['planId' => $plan['planId'], 'customerMsisdn' => '6XXXXXXXX', 'meanCode' => 'ORANGE-MONEY']);

// Vérifier un webhook (corps BRUT requis) / verify a webhook (RAW body)
$raw = file_get_contents('php://input');
$ok = Webhook::verify(
    getenv('ADWAPAY_WEBHOOK_SECRET'),
    $raw,
    $_SERVER['HTTP_X_ADWAPAY_SIGNATURE'] ?? null,
    $_SERVER['HTTP_X_ADWAPAY_TIMESTAMP'] ?? null
);

Capacités / capabilities

• createPaymentLink / getPaymentLinkStatus
• createRefund / listRefunds
• createSubscriptionPlan / listSubscriptionPlans / createSubscription / listSubscriptions / cancelSubscription
• Webhook::verify / Webhook::sign — signature HMAC-SHA256, temps constant, anti-rejeu 5 min

Tests

php test/webhook-test.php

Devise / currency

XAF (Franc CFA) — montants entiers / integer amounts.

Licence

MIT.