API Fidepay.

Currencies

Devises supportées par Fidepay (10 devises actives).

Obtain API Key

1. Connecte-toi à ton compte commerçant : merchant.fide-pay.com
2. Va dans Merchant App → API Access Key.
3. Tu trouveras ta Public Key et ta Secret Key.
4. Bouton Regenerate pour générer de nouvelles clés à tout moment.

⚠️ Garde ces clés privées. Ne les partage jamais et ne les exposes jamais côté frontend.

Subscriptions — 3 modes d'intégration

Une fois ton plan créé via POST /merchant/plans, FidePay te donne un plan_id. Tu as ensuite 3 manières de proposer l'abonnement à tes clients.

1. Lien partagé (le plus simple)

Partage l'URL publique. Idéal pour newsletters, sales pages, in-app banners. Aucun code requis.

<a href="https://admin.fide-pay.com/subscribe/PLAN_ID">
  S'abonner — 9.99€/mois
</a>

2. Iframe embed

Place le formulaire d'abonnement directement dans ta page. La carte reste chez FidePay (PCI-DSS géré). Compatible avec tout site HTTPS.

<iframe
  src="https://admin.fide-pay.com/subscribe/PLAN_ID"
  width="500"
  height="720"
  style="border:0; border-radius:14px;"
  allow="payment"
></iframe>

3. SDK overlay (style Stripe Checkout)

Un bouton, une modale overlay. La page principale reste fluide, le callback onSuccess te donne le token d'abonnement directement en JS. C'est l'option recommandée pour les SPAs.

<button id="sub-btn">S'abonner — 9.99€/mois</button>

<script src="https://admin.fide-pay.com/js/fidepay.umd.min.js"></script>
<script>
  const fp = new Fidepay("YOUR_PUBLIC_KEY");
  document.getElementById("sub-btn").addEventListener("click", () => {
    fp.subscribe({
      planId: 1,
      mode: "overlay",
      onSuccess: (data) => {
        console.log("Sub actif", data.publicToken);
        // data.publicToken = "sub_xxx"
        // data.firstInvoice = { amount, currency, status: "paid" }
      },
      onClose: () => console.log("user fermé"),
      onError: (err) => console.error(err),
    });
  });
</script>

4. Webhook IPN (côté serveur)

Configure ton URL webhook dans merchant.fide-pay.com/dashboard/subscriptions. FidePay POST sur cette URL à chaque évènement :

• subscription.created — premier signup, carte sauvée
• invoice.paid — prélèvement réussi (1er ou récurrent)
• invoice.failed — carte refusée → statut past_due
• subscription.canceled — annulation manuelle

Signature HMAC SHA-256 dans le body : signature = hash_hmac("sha256", public_token + event + invoice_id, secret_key)

Access Token POST

Le token d'accès est requis pour faire des requêtes de paiement via l'API. Génère-le avec ta public_key et inclus-le dans le header Authorization de chaque appel suivant.

use Illuminate\Support\Facades\Http;

$url = 'https://admin.fide-pay.com/api/merchant/access-token';
$publicKey = 'your_public_key';

$response = Http::withHeaders([
    'Content-Type' => 'application/json'
])->post($url, [
    'public_key' => $publicKey,
]);

if ($response->successful()) {
    return response()->json($response->json());
} else {
    return response()->json($response->json());
}

Example Response Success 200

{
    "status": "success",
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOi...",
    "expires_at": "2026-05-10T08:00:00Z"
}

Example Response Error (400/401)

// Token invalid or expired (401)
{
    "status": "error",
    "message": "Token is invalid or expired"
}

// Validation error (400)
{
    "status": "error",
    "message": ["The public key is required."]
}

Make Payment POST

Initie une transaction de paiement. Le client est ensuite redirigé sur la page de paiement Fidepay. Quand le paiement est confirmé, ton ipn_url reçoit un IPN signé HMAC.

$url = 'https://admin.fide-pay.com/api/merchant/make-payment';
$authToken = 'your_authorization_token_here';

