Documentation API

Intégrez les paiements
en minutes, pas en mois

Une API REST propre, des SDKs officiels, des tests sandbox, des webhooks en temps réel et une documentation complète. Tout ce dont vous avez besoin pour intégrer DWS dans n'importe quelle application.

Simple. Puissant. Sécurisé.

L'API REST DWS suit les conventions standard du secteur. Si vous avez utilisé Stripe ou Adyen, vous vous sentirez à l'aise. Verbes HTTP, JSON requête/réponse, URLs prévisibles et messages d'erreur détaillés.

API RESTful

Verbes HTTP standard, charges utiles JSON et URLs orientées ressources prévisibles.

Auth par clé API

Authentification sécurisée par clé API. Utilisez les clés de test en sandbox, les clés live en production.

Webhooks en temps réel

Recevez des notifications instantanées pour les événements de paiement, remboursements et changements de statut.

Environnement Sandbox

Environnement de test complet avec numéros de cartes de test et flux de paiement simulés.

Base URL
https://api.digital-wallet-services.com/v1
Create Payment
use DWS\Client;

$client = new Client([
  'api_key' => 'sk_live_xxxxxxxxxxxxxxxx',
]);

$payment = $client->createPayment([
  'amount'      => 100000,
  'currency'    => 'MAD',
  'description' => 'Order #1234',
  'customer'    => [
    'email'  => 'customer@example.com',
    'name'   => 'Mohamed Amine',
  ],
  'return_url'  => 'https://yoursite.ma/success',
]);

header('Location: ' . $payment->checkout_url);

SDKs officiels

Bibliothèques idiomatiques pour votre langage préféré. Installez et commencez à construire.

🐘
PHP
PHP 8.1+
v1.4.2
$ composer require dws/dws-php
JavaScript
Node.js 18+ / Browser
v2.1.0
$ npm install @dws/dws-js
🐍
Python
Python 3.9+
v1.2.1
$ pip install dws-python

Webhooks en temps réel

DWS envoie des notifications HTTP POST instantanées à votre endpoint pour chaque événement de paiement. Pas de polling requis - votre système réagit en temps réel.

payment.succeeded Paiement réussi
payment.failed Tentative de paiement échouée
payment.refunded Remboursement traité
subscription.created Nouvel abonnement démarré
subscription.renewed Renouvellement automatique d'abonnement
wallet.credited Solde du portefeuille augmenté
Webhook Handler (PHP)
$payload = json_decode(
  file_get_contents('php://input'), true
);

$client->webhooks->verify(
  $payload,
  $_SERVER['HTTP_DWS_SIGNATURE'],
  'whsec_xxxxxxxxxxxx'
);

switch ($payload['event']) {
  case 'payment.succeeded':
    fulfillOrder($payload['data']);
    break;
  case 'payment.failed':
    notifyCustomer($payload['data']);
    break;
}

http_response_code(200);
Environnement Sandbox

Testez sans risque

Le sandbox DWS est une réplique complète de l'environnement de production - avec des cartes de test, des flux de paiement simulés et la livraison de webhooks en temps réel. Testez tout avant de passer en production.

Parité API complète avec la production
Numéros de cartes de test pour tous les scénarios
Flux d'authentification 3DS2 simulés
Livraison de webhooks en temps réel
Accès au tableau de bord avec données de test
Pas de vrai argent - complètement sûr
Numéros de cartes de test
4242 4242 4242 4242
Paiement réussi
4000 0000 0000 0002
Paiement refusé
4000 0025 0000 3155
3DS2 requis
4000 0000 0000 9995
Fonds insuffisants

Prêt à intégrer ?

Obtenez vos clés API, explorez le sandbox et construisez votre intégration. Notre équipe de développeurs est là pour vous aider.