Développeurs

Documentation API

Tout ce qu'il faut pour intégrer WebCashConnect en moins d'une heure.

Quick Start

1. Créez un compte et un site en Sandbox. 2. Générez une clé sk_test_. 3. Appelez l'API.

Authentification

Toutes les requêtes vers /api/v1/* nécessitent :

Authorization: Bearer sk_live_xxxxxxxxxxxx
Content-Type: application/json

Créer un paiement

POST /api/v1/payments
Idempotency-Key: order-12345

{
  "amount": 1500,
  "currency": "HTG",
  "payment_method": "moncash",
  "description": "Commande #12345",
  "return_url": "https://merchant.com/success",
  "cancel_url": "https://merchant.com/cancel",
  "webhook_url": "https://merchant.com/webhook"
}

Réponse

{
  "success": true,
  "transaction_id": "WCC-2026-00000001",
  "status": "PENDING",
  "payment_url": "https://app.webcashconnect.com/pay/abc"
}

Webhooks

Chaque événement est signé. Vérifiez l'en-tête X-WebCashConnect-Signature avec votre secret webhook et HMAC-SHA256.

// Vérification en PHP
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_WEBCASHCASHCONNECT_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $payload, $webhookSecret);
if (!hash_equals($expected, $signature)) {
    http_response_code(401);
    exit;
}

Sandbox

Préfixes : pk_test_ / sk_test_ pour Sandbox, pk_live_ / sk_live_ pour Production. Les clés Sandbox ne peuvent pas créer de paiements réels.

Erreurs

{
  "success": false,
  "error": {
    "code": "PAYMENT_NOT_FOUND",
    "message": "Payment not found.",
    "request_id": "req_..."
  }
}