Démarrage

ZyndPay Référence API

{
  "success": true,
  "data": { ... },
  "message": "optional string",
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}

Démarrage

Authentification

Incluez votre clé API dans l'en-tête X-Api-Key à chaque requête. Vous pouvez aussi la passer comme jeton Bearer dans l'en-tête Authorization.

curl https://api.zyndpay.io/v1/payin \
  -H "X-Api-Key: zyp_live_sk_..."

Les préfixes de clés API vous permettent d'identifier le type de clé d'un coup d'œil :

Démarrage

Démarrage Rapide

Créez votre premier paiement en trois étapes — aucun SDK requis, juste une seule requête HTTP.

Encaissements

Créer un Encaissement

Génère une adresse de portefeuille TRON unique pour que votre client y envoie des USDT. L'adresse expire après expiresInSeconds secondes (par défaut 1 heure).

Corps de la requête

curl -X POST https://api.zyndpay.io/v1/payin \
  -H "X-Api-Key: zyp_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "externalRef": "order_123",
    "expiresInSeconds": 3600,
    "successUrl": "https://yoursite.com/payment/success",
    "cancelUrl": "https://yoursite.com/payment/cancel"
  }'

{
  "success": true,
  "data": {
    "id": "cma1xyz8f0001yx5k9abc1234",
    "depositAddress": "TRXabc123def456ghi789jkl",
    "amount": "100.00",
    "status": "PENDING",
    "externalRef": "order_123",
    "expiresAt": "2026-03-06T12:00:00.000Z",
    "createdAt": "2026-03-06T11:00:00.000Z"
  }
}

Récupérer un Encaissement

Récupère un seul encaissement par son ID.

{
  "success": true,
  "data": {
    "id": "cma1xyz8f0001yx5k9abc1234",
    "depositAddress": "TRXabc123def456ghi789jkl",
    "amount": "100.00",
    "amountReceived": "100.00",
    "fee": "3.00",
    "netAmount": "97.00",
    "status": "CONFIRMED",
    "txHash": "abc123def456...",
    "externalRef": "order_123",
    "confirmedAt": "2026-03-06T11:01:02.000Z",
    "createdAt": "2026-03-06T11:00:00.000Z"
  }
}

Statuts de paiement

Lister les Encaissements

Retourne une liste paginée d'encaissements, les plus récents en premier.

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 134,
    "totalPages": 7
  }
}

Liens de Paiement

Créer un Lien de Paiement

Crée un lien de paiement partageable avec un ou plusieurs produits. Partagez le paymentUrl retourné avec vos clients. Supporte les types à prix fixe, variable et facturation récurrente.

Corps de la requête

curl -X POST https://api.zyndpay.io/v1/paylinks \
  -H "X-Api-Key: zyp_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "FIXED",
    "products": [
      {
        "name": "Premium Course",
        "price": "49.99",
        "productType": "DIGITAL",
        "digitalUrl": "https://drive.google.com/file/d/abc123"
      }
    ],
    "collectEmail": "REQUIRED",
    "brandColor": "#635BFF"
  }'

{
  "success": true,
  "data": {
    "id": "pl_cma1xyz8f0001yx5k",
    "slug": "aB3dE6fG7hI9",
    "type": "FIXED",
    "status": "ACTIVE",
    "paymentUrl": "https://dashboard.zyndpay.io/pay/link/aB3dE6fG7hI9",
    "products": [
      {
        "id": "prod_abc123",
        "name": "Premium Course",
        "price": "49.990000000000000000",
        "productType": "DIGITAL",
        "digitalUrl": "https://drive.google.com/file/d/abc123"
      }
    ],
    "createdAt": "2026-03-08T10:00:00.000Z"
  }
}

Récupérer un Lien de Paiement

Récupère un seul lien de paiement par son ID, y compris les produits, codes promo et nombre de commandes.

Lister les Liens de Paiement

Retourne une liste paginée de vos liens de paiement, les plus récents en premier.

Paiement via Lien

