VIP Preferred

L’API Paiements Paysafe prend en charge VIP Preferred en tant qu’instrument de paiement. Vous pouvez traiter les paiements VIP Preferred à l’aide de l’API Paiements.

Lorsque vous souhaitez traiter une requête de paiement VIP Preferred, vous devez procéder comme suit :

1. Créez un gestionnaire de paiement avec le paramètre transactionType défini sur PAYMENT et le paramètre paymentType défini sur VIPPREFERRED.
2. Paysafe renvoie la réponse suivante :
   • Le paramètre action est défini sur REDIRECT
   • Un lien payment_redirect qui pointe vers l’URL de la page hébergée de VIP Preferred
3. Vous pouvez soit intégrer la page hébergée dans votre propre solution de paiement personnalisée, soit rediriger le client vers l’URL de la page hébergée dans un autre onglet.
4. Les interactions sur la page hébergée sont gérées par Paysafe et en cas de paiement réussi, nous vous informerons sur le paramètre on_completed inclus dans votre requête.
5. À ce stade, l’état du Payment Handle passe à PAYABLE.
6. Utilisez le jeton paymentHandleToken renvoyé dans la réponse pour traiter la demande de paiement.

Une fois la demande de paiement complétée avec succès, les fonds sont immédiatement transférés sur le compte du marchand.

1. Faites un appel de vérification :
   • Créez un gestionnaire de paiement avec le paramètre transactionType défini sur VERIFICATION et le paramètre paymentType défini sur VIPPREFERRED.
   • Vous pouvez utiliser soit l’Identifiant d’enregistrement ou le SSN du client.
   • Vous recevrez « paymentHandleToken » (appelé Gestionnaire de paiement) dans la réponse. La réponse doit également comporter un « état » (appelé « état du gestionnaire de paiement ») qui est PAYABLE.
   • Utilisez le « paymentHandleToken » pour traiter l’API Vérification.
   • Dans la réponse de l’API Vérification, vous obtiendrez l’état COMPLETED, vous obtiendrez un bankToken pour chaque compte enregistré.
     • Si l’utilisateur n’est pas enregistré, vous obtiendrez l’état FAILED. Vous pouvez enregistrer l’utilisateur à l’aide de l’API Enregistrement
   • Enregistrez le paymentToken de votre côté.
   • Le BankToken (vippreferred.achBankAccounts.paymentHandleToken) est un identifiant unique pour chaque compte bancaire de l’utilisateur et reste le même. Le BankToken est ensuite utilisé pour créer un jeton de paiement à usage unique qui sert à effectuer le paiement pour chaque transaction unique.
2. Créez un gestionnaire de paiement avec :
   • Le paramètre transactionType défini sur PAYMENT et le paramètre paymentType défini sur VIPPREFERRED.
   • Transmettez le registrationId ou le consumerid avec le bankToken dans l’objet vippreferred.
3. Vous recevrez « paymentHandleToken » (appelé Gestionnaire de paiement) dans la réponse. La réponse doit également comporter un « état » (appelé « état du gestionnaire de paiement ») qui est PAYABLE.
4. Utilisez le PaymentHandleToken renvoyé dans la réponse du gestionnaire de paiement pour traiter le paiement.

Lorsque vous souhaitez traiter une requête de retrait VIP Preferred, vous devez procéder comme suit :

1. Créez un gestionnaire de paiement avec le paramètre TransactionType défini sur STANDALONE_CREDIT et le paramètre paymentType défini sur VIPPREFERRED.
2. Paysafe renvoie la réponse suivante :
   • Le paramètre action est défini sur REDIRECT
   • Un lien de redirection de paiement qui pointe vers l’URL de la page hébergée VIP Preferred
3. Vous pouvez soit intégrer la page hébergée dans votre propre solution de paiement personnalisée, soit rediriger le client vers l’URL de la page hébergée dans un autre onglet.
4. Les interactions sur la page hébergée sont gérées par Paysafe, et en cas de paiement réussi, nous vous informerons sur le paramètre completed inclus dans votre requête.
5. À ce stade, l’état du Payment Handle passe à PAYABLE.
6. Utilisez le jeton paymentHandleToken renvoyé dans la réponse pour traiter la requête de retrait.
7. Une fois la demande de paiement complétée avec succès, les fonds sont immédiatement transférés sur le compte du marchand.

• Si vous souhaitez appliquer vos propres règles de risque avant le retrait, procédez comme suit :

Le BankToken (vippreferred.achBankAccounts.paymentHandleToken) est un identifiant unique pour chaque compte bancaire de l’utilisateur et reste le même. Le BankToken est ensuite utilisé pour créer un jeton de paiement à usage unique qui sert à effectuer le paiement pour chaque transaction unique.

• Effectuez un appel à l’API Vérification :
  1. Créez un Payment Handle avec le paramètre transactionType défini sur VERIFICATION et le paramètre paymentType défini sur VIPPREFERRED.

     • Vous pouvez utiliser soit l’Identifiant d’enregistrement ou le NAS du client.

  2. Ce Payment Handle doit immédiatement avoir l’état PAYABLE.

  3. Utilisez le jeton paymentHandleToken renvoyé dans la réponse pour traiter la requête de vérification.

  4. Dans la réponse de l’API Vérification, vous obtiendrez un paymentToken/bankToken pour chaque compte enregistré.

  5. Enregistrez les paymentTokens de votre côté.

• Effectuez des vérifications des risques de votre côté. Une fois les contrôles de risques effectués, passez aux étapes suivantes :

  1. Créez un Payment Handle avec le paramètre transactionType défini sur STANDALONE_CREDIT et le paramètre paymentType défini sur VIPPREFERRED.

  2. Transmettez le paymentToken reçu dans l’API Vérification.

  3. Ce Payment Handle doit immédiatement avoir l’état PAYABLE.

  4. Utilisez le jeton paymentHandleToken renvoyé dans la réponse pour traiter la requête de retrait.

  5. Une fois la demande de paiement complétée avec succès, les fonds sont immédiatement transférés sur le compte du marchand.

Si vous souhaitez enregistrer un nouveau client, procédez comme suit :

1. Appelez l’API Enregistrement en transmettant les données requises sur le client. Un lien de redirection vous sera envoyé.

2. Ouvrez le lien de redirection dans un iFrame.

3. Permettez au client de saisir les autres informations, comme la pièce d’identité, dans un iFrame.

4. Une fois que le client a complété le flux dans un iFrame avec succès, l’enregistrement est terminé.

5. Vous pouvez vérifier l’état d’enregistrement du client en effectuant un appel à l’API Enregistrement à l’aide du registrationId.

Si vous souhaitez enregistrer un nouveau client, vous devez procéder comme suit :

1. Appelez l’API Enregistrement en transmettant les données requises sur le client. 
2. Une réponse contenant les comptes bancaires et les détails nécessaires sera envoyée.
3. Si vous obtenez une réponse positive, l’utilisateur sera enregistré.
4. Vous pouvez vérifier l’état d’enregistrement du client en effectuant un appel à l’API Enregistrement à l’aide du registrationId.

Pour permettre à un client d’ajouter un nouveau compte, procédez comme suit :

1. Appelez l’API Ajout de compte avec les informations requises comme le numéro de compte, le nom de la banque et le numéro d’acheminement.

2. Une fois le traitement terminé, le nouveau compte sera ajouté.

Si vous souhaitez permettre au client de supprimer le compte existant, vous devez procéder comme suit :

1. Effectuez l’opération DELETE sur une API avec le numéro de compte bancaire.

2. Une fois le traitement terminé, le compte sera supprimé.