Démarrage
Créez votre compte, obtenez vos clés et effectuez votre premier paiement.
Prérequis
- Un compte marchand sur GerminoPay
- Connaissance de base des API HTTP/REST
- Un serveur HTTPS pour les webhooks (production)
Étape 1 : Créez votre compte
Inscrivez-vous et renseignez vos informations. Notre équipe valide votre compte sous 24h.
S'inscrireÉtape 2 : Obtenez vos clés API
Depuis votre tableau de bord, générez vos clés API :
Public Key— identifie votre compte dans chaque requêteSecret Key— signe vos requêtes (ne la partagez jamais)
Note de sécurité
La clé secrète n'est affichée qu'une seule fois. Stockez-la de manière sécurisée dans une variable d'environnement, jamais dans votre code source.
Étape 3 : Votre premier appel API
POST
https://api.germinopay.com/v1/paiement/initier
curl -X POST https://api.germinopay.com/v1/paiement/initier \
-H "Content-Type: application/json" \
-H "X-Public-Key: pk_live_votre_cle_publique" \
-H "X-Timestamp: 1730000000" \
-H "X-Signature: hmac_sha256_signature" \
-d '{
"montant": 5000,
"devise": "XOF",
"fournisseur": "cinetpay",
"reference": "CMD-1042",
"client_email": "client@example.com",
"return_url": "https://monsite.com/paiement/succes",
"cancel_url": "https://monsite.com/paiement/annule"
}'
200 OK
Réponse en cas de succès
{
"success": true,
"message": "Payment initiated",
"data": {
"reference": "GP-20251001-ABC123",
"transaction_id": "txn_9f8e7d6c5b4a",
"fournisseur": "cinetpay",
"montant": 5000,
"devise": "XOF",
"frais": 75,
"montant_net": 4925,
"statut": "initie",
"payment_url": "https://checkout.cinetpay.com/pay/GP-20251001-ABC123",
"expires_at": "2025-10-01T14:30:00Z",
"created_at": "2025-10-01T13:30:00Z"
}
}
Étape 4 : Configurez votre webhook
Un webhook est un POST HTTP envoyé à votre serveur quand le statut d'un paiement change. Configurez-le une fois dans votre tableau de bord et nous vous notifierons automatiquement.
Pourquoi utiliser les webhooks ?
Car les redirections peuvent être annulées par l'utilisateur. Les webhooks garantissent la livraison même si l'utilisateur ferme le navigateur.
Voir le guide complet → Webhooks