Endpoint public (pas d'auth requise). Crée une commande et un encaissement à partir d'un lien de paiement. Le client reçoit une adresse TRON pour envoyer les USDT.

curl -X POST https://api.zyndpay.io/v1/pay/link/aB3dE6fG7hI9/checkout \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "productId": "prod_abc123", "quantity": 1 }
    ],
    "customerEmail": "[email protected]",
    "customerName": "John Doe"
  }'

{
  "success": true,
  "data": {
    "orderId": "ord_xyz789",
    "transactionId": "cma2abc9g0002yz6l0def",
    "depositAddress": "TRXabc123def456ghi789jkl",
    "amount": "49.99",
    "expiresAt": "2026-03-08T11:00:00.000Z"
  }
}

Paiements Sortants

Créer un Paiement Sortant

Les paiements sortants vous permettent d'envoyer des USDT depuis votre solde ZyndPay vers n'importe quelle adresse TRON — payez des fournisseurs, remboursez des clients ou distribuez des commissions d'affiliation. Des frais fixes de 2 USDT sont déduits de votre solde en plus du montant du paiement.

Corps de la requête

curl -X POST https://api.zyndpay.io/v1/payout \
  -H "X-Api-Key: zyp_live_sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{
    "amount": "50.00",
    "destinationAddress": "TXYZabc123def456ghi789jkl012mno345",
    "externalRef": "payout_vendor_456"
  }'

{
  "success": true,
  "data": {
    "transactionId": "cma2abc9g0002yz6l0def5678",
    "status": "PROCESSING",
    "processingFee": "2.00",
    "requiresManualApproval": false,
    "currentPayinFee": "3.0%",
    "currentTier": "STARTER"
  }
}

Récupérer un Paiement Sortant

Récupère un seul paiement sortant par son ID, y compris son statut actuel et les détails de la transaction.

Statuts des paiements sortants

Lister les Paiements Sortants

Retourne une liste paginée de paiements sortants, les plus récents en premier.

{
  "success": true,
  "data": {
    "items": [ ... ],
    "total": 42
  }
}

Retraits

Demander un Retrait

Les retraits permettent aux marchands de transférer leur solde USDT réglé depuis ZyndPay vers l'une de leurs adresses de portefeuille préenregistrées. Des frais fixes de 2 USDT sont déduits du montant.

curl -X POST https://api.zyndpay.io/v1/withdrawals \
  -H "X-Api-Key: zyp_live_sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{
    "amount": "500.00",
    "addressId": "addr_cma1xyz8f0001yx5k"
  }'

{
  "success": true,
  "data": {
    "id": "wdr_cma1xyz8f0001yx5k",
    "amount": "500.00",
    "fee": "2.00",
    "netAmount": "498.00",
    "destinationAddress": "TRXabc123def456ghi789jkl",
    "status": "PENDING",
    "createdAt": "2026-03-06T11:00:00.000Z"
  }
}

Récupérer un Retrait

Récupère une seule demande de retrait par son ID.

Annuler un Retrait

Annule une demande de retrait encore au statut PENDING_REVIEW (avant son approbation et sa diffusion sur le réseau TRON). Le montant est immédiatement retourné à votre solde.

Webhooks

Vue d'ensemble

ZyndPay envoie des requêtes HTTP POST à vos URLs d'endpoints enregistrés lorsque des événements de paiement se produisent. Enregistrez des endpoints depuis la page Webhooks de votre tableau de bord marchand.

{
  "id": "wh_cma1xyz8f0001yx5k",
  "type": "payin.confirmed",
  "data": {
    "id": "cma1xyz8f0001yx5k9abc1234",
    "amount": "100.00",
    "fee": "3.00",
    "netAmount": "97.00",
    "status": "CONFIRMED",
    "externalRef": "order_123",
    "txHash": "abc123def456...",
    "confirmedAt": "2026-03-06T11:01:02.000Z"
  },
  "createdAt": "2026-03-06T11:01:03.000Z"
}

Vérification de Signature

Chaque livraison de webhook inclut un en-tête X-ZyndPay-Signature. Vérifiez-le toujours avant de traiter l'événement.

La signature est HMAC-SHA256(timestamp + "." + raw_body, webhook_secret). Utilisez toujours le corps brut de la requête — analyser le JSON d'abord causera des échecs de vérification.

