Créer un lien de paiement

Un lien génère une adresse de dépôt dédiée (ou une facture Lightning) et une page de paiement hébergée.

POST /payment-links

cURL

curl -X POST https://coinnectivepay-api-g34q.onrender.com/api/v1/payment-links \
  -H "Authorization: Bearer $CPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: cmd-2026-0001" \
  -d '{
    "reference": "CMD-0001",
    "amountUsdt": "25.500000",
    "network": "TRC20",
    "expiresInMinutes": 60
  }'

Node.js

const res = await fetch("https://coinnectivepay-api-g34q.onrender.com/api/v1/payment-links", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.CPAY_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "cmd-2026-0001",
  },
  body: JSON.stringify({
    reference: "CMD-0001",
    amountUsdt: "25.500000",
    network: "TRC20",
    expiresInMinutes: 60,
  }),
});
const { link, payment } = await res.json();

Réponse

{
  "link":    { "id": "9bf...", "reference": "CMD-0001", "status": "ACTIVE" },
  "payment": {
    "id": "59c...",
    "status": "PENDING",
    "network": "TRC20",
    "depositAddress": "TJ8...9f2c",
    "expectedAmount": "25.500000"
  }
}

Champs

Champ	Description
reference	Votre référence (commande, facture). Reprise dans les webhooks.
amountUsdt	Montant attendu en USDT, chaîne décimale (max 6 décimales).
expiresInMinutes	Durée de validité du lien, en minutes (optionnel).

Idempotency-Key

Fournissez un en-tête Idempotency-Key pour qu’un rejeu (timeout réseau) ne crée pas de doublon.