Transactions
List, filter and consult every transaction from your merchant account.
List transactions
GET
https://api.germinopay.com/v1/transactions
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | int | 1 | Page number |
per_page | int | 20 | Items per page (max 100) |
statut | string | — | initie, en_cours, succes, echoue, rembourse |
fournisseur | string | — | paypal, cinetpay, fedapay, paydunya |
devise | string | — | Currency code |
date_from | date | — | ISO date (YYYY-MM-DD) |
date_to | date | — | ISO date (YYYY-MM-DD) |
reference | string | — | Exact match on reference |
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
}
}
}
Single transaction
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
| Status | Meaning |
|---|---|
| initie | Transaction created, waiting for the customer to pay. |
| en_cours | The provider is processing the payment. |
| succes | Payment successfully completed. Funds are credited to your balance. |
| echoue | Payment failed (insufficient funds, expired card, user cancel...). |
| rembourse | Transaction refunded to the customer. |