> ## Documentation Index > Fetch the complete documentation index at: https://doc.ashtechpay.com/llms.txt > Use this file to discover all available pages before exploring further. # Wallets et conversions > Consultez les soldes et configurez les conversions immédiates ou automatiques. Chaque requête ci-dessous utilise la clé API Bearer. `user_id` doit être l'identifiant du profil AshTech Pay propriétaire de cette clé. Un identifiant manquant renvoie `400 user_id_required`; un identifiant qui ne correspond pas à la clé renvoie `403 user_id_mismatch`. Les conversions immédiates et la création de règles de conversion automatique exigent aussi l’en-tête `X-Transaction-PIN` avec le PIN à 4 chiffres configuré dans le tableau de bord. Sans PIN configuré, l’API renvoie `428 TRANSACTION_PIN_SETUP_REQUIRED`; sans l’en-tête, elle renvoie `428 TRANSACTION_PIN_REQUIRED`. Un PIN incorrect renvoie `403 TRANSACTION_PIN_INVALID`; après cinq erreurs, les opérations sont bloquées pendant 30 minutes. Gardez le PIN sur votre serveur et ne l’intégrez jamais dans le navigateur. Remplacez `VOTRE_PIN_4_CHIFFRES` dans les exemples par le PIN déjà configuré dans votre tableau de bord. ## Quel wallet utiliser ? * **Wallet source** : utilisez `wallet_currency` dans la réponse de `GET /v1/wallets?user_id=...`. Cette route liste les wallets et soldes de ce profil, pas tous les wallets possibles par pays. * **Pays de destination** : chargez les pays actifs et leurs codes avec [`GET /v1/countries`](https://doc.ashtechpay.com/docs/reference/countries). Son champ `currency` est une devise ISO normalisée (`XAF`, `XOF`, etc.) et n'est pas toujours le code interne exact du wallet. Pour une conversion, envoyez `destination_country_code` (par exemple `CM` ou `TG`), pas un code de wallet cible. AshTech Pay résout le wallet correspondant au pays et renvoie le code exact dans `to_wallet_currency`. L'API Direct ne fournit pas de route séparée qui liste les codes internes de wallet pour tous les pays. ## Consulter les soldes ```http theme={null} GET https://www.ashtechpay.com/v1/wallets?user_id=VOTRE_USER_ID Authorization: Bearer ASHTECH_API_KEY ``` La réponse comprend le wallet principal et les wallets secondaires. `wallet_currency` est le code exact du wallet utilisé en interne (par exemple `XAFG`, `XOFC` ou `XOFT`); `currency` est son code ISO regroupé (`XAF` ou `XOF`). ```json theme={null} { "user_id": "VOTRE_USER_ID", "wallets": [ { "wallet_currency": "XAF", "currency": "XAF", "balance": 12500, "is_primary": true }, { "wallet_currency": "XOFT", "currency": "XOF", "balance": 8400, "is_primary": false } ] } ``` ## Demander une conversion ```http theme={null} POST https://www.ashtechpay.com/v1/conversions Authorization: Bearer ASHTECH_API_KEY X-Transaction-PIN: VOTRE_PIN_4_CHIFFRES Content-Type: application/json ``` ```json theme={null} { "user_id": "VOTRE_USER_ID", "from_currency": "XOFT", "destination_country_code": "CM", "amount": "5000", "reference": "commande-2026-10025", "notify_url": "https://example.com/webhooks/ashtechpay" } ``` * `from_currency` doit être le code exact du wallet à débiter. * Consultez [`GET /v1/countries`](https://doc.ashtechpay.com/docs/reference/countries) pour les codes pays acceptés. AshTech Pay résout `destination_country_code` vers le wallet exact du pays; ne passez pas un code cible choisi par le client. * `reference` est obligatoire et sert à rendre les reprises idempotentes. Une même référence avec des paramètres différents renvoie `409 reference_conflict`. * `notify_url` est facultative et doit être une URL HTTPS publique. Les soldes insuffisants et les conversions sous le minimum configuré sont rejetés avant débit. Une réponse `202` signifie que la demande est enregistrée et que le montant source a été débité. Le montant cible est crédité après le traitement asynchrone. ```json theme={null} { "transaction_id": "uuid", "conversion_id": "uuid", "reference": "ASHPAY-CONV-...", "merchant_reference": "commande-2026-10025", "status": "pending", "from_amount": 5000, "from_currency": "XOF", "from_wallet_currency": "XOFT", "to_amount": 4875, "to_currency": "XAF", "to_wallet_currency": "XAF", "fee_amount": 125, "fee_currency": "XOF", "estimated_seconds": 10 } ``` ### Suivre une conversion ```http theme={null} GET https://www.ashtechpay.com/v1/conversions/CONVERSION_ID?user_id=VOTRE_USER_ID Authorization: Bearer ASHTECH_API_KEY ``` Les états sont `pending`, `completed` ou `cancelled`. Une conversion annulée après création recrédite le wallet source. La même opération émet `conversion.completed` ou `conversion.failed` au webhook lorsqu'un `notify_url` est configuré. ## Conversions automatiques Une règle convertit automatiquement les fonds reçus dans le wallet source choisi vers le wallet exact associé au pays cible. Une règle active maximum est autorisée par devise source. Créer une règle : ```http theme={null} POST https://www.ashtechpay.com/v1/auto-conversion-rules Authorization: Bearer ASHTECH_API_KEY X-Transaction-PIN: VOTRE_PIN_4_CHIFFRES Content-Type: application/json ``` ```json theme={null} { "user_id": "VOTRE_USER_ID", "from_currency": "XOFT", "destination_country_code": "CM", "notify_url": "https://example.com/webhooks/ashtechpay" } ``` Si le wallet source a déjà un solde, AshTech Pay tente immédiatement une première conversion. La réponse contient `initial_conversion_id` lorsqu'une demande a été créée; utilisez `GET /v1/conversions/:id?user_id=...` pour en suivre l'état. Les crédits ultérieurs dans ce wallet déclenchent la même règle. Lister les règles : ```http theme={null} GET https://www.ashtechpay.com/v1/auto-conversion-rules?user_id=VOTRE_USER_ID Authorization: Bearer ASHTECH_API_KEY ``` Supprimer une règle : ```http theme={null} DELETE https://www.ashtechpay.com/v1/auto-conversion-rules/RULE_ID?user_id=VOTRE_USER_ID Authorization: Bearer ASHTECH_API_KEY ``` La suppression empêche les conversions automatiques futures; elle n'annule pas une conversion déjà en attente. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.