À propos de Rapid Transfer
Rapid Transfer est un mode de paiement pour le transfert bancaire en temps réel fourni par Skrill, une solution de portefeuille numérique Paysafe, pour des transactions rapides et faciles à partir de plus de 170 banques du monde entier exerçant dans plus de 18 pays, par lesquelles vous pouvez déposer de l'argent dans votre portefeuille Skrill ou payer en ligne.
Pour accéder à ce service de compte, les marchands doivent être intégrés à la solution Skrill.
L'API Paiements répond aux besoins suivants pour Rapid Transfer :
- Instrument de paiement : Rapid Transfer
- Mode de paiement : virement bancaire en temps réel
- Devises : disponible dans plus de 18 pays
Exigences de configuration
Pour que Paysafe puisse créer un compte de test dans l’environnement de bac à sable et dans l’environnement de production, nous avons besoin des informations suivantes.
- Skrill Pay du marchand par courriel
- Mot de passe de l’API/MQI du compte Skrill du marchand
Types de transaction
Types de transactions : paiements, remboursements, retraits
Diagramme de flux
Scénarios habituels
1. Paiements par Rapid Transfer
Pour traiter une transaction à l’aide de Rapid Transfer, veuillez effectuer les étapes suivantes :
-
Créez un "payment handle" avec le paramètre transactionType défini sur PAYMENT et le paramètre paymentType défini sur RAPID_TRANSFER en utilisant l’API "Payment Handles".
-
Post : paymenthub/v1/paymenthandles
-
-
Le client doit compléter l’authentification du paiement en fournissant ses données bancaires. Paysafe renvoie une réponse spécifiant ce qui suit :
-
Le paramètre action est défini sur REDIRECT
-
Un lien payment_redirect pointe vers l’URL de redirection de la page Skrill
-
L’état du "payment handle" sera à l’étape INITIATED.
-
-
Après avoir été redirigé vers la page Skrill à l’aide du lien payment_redirect, l’utilisateur doit fournir l’IBAN ainsi que son prénom et son nom pour continuer sur la page Rapid Transfer.
-
L’utilisateur peut sélectionner la banque sur la page Rapid Transfer, puis se connecter pour terminer la transaction.
-
Une fois la transaction terminée, l’utilisateur est redirigé vers la page de succès ou d’échec du marchand, en fonction de l’état de la transaction.
-
Si la transaction aboutit, l’état du "payment handle" passe à PAYABLE; si elle échoue, il passe à FAILED. Le marchand est informé de ce changement d’état par le biais d’un webhook configuré.
-
Utilisez le paymentHandleToken renvoyé dans la réponse pour traiter la requête de paiement.
-
paymenthub/v1/payments
-
Le paymentId renvoyé dans la réponse doit être stocké côté marchand pour un usage ultérieur, puisque paymentId est nécessaire pour que les remboursements et les retraits soient directement déposés sur le compte bancaire utilisé pour la transaction initiale.
API à utiliser
2. Retrait/crédits autonome via Rapid Transfer
Voici les étapes à suivre pour effectuer une opération de retrait à l’aide de Rapid Transfer :
Une fois qu’un paiement a été effectué par le biais du service Rapid Transfer, l’utilisateur peut uniquement effectuer un retrait auprès de la banque par laquelle le paiement a été effectué. Plusieurs banques peuvent être utilisées, et le retrait sera effectué auprès de la banque dont l’identifiant de paiement est indiqué dans la requête.
-
Créez un "payment handle" avec le paramètre transactionType défini sur STANDALONE_CREDIT et le paramètre paymentType défini sur RAPID_TRANSFER en utilisant l’API "Payment Handles".
-
Post : paymenthub/v1/paymenthandles
-
-
L’objet RAPID_TRANSFER de la requête nécessitera 5 paramètres :
-
En réponse, un jeton à usage unique est reçu avec la balise paymentHandleToken et l’état est PAYABLE. Ce jeton est ensuite transmis à l’API Crédits autonomes.
-
POST: paymenthub/v1/standalonecredits
-
-
La réponse finale contiendra les données de la transaction avec des paramètres tels que id – identifiant unique côté Paysafe et gatewayReconciliationId – identifiant unique côté Skrill, et l’état de la transaction qui peut être utilisé pour des références ultérieures.
-
L’état du retrait sera initialement à l’état PENDING et passera à COMPLETED une fois le remboursement effectué sur le compte bancaire de l’utilisateur; à chaque étape, un webhook sera envoyé au marchand.
Paramètre | Description |
|---|---|
| consumerId | Identifiant unique de l’utilisateur utilisé pour identifier son compte chez Skrill |
| countryCode (facultatif) | Code de pays unique à deux chiffres permettant d’identifier la zone d’activité d’un compte bancaire et la devise. |
| emailSubject | Objet personnalisé du courriel qui sera envoyé à l’utilisateur pour l’informer des détails de la transaction. |
| emailMessage | Corps personnalisé du courriel qui sera envoyé à l’utilisateur pour l’informer des détails de la transaction. |
| paymentId | Il s’agit de l’identifiant de paiement de la transaction précédente qui permet d’extraire les données bancaires et de transférer les fonds sans que l’utilisateur n’ait à fournir à nouveau ces informations. Cela permet d’éviter les transactions frauduleuses, car seuls les comptes utilisés pour les dépôts doivent être utilisés pour les retraits. |
API à utiliser
3. Remboursements via Rapid Transfer
Voici les étapes à suivre pour traiter une transaction de remboursement à l’aide de Rapid Transfer :
Une transaction de remboursement ne peut être initiée que par le marchand et pour une transaction dont le règlement/paiement est terminé.
-
Une fois que le paiement est effectué, c’est-à-dire que l’état est COMPLETED dans la réponse aux informations de paiement, le remboursement peut être initié à l’aide de l’identifiant de paiement.
-
Créez une requête de remboursement à l’aide de l’API Remboursements
-
POST : /paymenthub/v1/settlements/{paymentId}/refunds
-
-
La requête portera sur un montant, qui peut être égal à celui des paiements, ou être un remboursement partiel d’un montant inférieur à celui des paiements.
-
Plusieurs remboursements partiels peuvent être effectués jusqu’à ce que la somme totale soit inférieure au montant du paiement initial.
-
La réponse contiendra les détails du paiement effectué et un identifiant unique qui pourra servir de référence à chaque remboursement individuel, qu’il soit partiel ou total.
-
L’état du remboursement sera initialement défini sur PENDING et passera à COMPLETED une fois le remboursement effectué sur le compte bancaire de l’utilisateur; à chaque étape, un webhook sera envoyé à marchand.