Skip to main content
POST
Demander un reversement
La demande est adressée au compte principal s’il existe ; destination, country et operator ne sont utilisés qu’en son absence. Guide : Reversements.

Authorizations

authenticationtoken
string
header
required

JWT obtenu via POST /user/login-merchant. À passer tel quel, sans préfixe Bearer.

Body

application/json
reference
string
required

Référence du marchand.

Example:

"beautyshop"

amount
number
required

Montant brut en FCFA (≥ 500 et ≤ solde disponible). Les frais sont déduits de ce montant.

Required range: x >= 500
Example:

50000

destination
string

Numéro cible. Ignoré si un compte principal existe.

Example:

"+2250700000000"

country
string
Example:

"CI"

operator
string

orange, moov, mtn ou wave. Ignoré si un compte principal existe.

Example:

"wave"

Response

Demande créée.

id
string<uuid>
reference
string

Référence du marchand.

Example:

"beautyshop"

amount
number
Example:

50000

destination
string

Numéro mobile money ou numéro de compte bancaire cible.

Example:

"+2250700000000"

country
string
Example:

"CI"

operator
string

Type du compte cible (orange, moov, mtn, wave, bank).

Example:

"wave"

status
enum<string>
  • PENDING — demande créée, en attente de validation par Djonanko.
  • PROCESSING — validée, transfert lancé chez l'opérateur.
  • SUCCESS — fonds reçus sur le compte de reversement.
  • FAILED — transfert échoué (voir failureReason).
Available options:
PENDING,
PROCESSING,
SUCCESS,
FAILED
fees
number

Frais de reversement retenus (2 % mobile money, 1 500 FCFA banque).

Example:

1000

netAmount
number

Montant réellement envoyé au bénéficiaire (amount - fees).

Example:

49000

feeBreakdown
object

Détail du calcul des frais d'un reversement.

automatic
boolean

true si le reversement a été créé par le règlement automatique T+0 / T+1.

Example:

false

settlementMode
enum<string> | null

Mode de règlement à l'origine d'un reversement automatique.

Available options:
T0,
T1,
null
settlementSummary
object | null

Bilan de la période réglée (règlement automatique uniquement) — collectionsCount, grossCollected, collectionFees, netCollected, windowStart, windowEnd, balanceBefore, monthlyRemaining.

payoutAccountId
string | null
payoutDetails
object | null

Instantané du compte de reversement au moment de la demande.

failureReason
string | null
processedManually
boolean
validatedAt
string<date-time> | null
completedAt
string<date-time> | null
merchantName
string | null
createdAt
string<date-time>
updatedAt
string<date-time>