const crypto = require('crypto');

app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-zyndpay-signature'];
  const [tPart, v1Part] = sig.split(',');
  const timestamp = tPart.split('=')[1];
  const received  = v1Part.split('=')[1];

  // Reject events older than 5 minutes
  const age = Math.abs(Date.now() / 1000 - parseInt(timestamp));
  if (age > 300) return res.status(400).send('Webhook too old');

  const expected = crypto
    .createHmac('sha256', process.env.WEBHOOK_SECRET)
    .update(`${timestamp}.${req.body}`)
    .digest('hex');

  // Use timing-safe comparison to prevent timing attacks
  if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received))) {
    return res.status(400).send('Invalid signature');
  }

  const event = JSON.parse(req.body);
  // Handle event...
  res.json({ received: true });
});

import hmac, hashlib, time

def verify_webhook(payload: bytes, sig_header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in sig_header.split(","))
    timestamp = parts["t"]
    received  = parts["v1"]

    # Reject events older than 5 minutes
    if abs(time.time() - int(timestamp)) > 300:
        return False

    expected = hmac.new(
        secret.encode(),
        f"{timestamp}.{payload.decode()}".encode(),
        hashlib.sha256
    ).hexdigest()

    return hmac.compare_digest(expected, received)

Événements

SDKs & Plugins

SDK Node.js

Le SDK TypeScript officiel avec typage complet et vérification de webhook intégrée.

npm install @zyndpay/sdk

const { ZyndPay } = require('@zyndpay/sdk');

const client = new ZyndPay({
  apiKey: 'zyp_live_sk_...',
  webhookSecret: process.env.ZYNDPAY_WEBHOOK_SECRET,
});

// Create a payment
const payment = await client.payins.create({
  amount: '100.00',
  externalRef: 'order_123',
});
console.log(payment.depositAddress);

// Verify a webhook (uses raw body, not parsed JSON)
const event = client.webhooks.verify(
  rawBody,
  req.headers['x-zyndpay-signature']
);

SDK Python

Le SDK Python officiel basé sur httpx avec support synchrone et asynchrone.

pip install zyndpay

from zyndpay import ZyndPay

client = ZyndPay(
    api_key="zyp_live_sk_...",
    webhook_secret=os.environ.get("ZYNDPAY_WEBHOOK_SECRET"),
)

payment = client.payins.create(
    amount="100.00",
    external_ref="order_123"
)
print(payment["depositAddress"])

Plugin WooCommerce

Acceptez des paiements USDT dans votre boutique WordPress / WooCommerce sans écrire une seule ligne de code. Le plugin génère des adresses de dépôt, surveille le statut de confirmation et exécute automatiquement les commandes.

Sandbox

Vue d'ensemble

Le sandbox vous permet de tester toute votre intégration sans toucher à de vrais fonds ni au réseau TRON. Utilisez votre clé zyp_test_sk_... — l'API est identique à la production.

Simuler un Paiement

Confirme instantanément un encaissement sandbox, déclenche le webhook payin.confirmed et crédite le solde sandbox — exactement comme une vraie confirmation on-chain.

curl -X POST \
  https://api.zyndpay.io/v1/sandbox/payin/{id}/simulate \
  -H "X-Api-Key: zyp_test_sk_..."

{
  "success": true,
  "data": {
    "id": "cma1xyz8f0001yx5k9abc1234",
    "status": "CONFIRMED",
    "amountReceived": "100.00",
    "txHash": "sandbox_tx_abc123",
    "confirmedAt": "2026-03-06T11:00:01.000Z"
  }
}

Référence

Codes d'Erreur

Toutes les erreurs retournent la même enveloppe JSON. Utilisez le champ error pour gérer les erreurs par programmation — le champ message est lisible par l'humain et peut changer.

{
  "success": false,
  "error": "AMOUNT_TOO_LOW",
  "message": "Minimum payin amount is 20 USDT",
  "statusCode": 400,
  "requestId": "req_abc123"
}

Limites de Taux

Les limites sont appliquées par clé API. Les requêtes dépassant les limites reçoivent une réponse 429 avec un en-tête Retry-After.