Construisez sur CowriePay
Une API REST propre, des clés scopées, des webhooks signés et une sandbox. En production en 10 à 15 minutes.
Démarrer
Demandez un accès
Remplissez le formulaire sur app.cowriepay.io/get-started. Notre équipe configure votre workspace sous 48 heures.
Créez une clé de test et développez
Dans le tableau de bord (mode Sandbox), créez une clé cpk_test_ et développez sur TRON Nile, BSC testnet et Ethereum Hoodi. Pré-financez votre wallet de test en un appel API grâce au faucet intégré, sans courir après les faucets publics.
Signez vos requêtes
Chaque requête /v2 est signée en HMAC-SHA256 avec votre clé API scopée.
Passez en production
Complétez le KYB, nous l'approuvons et activons votre workspace, puis créez une clé cpk_live_. Même URL, même code : changez de clé.
SDKs officiels
Des SDK côté serveur qui gèrent pour vous la signature HMAC, les retentatives et la vérification des webhooks. Sans dépendance à l'exécution, générés depuis notre spec OpenAPI.
npm install @cowriepay/sdkimport { CowriePay } from "@cowriepay/sdk";
const cowriepay = new CowriePay({
apiKey: process.env.CPK_KEY!,
apiSecret: process.env.CPK_SECRET!,
});
const wallet = await cowriepay.wallets.create({
chain: "TRON",
asset: "USDT_TRON",
});- Créez un wallet en un seul appel API
- Recevez un webhook signé à chaque dépôt et payout
- Testez tout gratuitement dans la Sandbox
# Une seule URL pour la Sandbox et la Live ; votre clé choisit le réseau
# (cpk_test_ = testnet, cpk_live_ = mainnet). Les requêtes sont signées en HMAC.
curl https://api.cowriepay.io/v2/wallets \
-H "X-CowriePay-Key: cpk_live_..." \
-H "X-CowriePay-Timestamp: 1720000000" \
-H "X-CowriePay-Signature: <hmac-sha256>" \
-H "Content-Type: application/json" \
-d '{"chain":"TRON_MAINNET","asset":"USDT_TRON"}'Ce que vous obtenez
API REST et OpenAPI
Une API REST prévisible avec une référence OpenAPI pour générer vos clients.
Clés API scopées
Des clés fines, live et test séparées, moindre privilège par défaut.
Webhooks signés
Des événements signés HMAC avec rotation et fenêtre de chevauchement, pour ne rien manquer.
Sandbox
Un environnement testnet complet pour construire et vérifier avant la production.
Idempotence
Des retentatives sûres sur les écritures grâce aux clés d'idempotence.
Mises à jour temps réel
Webhooks et dashboard à jour au fil des confirmations et des règlements.
Événements webhook
DEPOSIT_DETECTEDDEPOSIT_CONFIRMEDDEPOSIT_SWEPTWITHDRAWAL_PROCESSINGWITHDRAWAL_CONFIRMEDWITHDRAWAL_FAILEDBENEFICIARY_ADDEDPOST /your-endpoint
X-CowriePay-Signature: t=1718700000,v1=9f2c...
{
"event": "DEPOSIT_CONFIRMED",
"data": {
"asset": "USDT",
"chain": "TRON",
"amount": "250.00",
"confirmations": 19,
"status": "CONFIRMED"
}
}