Soldes

Consultez votre solde disponible pour chaque devise en temps réel.

Consulter les soldes

GET https://api.germinopay.com/v1/soldes
curl https://api.germinopay.com/v1/soldes \
  -H "X-Public-Key: pk_live_xxxx" \
  -H "X-Timestamp: 1730000000" \
  -H "X-Signature: hmac_sha256_signature"
<?php
$timestamp = time();
$signature = hash_hmac("sha256", "GET/v1/soldes" . $timestamp, $secretKey);

$ch = curl_init("https://api.germinopay.com/v1/soldes");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Public-Key: " . $publicKey,
        "X-Timestamp: " . $timestamp,
        "X-Signature: " . $signature,
    ],
]);

$data = json_decode(curl_exec($ch), true);
foreach ($data["data"]["soldes"] as $s) {
    echo $s["devise"] . " : " . $s["montant"] . PHP_EOL;
}
const path = '/v1/soldes';
const timestamp = Math.floor(Date.now() / 1000);
const signature = crypto
  .createHmac('sha256', process.env.GERMINOPAY_SECRET)
  .update(`GET${path}${timestamp}`)
  .digest('hex');

const res = await fetch(`https://api.germinopay.com${path}`, {
  headers: {
    'X-Public-Key': process.env.GERMINOPAY_PUBLIC,
    'X-Timestamp': timestamp,
    'X-Signature': signature,
  },
});
const data = await res.json();
data.data.soldes.forEach(s => console.log(s.devise, s.montant));
import hashlib, hmac, time, requests, os

path = "/v1/soldes"
timestamp = int(time.time())
message = f"GET{path}{timestamp}"
signature = hmac.new(
    os.environ["GERMINOPAY_SECRET"].encode(),
    message.encode(),
    hashlib.sha256
).hexdigest()

r = requests.get(
    f"https://api.germinopay.com{path}",
    headers={
        "X-Public-Key": os.environ["GERMINOPAY_PUBLIC"],
        "X-Timestamp": str(timestamp),
        "X-Signature": signature,
    }
)

for s in r.json()["data"]["soldes"]:
    print(s["devise"], s["montant"])

Réponse

200 OK
{
  "success": true,
  "data": {
    "soldes": [
      {
        "devise": "XOF",
        "montant": 145300,
        "montant_disponible": 145300,
        "montant_en_attente": 0,
        "symbole": "F CFA"
      },
      {
        "devise": "EUR",
        "montant": 2340.50,
        "montant_disponible": 2340.50,
        "montant_en_attente": 0,
        "symbole": "€"
      },
      {
        "devise": "USD",
        "montant": 1120.00,
        "montant_disponible": 900.00,
        "montant_en_attente": 220.00,
        "symbole": "$"
      }
    ],
    "devise_par_defaut": "XOF",
    "updated_at": "2025-10-01T15:00:00Z"
  }
}

Détail des champs

Champ Signification
montantSolde total (disponible + en attente).
montant_disponibleMontant que vous pouvez retirer immédiatement.
montant_en_attenteMontant des transactions en cours de traitement (non encore retirable).

Devises supportées

Code Nom Symbole Décimales
XOFFranc CFA (UEMOA)F CFA0
XAFFranc CFA (CEMAC)F CFA0
GNFGuinean FrancFG0
EUREuro€2
USDUS Dollar$2
NGNNigerian Naira₦2
GHSGhanaian Cedi₵2