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

# Motifs de transfert

> Liste des motifs de paiement par corridor

Récupère les motifs de paiement disponibles pour un corridor spécifique.

<Warning>
  Le motif (`purpose`) est **requis** pour les payouts internationaux.
</Warning>

<Note>
  Cet endpoint ne nécessite pas d'authentification.
</Note>

### Paramètres de requête

| Paramètre            | Type   | Requis | Description              |
| -------------------- | ------ | ------ | ------------------------ |
| `sourceCountry`      | string | Oui    | Pays source (ISO 2)      |
| `destinationCountry` | string | Oui    | Pays destination (ISO 2) |

### Requête

```bash theme={null}
curl "https://sandbox-api.caurisflux.com/api/v1/payouts/reference/purposes?sourceCountry=SN&destinationCountry=FR"
```

### Réponse

```json theme={null}
{
  "purposes": [
    {
      "code": "SALARY",
      "label": "Salaire",
      "description": "Paiement de salaire ou rémunération"
    },
    {
      "code": "INVOICE",
      "label": "Facture",
      "description": "Paiement de facture fournisseur"
    },
    {
      "code": "SERVICES",
      "label": "Services",
      "description": "Paiement pour services rendus"
    },
    {
      "code": "GOODS",
      "label": "Marchandises",
      "description": "Achat de marchandises"
    },
    {
      "code": "FAMILY_SUPPORT",
      "label": "Aide familiale",
      "description": "Transfert d'argent à la famille"
    },
    {
      "code": "EDUCATION",
      "label": "Éducation",
      "description": "Frais de scolarité ou formation"
    },
    {
      "code": "OTHER",
      "label": "Autre",
      "description": "Autre motif"
    }
  ]
}
```

### Champs de réponse

| Champ         | Type   | Description                    |
| ------------- | ------ | ------------------------------ |
| `code`        | string | Code à utiliser dans le payout |
| `label`       | string | Libellé affiché                |
| `description` | string | Description du motif           |

### Utilisation

Utilisez le `code` dans le champ `international.purpose` lors de la création d'un payout international :

```json theme={null}
{
  "international": {
    "destinationCountry": "FR",
    "destinationCurrency": "EUR",
    "purpose": "SALARY"
  }
}
```