$data = [
    'amount' => 100.00,
    'currency' => 'EUR',
    'transaction_id' => 'TX2026000001',
    'description' => 'Test payment',
    'ipn_url' => 'https://yourdomain.com/ipn',
    'callback_url' => 'https://yourdomain.com/callback',
    'customer_name' => 'Joel Dupont',
    'customer_email' => 'joel@example.com',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $authToken,
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $r = json_decode($response, true);
    print_r($r);
} else {
    echo 'Error: ' . $httpCode . PHP_EOL;
    echo $response;
}

Example Response Success 200

{
    "status": "success",
    "data": {
        "tnx": "TRX4MEBJSUPQB",
        "payment_url": "https://admin.fide-pay.com/pay/TRX4MEBJSUPQB",
        "amount": 100.00,
        "charge": 3.50,
        "final_amount": 103.50
    }
}

Example Response Error (400/401)

// Token invalid or expired (401)
{
    "status": "error",
    "message": "Token is invalid or expired"
}

// Validation error (400)
{
    "status": "error",
    "message": ["The transaction id has already been taken."]
}

Transfer wallet-to-wallet POST

Envoie des fonds depuis ton wallet Fidepay vers un autre user Fidepay. Idempotent via le champ reference (2 appels avec la même reference = un seul transfer).

$url = 'https://admin.fide-pay.com/api/merchant/transfer';
$authToken = 'your_authorization_token';

$data = [
    'to_merchant_user_id' => 87,
    'amount' => 90.00,
    'currency' => 'EUR',
    'reference' => 'PC-' . bin2hex(random_bytes(16)),
    'description' => 'Vente Vandy — Guide Forex',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $authToken,
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($response['data']['idempotent_replay']) {
    // Déjà transféré, pas un nouveau
} else {
    // Nouveau transfer réussi
}
print_r($response);

Example Response Success 200

{
    "status": "success",
    "data": {
        "transfer_id": 753,
        "tnx": "TRXMZGLE6JKJ5",
        "reference": "PC-...",
        "status": "completed",
        "amount": 90.00,
        "currency": "EUR",
        "from_balance_remaining": 1234.56,
        "recipient": {
            "user_id": 87,
            "name": "Vandy Shop"
        },
        "idempotent_replay": false,
        "completed_at": "2026-05-09 08:30:00"
    }
}

Example Response Error (400/401)

// Solde insuffisant (422)
{
    "status": "error",
    "message": "Insufficient balance",
    "errors": {
        "code": "INSUFFICIENT_BALANCE",
        "balance": 50.00,
        "required": 90.00
    }
}

// Reference déjà utilisée avec params différents (422)
{
    "status": "error",
    "message": "Reference already used with different parameters",
    "errors": { "code": "REFERENCE_CONFLICT" }
}

Lookup utilisateur GET

Vérifie l'existence d'un utilisateur Fidepay avant de lui transférer. Réservé aux comptes plateforme. Au moins un des 3 query params requis.

$authToken = 'your_authorization_token';
$email = 'marchand@example.com';

$url = 'https://admin.fide-pay.com/api/merchant/lookup?email=' . urlencode($email);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $authToken,
    'Accept: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($response['status'] === 'success') {
    echo "Trouvé : " . $response['data']['business_name'];
}

Example Response Success 200

{
    "status": "success",
    "data": {
        "user_id": 87,
        "email": "marchand@example.com",
        "username": "vandy",
        "account_number": "3763363055",
        "business_name": "Vandy Shop",
        "currency_default": "EUR",
        "verified": true,
        "active": true,
        "is_merchant": true
    }
}

Example Response Error (400/401)

// User pas trouvé (404)
{
    "status": "error",
    "message": "User not found",
    "errors": { "code": "USER_NOT_FOUND" }
}

// Pas le compte plateforme (403)
{
    "status": "error",
    "message": "Only the platform admin can perform user lookups",
    "errors": { "code": "FORBIDDEN_NON_PLATFORM" }
}

Subscriptions — Create plan POST

Crée un plan d'abonnement récurrent. Une fois créé, partage le lien public /subscribe/{plan_id} avec tes clients. Stripe sauvegarde leur carte, FidePay prélève chaque période automatiquement (1% commission par prélèvement).

$url = 'https://admin.fide-pay.com/api/merchant/plans';
$authToken = 'your_authorization_token_here';

