# Informations générales

> Spécification technique pour l'intégration du traitement des paiements en cryptomonnaie et des retraits avec 2328.io.

Bienvenue dans la documentation de l'API 2328.io. Cette référence décrit comment intégrer le traitement des paiements en cryptomonnaie et les retraits dans votre application.

## Démarrage

Pour commencer l'intégration :

1. Créez un compte marchand et un projet sur [2328.io](https://2328.io)
2. Obtenez votre **project UUID** et votre **API key** depuis les paramètres du projet
3. Générez une **Payout API key** distincte si vous prévoyez d'utiliser les retraits
4. Lisez la section [Authentication](/docs/authentication) pour apprendre à signer les requêtes
5. Effectuez votre premier appel [Create Payment](/docs/payments)

## URL de base

Toutes les requêtes API en production utilisent l'URL de base suivante :

```
https://api.2328.io/api
```

> **WARNING:** Toutes les requêtes doivent être effectuées via **HTTPS**. Les requêtes sans HTTPS sont bloquées.

## Ce que vous pouvez faire

Avec l'API 2328.io, vous pouvez :

- **Accepter des paiements en crypto** — créer des sessions de paiement et rediriger les clients vers une page de paiement hébergée ou un Telegram MiniApp
- **Effectuer des retraits** — envoyer par programmation des retraits depuis votre solde marchand vers n'importe quelle adresse blockchain
- **Vérifier les soldes** — consultez les soldes des comptes du marchand par devise, leur équivalent en USD et les montants verrouillés par AML
- **Utiliser des portefeuilles statiques** — générer des adresses de dépôt permanentes liées à un utilisateur ou à une commande
- **Récupérer les taux de change** — obtenir des taux en temps réel pour les paires fiat et crypto
- **Recevoir des webhooks** — être notifié instantanément lorsqu'un statut de paiement change
## Limites de débit

L'API autorise jusqu'à **10 requêtes par seconde par projet**. Les requêtes au-delà de cette limite reçoivent une réponse HTTP `429 Too Many Requests` — patientez puis réessayez.