Intégration GoalPay

Prérequis

• Compte marchand GoalPay actif
• Token d’accès (commence toujours par TGP_)
• Un serveur capable d’envoyer des requêtes HTTP et de recevoir des webhooks

1. Créer une commande de paiement

Requête à envoyer depuis votre serveur (jamais depuis le navigateur) :

POST https://api.goalpay.pro/api/payement/service

{
  "description": "Commande #20201320",
  "access": "TGP_XXXXXXXXXXXXXXXXX",
  "reference": "CMD-20201320",
  "amount": 125000,
  "currency": "Ar",
  "metadata": [
    {
      "label": "T-shirt Premium",
      "unit_price": 75000,
      "quantity": 1,
    },
    {
      "label": "Frais de livraison",
      "unit_price": 50000,
      "quantity": 1
    }
  ]
}

metadata: [
  {
    "label": "T-shirt noir - Taille M",
    "unit_price": 45000,
    "quantity": 2,
  }
]

2. Réponse de GoalPay

{
  "message": "Success",
  "data": {
    "checkout_url": "https://goalpay.pro/payement/checkout/...",
    "expires_in_minutes": 10,
    "order_reference": "REF_74275670285582638"
  }
}

• Redirigez immédiatement le client vers checkout_url
• Le lien expire dans 10 minutes
• Stockez order_reference dans votre base de données

3. Webhook – Confirmation officielle du paiement

URLs à configurer dans votre espace marchand

• URL de succès : https://votredomaine.com/payment/success
• URL d’annulation : https://votredomaine.com/payment/canceled
• URL d’échec : https://votredomaine.com/payment/failed
• URL Webhook (obligatoire) : https://votredomaine.com/webhook/goalpay

{
  "event": "payment.success",
  "data": {
    "order_reference": "REF_74275670285582638",
    "reference": "PAN_1772716154773",
    "amount": 125000,
    "currency": "Ar",
    "description": "Panier 154773 - 1 article"
  }
}

{
  "event": "payment.failed",
  "data": {
    "order_reference": "REF_74275670285582638",
    "reference": "PAN_1772716154773",
    "amount": 125000,
    "currency": "Ar",
    "description": "Panier 154773 - 1 article",
    "error": "Fonds insuffisants"
  }
}

{
  "event": "payment.canceled",
  "data": {
    "order_reference": "REF_74275670285582638",
    "reference": "PAN_1772716154773",
    "amount": 125000,
    "currency": "Ar",
    "description": "Panier 154773 - 1 article",
    "error": "Paiement annulé"
  }
}

{
  "event": "payment.expired",
  "data": {
    "order_reference": "REF_74275670285582638",
    "reference": "PAN_1772716154773",
    "amount": 125000,
    "currency": "Ar",
    "description": "Panier 154773 - 1 article",
    "error": "Temps de paiement dépassé"
  }
}

Exemple webhook Node.js / Express (simple et sécurisé)

// Webhook GoalPay – Node.js + Express
const express = require("express");
const crypto = require("crypto");
const { db } = require("./db"); // Adapter selon ton projet
const { orders } = require("./schema"); // Adapter selon ton projet

const app = express();
app.use(express.json());

const WEBHOOK_SECRET = process.env.GOALPAY_WEBHOOK_SECRET;

if (!WEBHOOK_SECRET) {
  console.error("GOALPAY_WEBHOOK_SECRET manquant dans .env");
}

app.post("/webhook/goalpay", async (req, res) => {
  try {
    const signature = req.headers["x-gpay-signature"];
    const payload = req.body;

    if (!payload || !signature) {
      return res.status(400).send("Bad Request");
    }

    // Vérification HMAC
    const expected = crypto
      .createHmac("sha256", WEBHOOK_SECRET)
      .update(`${WEBHOOK_SECRET}`, "utf8")
      .digest("hex");

    if (signature !== expected) {
      return res.status(401).send("Invalid signature");
    }

    const { reference, amount, order_reference, curency, description } =
      payload.data || {};

    console.log("Event :", payload.event);
    console.log("Reference commande :", reference);
    console.log("GoalPay order reference :", order_reference);
    console.log("Montant :", amount);
    console.log("Devise :", curency);
    console.log("Description :", description);

    if (!order_reference) {
      return res.status(400).send("Missing order_reference");
    }

    // Trouver la commande
    const record = await db
      .select({ id: orders.id, status: orders.status })
      .from(orders)
      .where({ goalpayOrderRef: order_reference })
      .limit(1);

    if (!record.length) {
      console.warn(`Commande non trouvée pour order_reference ${order_reference}`);
      return res.status(404).send("Not found");
    }

    const currentOrder = record[0];

    // Déterminer le nouveau status
    let newStatus;
    switch (payload.event) {
      case "payment.success":
        newStatus = "success";
        break;
      case "payment.failed":
        newStatus = "failed";
        break;
      case "payment.canceled":
        newStatus = "canceled";
        break;
      case "payment.expired":
        newStatus = "expired";
        break;
      default:
        newStatus = currentOrder.status;
    }

    console.log(`Nouveau status : ${newStatus}`);

    // Mettre à jour si changement
    if (newStatus !== currentOrder.status) {
      await db.update(orders)
        .set({ status: newStatus })
        .where({ id: currentOrder.id });
    }

    res.status(200).json({ received: true, status: newStatus });
  } catch (err) {
    console.error("Erreur webhook GoalPay :", err);
    res.status(500).send("Internal Server Error");
  }
});

Processus de paiement en 3 étapes

1. 1.
   Votre serveur envoie une requête à l’API GoalPay avec le montant et la référence → reçoit un payment_link
2. 2.
   Vous redirigez le client vers ce lien (ou affichez le QR code)
3. 3.
   Dès que le client paye, GoalPay appelle votre webhook → vous mettez à jour la commande comme paid

C’est tout. Aucun code côté client. Paiement sécurisé et instantané.