SDKs & Librairies GeniusPay
Intégrez GeniusPay rapidement avec nos SDKs officiels pour vos plateformes préférées.
| SDK | Langage | Registry | Installation |
|---|---|---|---|
| Laravel | PHP | Packagist |
composer require geniuspay/laravel
|
| WordPress | PHP | WordPress.org | Télécharger le plugin |
| React | TypeScript | NPM |
npm install @geniuspay/react
|
| Flutter | Dart | pub.dev |
flutter pub add geniuspay_flutter
|
Laravel SDK
Installation
composer require geniuspay/laravelConfiguration
Publiez la configuration et lancez les migrations :
php artisan geniuspay:install
Ajoutez vos clés API dans le fichier
.env :
GENIUSPAY_API_KEY=pk_live_xxxxxxxxxxxx
GENIUSPAY_API_SECRET=sk_live_xxxxxxxxxxxx
GENIUSPAY_WEBHOOK_SECRET=whsec_xxxxxxxxxxxx
GENIUSPAY_SANDBOX=falseUtilisation
use GeniusPay\Laravel\Facades\GeniusPay;
// Créer un paiement
$payment = GeniusPay::createPayment([
'amount' => 5000,
'currency' => 'XOF',
'customer' => [
'email' => 'client@example.com',
'name' => 'Amadou Diallo',
],
'success_url' => route('payment.success'),
'error_url' => route('payment.error'),
]);
// Rediriger vers la page de paiement
return redirect($payment->paymentUrl);Webhooks
Écoutez les événements de paiement :
// app/Listeners/HandlePaymentCompleted.php
use GeniusPay\Laravel\Events\PaymentCompleted;
class HandlePaymentCompleted
{
public function handle(PaymentCompleted $event)
{
$payment = $event->payment;
$orderId = $event->getMetadata('order_id');
// Mettre à jour votre commande
Order::find($orderId)->markAsPaid();
}
}WordPress / WooCommerce
Installation
- Téléchargez le plugin depuis WordPress.org ou le dashboard GeniusPay
- Uploadez le fichier ZIP dans Extensions > Ajouter > Téléverser
- Activez le plugin
Configuration
- Allez dans WooCommerce > Paramètres > Paiements
- Activez GeniusPay
- Entrez votre Clé API et Clé Secrète
- Configurez l'URL du webhook dans votre dashboard GeniusPay
URL Webhook
https://votresite.com/?wc-api=geniuspay
Méthodes supportées
Wave
Orange Money
MTN Money
🔵 Moov Money
Carte bancaire
📺 Tutoriel vidéo
Suivez notre guide vidéo complet pour installer et configurer le plugin WordPress GeniusPay sur votre site WooCommerce.
React SDK
Installation
npm install @geniuspay/react
# ou
yarn add @geniuspay/reactConfiguration
import { GeniusPayProvider } from '@geniuspay/react';
function App() {
return (
<GeniusPayProvider
config={{
apiKey: 'pk_live_xxxxxxxxxxxx',
sandbox: false,
}}
>
<YourApp />
</GeniusPayProvider>
);
}Composants
PaymentButton
import { PaymentButton } from '@geniuspay/react';
<PaymentButton
amount={5000}
currency="XOF"
onSuccess={(payment) => console.log('Payé!', payment)}
onError={(error) => console.error(error)}
>
Payer maintenant
</PaymentButton>usePayment Hook
import { usePayment } from '@geniuspay/react';
function Checkout() {
const { pay, isLoading, error } = usePayment();
const handlePay = async () => {
await pay({
amount: 5000,
customer: { email: 'user@example.com' },
});
};
return <button onClick={handlePay}>Payer</button>;
}Flutter SDK
Installation
flutter pub add geniuspay_flutterInitialisation
import 'package:geniuspay_flutter/geniuspay_flutter.dart';
void main() {
GeniusPay.initialize(
GeniusPayConfig(
apiKey: 'pk_live_xxxxxxxxxxxx',
sandbox: false,
),
);
runApp(MyApp());
}Widgets
GeniusPayButton
GeniusPayButton(
amount: 5000,
currency: 'XOF',
customer: Customer(
email: 'user@example.com',
name: 'Amadou Diallo',
),
onSuccess: (payment) {
print('Paiement réussi: ${payment.reference}');
},
onError: (error) {
print('Erreur: ${error.message}');
},
)GeniusPaySheet
final payment = await GeniusPaySheet.show(
context,
amount: 10000,
description: 'Commande #123',
allowedMethods: [
PaymentMethod.wave,
PaymentMethod.orangeMoney,
PaymentMethod.card,
],
);
if (payment != null) {
print('Paiement initié: ${payment.reference}');
}Méthodes de paiement supportées
Wave
Mobile Money
Orange Money
Mobile Money
MTN Money
Mobile Money
🔵
Moov Money
Mobile Money
Carte bancaire
Visa & Mastercard
Besoin d'aide ?
Notre équipe technique est disponible pour vous accompagner dans votre intégration.