Démarrer

Démarrage rapide

Votre premier paiement de test en cinq minutes.

1. Récupérez une clé de test

Créez un compte, puis ouvrez Développeurs dans votre tableau de bord et créez une clé de test. Elle n'est affichée qu'une fois : copiez-la.

2. Créez un paiement

curl -X POST https://api.secure.payment.loov-solutions.com/v2/payments \
  -H "Authorization: Bearer $LOOV_API_KEY" \
  -H "Idempotency-Key: 6f1c2b9e-order-42" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 5000,
  "currency": "XAF",
  "operator": "mtn-cm",
  "phone_number": "237650000000",
  "merchant_reference": "order-42",
  "customer": {
    "name": "Awa Diop",
    "email": "awa@example.com"
  }
}'

La réponse contient une référence et le statut processing.

Réponse

{
  "reference": "PAYHBN2MJVPY32K7MSZXXN9",
  "type": "payin",
  "status": "processing",
  "livemode": false,
  "currency": "XAF",
  "amount": 5000,
  "fee": 150,
  "customer_fee": 0,
  "counterparty_amount": 5000,
  "merchant_amount": 4850,
  "method": "mobile_money",
  "operator": "mtn-cm",
  "phone_number": "237650000000",
  "checkout_url": null,
  "merchant_reference": "order-42",
  "failure": null,
  "created_at": "2026-10-04T10:12:00+00:00",
  "completed_at": null
}

3. Simulez le résultat

En test, c'est vous qui terminez la transaction, comme le ferait le client :

curl -X POST https://api.secure.payment.loov-solutions.com/v2/test/transactions/PAYHBN2MJVPY32K7MSZXXN9/simulate \
  -H "Authorization: Bearer $LOOV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "outcome": "succeeded"
}'

4. Recevez la notification

Si vous avez renseigné une URL de webhook, nous y envoyons payin.succeeded. Voir la page Webhooks pour vérifier la signature.

Passez en production en remplaçant simplement la clé de test par une clé live. Le reste de votre code ne change pas.