$data = [
    'name' => 'Plan Pro mensuel',
    'amount' => 9.99,
    'currency' => 'EUR',
    'interval' => 'month',
    'interval_count' => 1,
    'trial_days' => 7,
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $authToken,
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

// Le lien à partager avec ton client :
echo 'https://admin.fide-pay.com/subscribe/' . $response['data']['id'];

Example Response Success 200

{
    "status": "success",
    "data": {
        "id": 1,
        "name": "Plan Pro mensuel",
        "amount": "9.99000000",
        "currency": "EUR",
        "interval": "month",
        "interval_count": 1,
        "trial_days": 7,
        "status": "active",
        "subscribe_url": "https://admin.fide-pay.com/subscribe/1"
    }
}

Example Response Error (400/401)

// Validation error (400)
{
    "status": "error",
    "message": ["The amount must be at least 0.01."]
}

Subscriptions — List subscribers GET

Liste tous tes abonnés. Filtrage par statut possible.

$url = 'https://admin.fide-pay.com/api/merchant/subscriptions?status=active';
$authToken = 'your_authorization_token';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $authToken,
    'Accept: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($response['data'] as $sub) {
    echo $sub['customer_email'] . ' — ' . $sub['status'] . PHP_EOL;
}

Example Response Success 200

{
    "status": "success",
    "data": [
        {
            "id": 3,
            "public_token": "sub_QnX2fRjpxh8O8PqUuXSe1PZb",
            "plan": { "name": "Plan Pro mensuel", "amount": "9.99", "currency": "EUR" },
            "customer_email": "client@example.com",
            "status": "active",
            "mode": "live",
            "current_period_end": "2026-06-30T11:39:34Z"
        }
    ]
}

Example Response Error (400/401)

// Auth invalide (401)
{
    "status": "error",
    "message": "Unauthenticated."
}

Subscriptions — Cancel POST

Annule un abonnement. Le client ne sera plus prélevé à la prochaine période. L'abonnement reste actif jusqu'à la fin de la période en cours.

$id = 3;
$url = "https://admin.fide-pay.com/api/merchant/subscriptions/{$id}/cancel";
$authToken = 'your_authorization_token';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $authToken,
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

Example Response Success 200

{
    "status": "success",
    "data": {
        "id": 3,
        "status": "canceled",
        "canceled_at": "2026-05-30T12:00:00Z"
    }
}

Example Response Error (400/401)

// Subscription pas trouvée (404)
{
    "status": "error",
    "message": "Subscription not found"
}

IPN (notification webhook) POST

Quand un paiement est confirmé, Fidepay envoie un POST vers ton ipn_url avec un payload signé HMAC SHA-256. Tu dois répondre HTTP 200 pour acknowledge sinon Fidepay retentera 5 fois.

// Vérification IPN côté merchant
$secretKey = 'your_secret_key_here';
$data = $_POST['data'] ?? [];
$receivedSignature = $_POST['signature'] ?? '';

// Recréer la signature
$dataToHash = $data['transaction_id'] . $data['total_amount'];
$generatedSignature = hash_hmac('sha256', $dataToHash, $secretKey);

// Vérifier
if (hash_equals($generatedSignature, $receivedSignature)) {
    // Signature valide → traiter le paiement
    $tnxId = $data['transaction_id'];
    $amount = $data['total_amount'];
    // Marque la commande comme payée dans ta BDD
    http_response_code(200);
    echo 'OK';
} else {
    // Signature invalide → ne PAS traiter
    http_response_code(403);
    echo 'Invalid signature';
}

FidePay sur Shopify

Shopify ne permet pas d'installer des plugins PHP comme WooCommerce. La méthode recommandée pour intégrer FidePay consiste à ajouter le SDK browser dans ton thème et appeler fp.checkout() ou fp.subscribe() depuis tes pages produit. Aucune app Shopify à publier.

1. Ajoute le SDK au thème

Dans Shopify Admin : Online Store → Themes → Edit code. Ouvre layout/theme.liquid et ajoute juste avant </head> :

<script src="https://admin.fide-pay.com/js/fidepay.umd.min.js" defer></script>

2. Crée tes plans FidePay (une fois)

Va sur merchant.fide-pay.com/dashboard/subscriptions et crée un plan par offre récurrente. Note le plan_id (entier) pour chaque plan.

3. Page produit : bouton "S'abonner"

