Démarrage
Créez votre compte, obtenez vos clés et effectuez votre premier paiement.
Prerequisites
- A merchant account on GerminoPay
- Basic knowledge of HTTP/REST APIs
- An HTTPS server for webhooks (production)
Step 1: Create your account
Sign up, fill in your business information. Our team validates your account within 24 hours.
Sign upStep 2: Get your API keys
From your dashboard, generate your API keys:
Public Key— identifies your account in every requestSecret Key— signs your requests (never share it)
Security note
The secret key is displayed only once. Store it securely in an environment variable, never in your source code.
Step 3: Your first API call
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
Success response
{
"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"
}
}
Step 4: Configure your webhook
A webhook is an HTTP POST sent to your server when a payment status changes. Configure it once in your dashboard and we'll notify you automatically.
Why use webhooks?
Because redirects can be cancelled by the user. Webhooks guarantee delivery even if the user closes the browser.
See the complete guide → Webhooks