Transfert via Transaction ou PaymentRequest

Contrairement aux transferts indépendants, réservés aux Agents (pour les comptes de paiement) et aux Distributeurs de Monnaie Électronique (DME) (pour les comptes de monnaie électronique), les transferts via transaction sont accessibles à l’ensemble des modèles de partenariat, y compris aux Partenaires Techniques non régulés.

Dans ce cadre, le partenaire transmet à CentralPay, au moment de la création d’une transaction (par carte, virement ou prélèvement), des données commerciales contextualisées (ex. : montant du panier, commission, identifiants des wallets destinataires…)

ℹ️ L’appel API ne crée pas directement le mouvement financier : CentralPay instruit le transfert de manière autonome, après validation effective de la transaction (capture d’une opération carte, réception d’un virement, ou exécution d’un prélèvement SEPA).

Le modèle de transfert conditionné permet de réaliser un mouvement de fonds à l’issue d’une transaction : carte, virement (SCT), ou prélèvement (SDD). Dans ce cas, le transfert est directement paramétré lors de la création de la transaction, via un champ dédié transfer[].

Cette méthode ne passe pas par l’endpoint /transfer, mais s’appuie sur les endpoints spécifiques des transactions concernées :

• /transaction pour les paiements par carte : Voir comment créer une transaction CARD ➝
• /sctTransaction pour les virements reçus : Voir comment créer une transaction SCT ➝
• /sddTransaction pour les prélèvements SEPA : Voir comment créer une transaction SDD ➝
• /paymentRequest pour les demandes de paiement : Voir comment créer une demande de paiement ➝

Ce mode de fonctionnement garantit que les fonds sont uniquement transférés si la transaction est réussie. Le transfert devient alors une étape automatisée et synchronisée.

1. Conditions d’utilisation

• Le transfert est créé en même temps que la transaction (pas d’appel distinct)
• Il n’est exécuté qu’en cas de succès de la transaction source
• Il respecte les contraintes de la source (statut, solde disponible, date…)
• Il peut être instantané ou différé via le champ escrowDate

2. Paramétrer un transfert dans une transaction

Dans les quatre cas de figure, la logique est identique : un tableau transfer[] est renseigné dans le corps de la requête lors de l’appel POST de création de la transaction.

Les champs acceptés dans transfer[] sont les suivants :

Champ	Type	Obligatoire	Description
destinationWalletId	UUID	✅ Oui	Compte CentralPay bénéficiaire. Doit appartenir à un marchand participant autorisé.
amount	Integer	✅ Oui	Montant du transfert en centimes.
currency	String	❌ Non	Devise du transfert (si différente de la devise de la transaction).
merchantTransferId	String	❌ Non	Référence partenaire.
fee	Integer	❌ Non	Frais applicables (prélevés sur le montant brut).
escrowDate	Date ISO	❌ Non	Date différée d’exécution (si applicable).
transferGroup	String	❌ Non	Identifiant de groupe pour les suivis agrégés.
description	String	❌ Non	Libellé du transfert visible sur les relevés.
additionalData	KV pairs	❌ Non	Données métier structurées (clé/valeur).

⚠️ Les règles de disponibilité des fonds (notamment après délai de capture ou de validation) doivent être respectées. Si la transaction est annulée ou échoue, aucun transfert n’est déclenché.