Paiements

Transferts (payouts)

Envoyer de l'argent vers un portefeuille mobile money.

Un transfert est prélevé sur votre solde de transfert. Les fonds sont réservés avant l'envoi et rendus si le transfert échoue.

curl -X POST https://api.secure.payment.loov-solutions.com/v2/payouts \
  -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",
  "description": "Salaire octobre",
  "merchant_reference": "salaire-2026-10-awa"
}'

L'en-tête Idempotency-Key est obligatoire pour les transferts : il garantit qu'une requête relancée n'envoie pas l'argent deux fois.

Erreurs fréquentes

Code	HTTP	Description
`insufficient_funds`	402	Le solde de transfert ne couvre pas le montant et les frais.
`duplicate_merchant_reference`	409	Une transaction porte déjà ce merchant_reference.
`payouts_disabled`	403	Les transferts ne sont pas activés pour votre compte.
`operator_not_supported`	422	L'opérateur n'existe pas ou ne correspond pas à la devise.
`phone_number_invalid`	422	Le numéro n'appartient pas au pays de l'opérateur.

Alimentez votre solde de transfert depuis le tableau de bord : en y transférant vos encaissements, ou en déclarant un dépôt bancaire.