Laravel ChapChap

Package Laravel pour intégrer l'API de paiement ChapChap (Guinée) par YoukeOfficial pour votre bonheur.

Installation

composer require youkeofficial/laravel-chapchap

Le ServiceProvider et la Facade sont enregistrés automatiquement via le package auto-discovery de Laravel.

Publie le fichier de configuration :

php artisan vendor:publish --tag=chapchap-config

Configuration

Ajoute ces variables dans ton .env :

CHAPCHAP_API_KEY=ta_cle_api
CHAPCHAP_ENCRYPT_KEY=ta_cle_hmac
CHAPCHAP_BASE_URL=https://chapchappay.com/api
CHAPCHAP_NOTIFY_URL=https://tonapp.com/payments/notify
CHAPCHAP_RETURN_URL=https://tonapp.com/payments/return
CHAPCHAP_CANCEL_URL=https://tonapp.com/payments/cancel

Utilisation

Via la Facade

use Youkeofficial\ChapChap\Facades\ChapChap;

// Créer un paiement
$result = ChapChap::requestPayment(
    amount: 10000,
    orderId: 'ORDER-123',
    description: 'Paiement commande #123'
);

// Rediriger l'utilisateur
return redirect($result['payment_url']);

Via l'injection de dépendances

use Youkeofficial\ChapChap\Services\ChapChapService;

class PaymentController extends Controller
{
    public function __construct(private ChapChapService $chapchap) {}

    public function create(): RedirectResponse
    {
        $result = $this->chapchap->requestPayment(
            amount: 10000,
            orderId: 'ORDER-123',
            description: 'Paiement commande #123'
        );

        return redirect($result['payment_url']);
    }
}

Vérifier un paiement

$data = ChapChap::requestVerification($operationId);

// Normaliser le statut vers : 'created' | 'processing' | 'success' | 'cancel' | 'error'
$status = ChapChap::normalizeChapChapStatus($data['status']['code']);

Méthodes disponibles

Tests

composer install
vendor/bin/phpunit

Licence

MIT