curl --request POST \
  --url https://api.jeko.africa/partner_api/transfers \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "storeId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "contactId": "29f81706-03a6-492f-92ee-5f0b2e9b18e7",
  "amountCents": 50000,
  "currency": "XOF",
  "description": "Monthly salary payment",
  "reference": "PAYROLL-APR-001"
}
'

{
  "id": "wth_abc123def456",
  "storeId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "contactId": "29f81706-03a6-492f-92ee-5f0b2e9b18e7",
  "amount": {
    "amount": 50000,
    "currency": "XOF"
  },
  "fees": {
    "amount": 500,
    "currency": "XOF"
  },
  "status": "pending",
  "paymentMethod": "wave",
  "beneficiary": "+2250701234567",
  "description": "Monthly salary payment",
  "reference": "PAYROLL-APR-001",
  "createdAt": "2024-01-15T14:30:25.000Z"
}

Virements

Créer un virement

Crée un nouveau virement depuis le portefeuille d’un magasin vers un contact bénéficiaire.

Résolution du bénéficiaire (fournir exactement une option) :

Contact existant : contactId d’un bénéficiaire déjà créé
Bénéficiaire inline : name, paymentMethod et identifier — crée automatiquement un contact masqué, exclu de GET /partner_api/contacts jusqu’à création explicite via POST /partner_api/contacts

Flux de virement (contact existant) :

Spécifiez le magasin depuis lequel transférer les fonds
Spécifiez le contact (bénéficiaire) qui recevra les fonds
Spécifiez le montant en centimes
Le système déduit automatiquement les frais et traite le virement

Méthodes de virement prises en charge :

Mobile Money : Wave, Orange Money, MTN Mobile Money, Moov Money, DJAMO
Compte bancaire : Virements bancaires via RIB

Cas d’usage :

Paiements de salaires
Paiements aux fournisseurs
Demandes de retrait d’espèces des clients
Virements entre entreprises

Notes importantes :

Le magasin doit appartenir à l’entreprise authentifiée
Le contact doit appartenir à l’entreprise authentifiée
Un solde suffisant doit être disponible dans le portefeuille du magasin
Les frais de virement sont automatiquement calculés et déduits
Si vous envoyez un champ reference, utilisez une valeur unique par tentative de transfert ; une valeur déjà utilisée renvoie 409 Conflict
La reference est renvoyée dans les réponses de l’API Partenaire et dans les payloads webhook de transaction lorsqu’elle a été fournie à la création

POST

partner_api

transfers

curl --request POST \
  --url https://api.jeko.africa/partner_api/transfers \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "storeId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "contactId": "29f81706-03a6-492f-92ee-5f0b2e9b18e7",
  "amountCents": 50000,
  "currency": "XOF",
  "description": "Monthly salary payment",
  "reference": "PAYROLL-APR-001"
}
'

{
  "id": "wth_abc123def456",
  "storeId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "contactId": "29f81706-03a6-492f-92ee-5f0b2e9b18e7",
  "amount": {
    "amount": 50000,
    "currency": "XOF"
  },
  "fees": {
    "amount": 500,
    "currency": "XOF"
  },
  "status": "pending",
  "paymentMethod": "wave",
  "beneficiary": "+2250701234567",
  "description": "Monthly salary payment",
  "reference": "PAYROLL-APR-001",
  "createdAt": "2024-01-15T14:30:25.000Z"
}

Authorizations

X-API-KEY

string

header

required

Clé API pour les requêtes de l'API Partenaire

Body

application/json

Option 1
Option 2
Option 3

Créer un virement avec un contact bénéficiaire existant

storeId

string<uuid>

required

Identifiant du magasin depuis lequel transférer les fonds

Example:

"59ae202a-f583-4a15-970f-9e99bd1e0baa"

amountCents

integer

required

Montant en centimes (minimum 500 centimes = 5 XOF)

Required range: x >= 500

Example:

50000

currency

string

required

Code devise (ISO 4217)

Required string length: 3

Example:

"XOF"

contactId

string<uuid>

required

Identifiant du contact bénéficiaire

Example:

"29f81706-03a6-492f-92ee-5f0b2e9b18e7"

description

string

Description optionnelle du virement

Maximum string length: 255

Example:

"Monthly salary payment"

reference

string

Référence partenaire pour la réconciliation (renvoyée dans les réponses et les webhooks lorsqu’elle est fournie)

Required string length: 5 - 100

Example:

"PAYROLL-APR-001"

Response

Virement créé avec succès

Response schema for transfer operations

string

required

Transfer identifier

Example:

"wth_abc123def456"

storeId

string<uuid>

required

Identifiant du magasin

Example:

"59ae202a-f583-4a15-970f-9e99bd1e0baa"

amount

object

required

Money amount representation

Show child attributes

fees

object

required

Money amount representation

Show child attributes

status

enum<string>

required

Transfer status

Available options:

pending,

success,

error

Example:

"success"

paymentMethod

enum<string>

required

Payment method used for transfer

Available options:

wave,

orange,

mtn,

moov,

djamo,

bank

Example:

"wave"

beneficiary

string

required

Beneficiary identifier (phone number or bank account)

Example:

"+2250701234567"

description

string

required

Transfer description

Example:

"Monthly salary payment"

createdAt

string<date-time>

required

Transfer creation timestamp (ISO 8601)

Example:

"2024-01-15T14:30:25.000Z"

contactId

string<uuid>

Contact identifier (beneficiary)

Example:

"29f81706-03a6-492f-92ee-5f0b2e9b18e7"

reference

string | null

Référence partenaire fournie lors de la création, le cas échéant

Required string length: 5 - 100

Example:

"PAYROLL-APR-001"

transaction

object

Associated transaction details (present when transaction is created)

Show child attributes

Magasins

Transactions

Appareils

Demandes de paiement

Liens de paiement

Banques

Fournisseurs de services

Contacts

Virements

Créer un virement

Authorizations

Body

Response