curl --request POST \
  --url https://api.jeko.africa/partner_api/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "name": "John Doe",
  "paymentMethod": "wave",
  "identifier": {
    "number": "+2250701234567"
  }
}
'

{
  "id": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "name": "John Doe",
  "paymentMethod": "wave",
  "identifier": {
    "number": "+2250701234567"
  }
}

Contacts

Créer un contact bénéficiaire

Crée un nouveau contact bénéficiaire pour les virements.

Types de contacts pris en charge :

Mobile Money : Wave, Orange Money, MTN Mobile Money, Moov Money, DJAMO
Compte bancaire : Virements bancaires via RIB (Relevé d’Identité Bancaire)

Contact Mobile Money : Nécessite un numéro de téléphone dans l’objet identifier.

Contact bancaire : Nécessite les détails bancaires complets incluant le nom de la banque, les codes, le numéro de compte et la clé RIB.

Cas d’usage :

Ajouter des bénéficiaires de paie
Enregistrer les détails de paiement des fournisseurs
Sauvegarder les informations de retrait d’espèces des clients

POST

partner_api

contacts

curl --request POST \
  --url https://api.jeko.africa/partner_api/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "name": "John Doe",
  "paymentMethod": "wave",
  "identifier": {
    "number": "+2250701234567"
  }
}
'

{
  "id": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "name": "John Doe",
  "paymentMethod": "wave",
  "identifier": {
    "number": "+2250701234567"
  }
}

Authorizations

X-API-KEY

string

header

required

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

Body

application/json

Option 1
Option 2

Request schema for creating a mobile money contact

name

string

required

Contact name

Maximum string length: 255

Example:

"John Doe"

paymentMethod

enum<string>

required

Mobile money payment method

Available options:

wave,

orange,

mtn,

moov,

djamo

Example:

"wave"

identifier

object

required

Mobile money identifier containing phone number

Show child attributes

Response

Contact créé avec succès

Option 1
Option 2

Response schema for mobile money contact

string<uuid>

required

Contact identifier

Example:

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

name

string

required

Contact name

Example:

"John Doe"

paymentMethod

enum<string>

required

Mobile money payment method

Available options:

wave,

orange,

mtn,

moov,

djamo

Example:

"wave"

identifier

object

required

Mobile money identifier

Show child attributes

Lister les contacts bénéficiaires

Supprimer un contact bénéficiaire