Foulgor Cash Portefeuille, transferts et pilotage cash
Connexion Créer un compte
đŸ§Ș Environnement : SANDBOX_CASH

Foulgor Cash · Sandbox Paiements

Interface unifiĂ©e pour piloter les 12 scĂ©narios d'erreur, suivre les requĂȘtes API en temps rĂ©el et copier des snippets curl / fetch / Guzzle prĂȘts Ă  l'emploi. Aucune donnĂ©e de production n'est touchĂ©e.

🎬 ScĂ©narios disponibles (12)

Cliquez sur une carte pour programmer le prochain appel API. Chaque scénario est consommé 1 seule fois puis retour au nominal (success).

Aucun scénario programmé
✓
success

SuccÚs (scénario nominal)

✕
insufficient_funds

Solde insuffisant

✕
validation_failure

Échec de validation

⏱
timeout_after_8s

Délai dépassé (8s)

✕
permission_denied

Permission refusée

✕
remote_500

Erreur serveur 500 cÎté partenaire

🔐
force_2fa_always

2FA obligatoire sur toutes opérations

🔐
force_2fa_never

2FA toujours ignorée (skipped=true)

🔐
otp_always_wrong

Code OTP systématiquement invalide

💾
refund

Remboursement automatique aprĂšs capture

💾
dispute

Litige initié

✕
reject_key

Toute clé API = 401 pendant cette session

📍 ScĂ©nario programmĂ© actuellement


Prochain appel API consommera
Scénario nominal (success)
— Aucun override —

📊 Statistiques 24 derniùres heures

Total req 24h
🔱
—
Auth réussies
✅
—
Erreurs / Refus
⚠
—
Latence P95 (ms)
⏱
—

📋 50 derniĂšres requĂȘtes

Date Method URI HTTP Latence Auth Key
🔇 Aucune requĂȘte Ă  afficher. Appelez un endpoint API Cash pour commencer.

đŸ§‘â€đŸ’» Snippets prĂȘts Ă  copier

💡 Remplacez fcs_0453d094ca03df1f396c par votre clĂ© sandbox rĂ©elle (prĂ©fixe fcs_). Le header X-Foulgor-Sandbox-Session permet d'isoler vos donnĂ©es.

🔑 Gestion des ClĂ©s API · Sandbox Foulgor Cash

Clés 100% isolées du LIVE · Préfixe fcs_ · Scopées par Session ID. Le api_secret n'est affiché qu'une seule fois à la création.

Nom Préfixe Key Env Permissions Statut Expire Créée Actions
💳 Aucune clĂ© sandbox pour cette session. Cliquez sur "GĂ©nĂ©rer une clĂ© sandbox" pour commencer.

đŸ›Ąïž Isolation forte : chaque Session ID voit uniquement ses propres clĂ©s. Les clĂ©s SANDBOX_CASH ne peuvent JAMAIS appeler les endpoints LIVE (gĂ©nĂ©rĂ©s via le tableau de bord production avec un endpoint diffĂ©rent).

📩 SDK Officiels Cash · TĂ©lĂ©chargement & Mode d'emploi

BibliothĂšques client prĂȘtes pour la production. Chaque SDK intĂšgre nativement la gestion des headers X-Foulgor-Sandbox-Session, la crĂ©ation de Payment Sessions et les scĂ©narios one-shot.

📚 CDN : cdn.foulgor.com/sdks/cash/
🧭

Mode d'emploi · Intégration Checkout en 3 étapes

  1. Téléchargez le SDK correspondant à votre stack (Composer / NPM / Pip) ou utilisez le lien direct du CDN.
  2. Initialisez le client avec votre clé sandbox fcs_... + secret fss_..., activez le mode sandbox: true + votre session_id.
  3. Programmez un scĂ©nario via client.sandbox.nextScenario("insufficient_funds") puis crĂ©ez une Payment Session — redirigez l'utilisateur vers checkout_url.

đŸ› ïž Maintenance & nettoyage

🔄

RĂ©initialiser TOUTE la session sandbox

Supprime TOUTES les données tables prefix sandbox_cash_* pour votre session ID. Action irréversible.

đŸ—‘ïž

Nettoyer données anciennes > 24h

Purge les lignes créées il y a plus de 24h. Bon pour la santé de la base.

📚 Endpoints JSON disponibles

MĂ©thode Route Nom Description
GET /sandbox/_api-keys ↗ Lister les clĂ©s Sandbox Cash ClĂ©s prĂ©fixĂ©es fcs_, scoped par session X-Foulgor-Sandbox-Session.
POST /sandbox/_api-keys Créer une clé Sandbox Génération key + secret (1 seule vue possible).
POST /sandbox/_api-keys/{id}/regenerate-secret Régénérer SECRET Ancien secret révocation immédiate.
POST /sandbox/_api-keys/{id}/revoke Révoquer une clé Désactivation irréversible.
GET /sandbox/_scenarios ↗ Liste scĂ©narios (12) ScĂ©narios programmĂ©s + courant.
POST /sandbox/_scenarios/next/{name} Programmer scénario suivant SuccÚs / insuffisant / 2FA obligatoire / litige etc.
POST /sandbox/_scenarios/reset Reset session sandbox Effacement tables sandbox_cash_* pour la session.
POST /sandbox/_scenarios/cleanup/older-than/{hours} Nettoyer anciennes sessions Purge sandbox_cash_* avec Ăąge > N heures.
GET /sandbox/_dashboard/overview ↗ Stats + 50 logs 24h : total succĂšs / Ă©checs + P95 latence.

🚀 Comment tester en 4 Ă©tapes

  1. 1

    Récupérez votre clé sandbox

    Générez une clé API sandbox (préfixe fcs_) depuis votre dashboard Cash ou utilisez fcs_0453d094ca03df1f396c comme placeholder.

  2. 2

    Choisissez un scénario

    Cliquez sur une carte ci-dessus pour programmer le prochain retour. Ex : 🔮 Solde insuffisant ou ⏱ DĂ©lai 8s.

  3. 3

    Appelez un endpoint

    Utilisez le snippet curl / fetch / Guzzle de la Section 5 en remplaçant la clé. Ex : POST /api/wallet.

  4. 4

    Observez le résultat

    Votre requĂȘte apparaitra en Section 4 (DerniĂšres requĂȘtes) sous 15s max, et les stats Section 3 se mettent Ă  jour.