Édite sections/main-product.liquid (ou templates/product.liquid) et ajoute le bouton là où tu veux :

{% if product.metafields.fidepay.plan_id %}
  <button type="button" id="fidepay-sub-{{ product.id }}"
    style="width:100%;padding:14px;background:#ff4600;color:#fff;border:0;border-radius:10px;font-size:16px;font-weight:600;cursor:pointer;margin-top:12px;">
    S'abonner — {{ product.price | money }}
  </button>

  <script>
    document.getElementById("fidepay-sub-{{ product.id }}").addEventListener("click", function() {
      const fp = new Fidepay("{{ shop.metafields.fidepay.public_key }}");
      fp.subscribe({
        planId: {{ product.metafields.fidepay.plan_id }},
        mode: "overlay",
        onSuccess: function(data) {
          // Optionnel : POST vers /apps/fidepay-webhook si tu as un endpoint custom
          window.location.href = "/pages/merci?ref=" + data.publicToken;
        },
        onClose: function() {},
        onError: function(err) { alert("Erreur : " + err.message); },
      });
    });
  </script>
{% endif %}

4. Lie chaque produit à un plan FidePay

Pour chaque produit récurrent : Settings → Custom data → Products → ajoute un champ Metafield fidepay.plan_id (type Integer). Puis dans chaque produit (édition du produit en bas de page), renseigne le plan_id FidePay.

Pour la public_key globale : Settings → Custom data → Shop → ajoute Metafield fidepay.public_key (type Single line text) et colle ta clé.

5. Paiement ponctuel (panier classique)

Shopify a déjà sa propre passerelle de checkout. Pour ajouter FidePay comme option supplémentaire, le plus simple est un bouton "Pay with FidePay" sur la page panier :

<button type="button" id="fidepay-checkout-btn"
  style="margin-top:12px;width:100%;padding:14px;background:#ff4600;color:#fff;border:0;border-radius:10px;font-weight:600;">
  Payer avec FidePay ({{ cart.total_price | money }})
</button>

<script>
  document.getElementById("fidepay-checkout-btn").addEventListener("click", async function() {
    const fp = new Fidepay("{{ shop.metafields.fidepay.public_key }}");
    const session = await fp.create({
      amount: {{ cart.total_price | divided_by: 100.0 }},
      currency: "{{ cart.currency.iso_code }}",
      description: "Order {{ cart.token }}",
      allowedDomains: [location.origin],
      returnUrl: location.origin + "/pages/merci",
    });
    fp.checkout({
      sessionToken: session.sessionToken,
      mode: "overlay",
      onSuccess: function(data) { window.location.href = "/pages/merci?tnx=" + data.transactionRef; },
      onError: function(err) { alert("Erreur : " + err.message); },
    });
  });
</script>

6. Webhook IPN (côté Shopify Apps proxy ou backend custom)

Shopify ne sait pas recevoir directement les webhooks FidePay. Tu as 2 options :

• App proxy Shopify : crée une mini app Shopify en Node.js qui expose /apps/fidepay/webhook, valide la signature HMAC, puis crée/met à jour des Orders Shopify via Admin API. Plus de doc sur shopify.dev/apps/app-proxies.
• Backend externe : héberge un petit script (Vercel Function, Cloudflare Worker, Railway…) qui reçoit le webhook FidePay et appelle Shopify Admin API pour créer des commandes. Plus rapide à mettre en place.

Pour démarrer simple : laisse le webhook FidePay enregistrer juste les paiements côté FidePay (visibles dans ton dashboard merchant). Tu réconcilies manuellement avec les commandes Shopify. Pour le full automatique, prends le temps de coder l'app proxy.

Plugins CMS

Pour les marchands qui veulent encaisser sur leur site existant sans coder, on fournit des plugins prêts à installer.

Installation

1. Dans WP Admin : Plugins → Add New → Upload Plugin
2. Sélectionne fidepay-for-woocommerce-1.0.0.zip → Install → Activate
3. Va dans WooCommerce → Settings → Payments → FidePay
4. Renseigne ta Public Key et Secret Key
5. Copie l'URL Webhook affichée et colle-la dans merchant.fide-pay.com/dashboard/subscriptions

Plugins prévus (bientôt)

• Shopify (via Stripe Connect proxy)
• Drupal Commerce