Transactions
Listez, filtrez et consultez toutes les transactions de votre compte marchand.
Lister les transactions
GET
https://api.germinopay.com/v1/transactions
Paramètres de requête
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
page | int | 1 | Numéro de page |
per_page | int | 20 | Éléments par page (max 100) |
statut | string | — | initie, en_cours, succes, echoue, rembourse |
fournisseur | string | — | paypal, cinetpay, fedapay, paydunya |
devise | string | — | Code devise |
date_from | date | — | Date ISO (YYYY-MM-DD) |
date_to | date | — | Date ISO (YYYY-MM-DD) |
reference | string | — | Correspondance exacte sur la référence |
curl "https://api.germinopay.com/v1/transactions?statut=succes&per_page=50&date_from=2025-10-01" \ -H "X-Public-Key: pk_live_xxxx" \ -H "X-Timestamp: 1730000000" \ -H "X-Signature: hmac_sha256_signature"
200 OK
{
"success": true,
"data": {
"transactions": [
{
"reference": "GP-20251001-ABC123",
"transaction_id": "txn_9f8e7d6c5b4a",
"fournisseur": "cinetpay",
"montant": 5000,
"devise": "XOF",
"frais": 75,
"montant_net": 4925,
"statut": "succes",
"client_email": "client@example.com",
"created_at": "2025-10-01T13:30:00Z",
"paid_at": "2025-10-01T13:32:15Z"
}
],
"pagination": {
"page": 1,
"per_page": 50,
"total": 127,
"total_pages": 3
}
}
}
Transaction unique
GET
https://api.germinopay.com/v1/transactions/{reference}
200 OK
{
"success": true,
"data": {
"reference": "GP-20251001-ABC123",
"transaction_id": "txn_9f8e7d6c5b4a",
"fournisseur": "cinetpay",
"montant": 5000,
"devise": "XOF",
"frais": 75,
"montant_net": 4925,
"statut": "succes",
"client_email": "client@example.com",
"client_nom": "Kossi Amegan",
"metadata": {
"commande_id": 1042,
"source": "web"
},
"created_at": "2025-10-01T13:30:00Z",
"updated_at": "2025-10-01T13:32:15Z",
"paid_at": "2025-10-01T13:32:15Z"
}
}
Statuts
| Statut | Signification |
|---|---|
| initie | Transaction créée, en attente du paiement du client. |
| en_cours | Le fournisseur traite le paiement. |
| succes | Paiement réussi. Les fonds sont crédités sur votre solde. |
| echoue | Paiement échoué (fonds insuffisants, carte expirée, annulation...). |
| rembourse | Transaction remboursée au client. |