> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jeko.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestion des contacts bénéficiaires

> Créer et gérer les contacts bénéficiaires pour les transferts

## Vue d'ensemble

Les **contacts bénéficiaires** sont des enregistrements de personnes ou d'entités qui peuvent recevoir des transferts. **Vous devez créer un contact avant de pouvoir effectuer un transfert vers ce bénéficiaire.**

### Types de contacts

JEKO supporte deux types de contacts :

1. **Contacts Mobile Money** : Pour les transferts vers des comptes Mobile Money
2. **Contacts bancaires** : Pour les transferts vers des comptes bancaires

## Créer un contact Mobile Money

Pour créer un contact Mobile Money, vous devez fournir :

* Le nom du bénéficiaire
* La méthode de paiement (wave, orange\_money, mtn, moov, djamo)
* Le numéro de téléphone au format international

### Exemple : Créer un contact Wave

```bash theme={null}
curl -X POST "https://api.jeko.africa/partner_api/contacts" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "paymentMethod": "wave",
    "identifier": {
      "number": "+2250701234567"
    }
  }'
```

### Exemple : Créer un contact Orange Money

```bash theme={null}
curl -X POST "https://api.jeko.africa/partner_api/contacts" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "paymentMethod": "orange_money",
    "identifier": {
      "number": "+2250501234567"
    }
  }'
```

### Réponse

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

**Important** : Conservez le `id` retourné (contactId) - vous en aurez besoin pour effectuer des transferts vers ce contact.

## Créer un contact bancaire

Pour créer un contact bancaire, vous devez fournir :

* Le nom du bénéficiaire
* La méthode de paiement : `"bank"`
* Les détails bancaires complets (RIB)

### Détails bancaires requis

* `bankName` : Nom de la banque
* `bankCode` : Code de la banque
* `swiftCode` : Code SWIFT/BIC
* `agencyCode` : Code de l'agence
* `accountNumber` : Numéro de compte
* `key` : Clé RIB

### Exemple : Créer un contact bancaire

```bash theme={null}
curl -X POST "https://api.jeko.africa/partner_api/contacts" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Doe",
    "paymentMethod": "bank",
    "identifier": {
      "bankName": "Ecobank",
      "bankCode": "ECO01",
      "swiftCode": "ECOCCIAB",
      "agencyCode": "00123",
      "accountNumber": "0123456789",
      "key": "12"
    }
  }'
```

### Réponse

```json theme={null}
{
  "id": "29f81706-03a6-492f-92ee-5f0b2e9b18e7",
  "name": "Jane Doe",
  "paymentMethod": "bank",
  "identifier": {
    "bankName": "Ecobank",
    "bankCode": "ECO01",
    "swiftCode": "ECOCCIAB",
    "agencyCode": "00123",
    "accountNumber": "0123456789",
    "key": "12"
  }
}
```

## Lister les contacts

Pour récupérer la liste de tous vos contacts bénéficiaires :

```bash theme={null}
curl -X GET "https://api.jeko.africa/partner_api/contacts" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here"
```

### Réponse

```json theme={null}
[
  {
    "id": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
    "name": "John Doe",
    "paymentMethod": "wave",
    "identifier": {
      "number": "+2250701234567"
    }
  },
  {
    "id": "29f81706-03a6-492f-92ee-5f0b2e9b18e7",
    "name": "Jane Doe",
    "paymentMethod": "bank",
    "identifier": {
      "bankName": "Ecobank",
      "bankCode": "ECO01",
      "swiftCode": "ECOCCIAB",
      "agencyCode": "00123",
      "accountNumber": "0123456789",
      "key": "12"
    }
  }
]
```

## Supprimer un contact

Pour supprimer un contact (suppression douce) :

```bash theme={null}
curl -X DELETE "https://api.jeko.africa/partner_api/contacts/{contactId}" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here"
```

**Note** : Après suppression, le contact ne sera plus disponible pour de nouveaux transferts, mais l'historique des transferts précédents reste accessible.

## Bonnes pratiques

1. **Créer les contacts à l'avance** : Enregistrez vos contacts bénéficiaires avant d'avoir besoin d'effectuer des transferts
2. **Valider les informations** : Vérifiez que les numéros de téléphone et les détails bancaires sont corrects avant de créer le contact
3. **Réutiliser les contacts** : Une fois créé, un contact peut être utilisé pour plusieurs transferts
4. **Gérer les contacts** : Maintenez une liste à jour de vos contacts et supprimez ceux qui ne sont plus nécessaires
5. **Stockage sécurisé** : Conservez les `contactId` de manière sécurisée dans votre système pour référence future

## Obtenir les codes bancaires

Pour obtenir la liste des banques supportées et leurs codes, utilisez l'endpoint `/partner_api/banks` :

```bash theme={null}
curl -X GET "https://api.jeko.africa/partner_api/banks" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here"
```

Cela vous permet de valider les informations bancaires avant de créer un contact bancaire.