> ## Documentation Index
> Fetch the complete documentation index at: https://docs.i-pay.money/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

Ce guide crée un paiement Sandbox, puis vérifie son statut. Il utilise l'API REST depuis un serveur ou un terminal afin de ne jamais exposer la clé secrète dans le navigateur.

## 1. Récupérer les clés Sandbox

Connectez-vous au dashboard iPayMoney, ouvrez **Développeurs → Clés API** et copiez la clé secrète du compte Sandbox.

Conservez-la dans une variable d'environnement :

```bash theme={null}
export IPAYMONEY_SECRET_KEY="votre_cle_secrete_sandbox"
```

## 2. Créer un paiement de test

```bash theme={null}
curl --request POST "https://i-pay.money/api/v1/payments" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${IPAYMONEY_SECRET_KEY}" \
  --header "Ipay-Target-Environment: sandbox" \
  --header "Ipay-Payment-Type: mobile" \
  --data '{
    "amount": 1000,
    "country": "BJ",
    "currency": "XOF",
    "msisdn": "40410000000",
    "transaction_id": "ORDER-SANDBOX-001",
    "customer_name": "Client Test"
  }'
```

`transaction_id` doit être unique pour votre compte. Une valeur déjà utilisée provoque une réponse `422`.

La réponse HTTP `200` contient notamment les références à conserver :

```json theme={null}
{
  "status": "succeeded",
  "reference": "REFERENCE_IPAYMONEY",
  "public_reference": "REFERENCE_PUBLIQUE"
}
```

> **Note :** le champ `status` de la réponse de création ne doit pas être votre seule preuve de paiement. Vérifiez toujours le statut avec l'endpoint de consultation ou avec un webhook authentifié.

## 3. Vérifier le statut

```bash theme={null}
curl --request GET "https://i-pay.money/api/v1/payments/REFERENCE_IPAYMONEY" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${IPAYMONEY_SECRET_KEY}" \
  --header "Ipay-Target-Environment: sandbox" \
  --header "Ipay-Payment-Type: mobile"
```

Vous pouvez utiliser la `reference` iPayMoney ou votre `transaction_id`. Ne validez une commande que lorsque la réponse de vérification contient `status: succeeded`.

## Étapes suivantes

* [Tester les autres scénarios Sandbox](/ipaymoney/sandbox-tests)
* [Configurer les webhooks](/ipaymoney/plugin-et-sdk/webhook)
* [Consulter la Référence API](/api-reference)
* [Préparer le passage en Live](/ipaymoney/environnements)