Service Coffre-fort client
Remarque : En tant que partenaire ISV/Paysafe, vous devrez effectuer toutes les étapes « marchand » ci-dessous au nom de l’entité juridique mère des marchands (PMLE) sous laquelle vos marchands exerceront leurs activités.
Pour pouvoir créer des jetons à usage unique afin de traiter des transactions dans votre application, vous avez besoin de deux composants : API Client Paysafe et service Coffre-fort client.
Initialiser l’API Client Paysafe
Veuillez vous reporter ici pour de plus amples renseignements.
Initialiser le service Coffre-fort client
Le service Coffre-fort client utilise l’API interne Coffre-fort client pour créer différents types de jetons à usage unique qui peuvent être utilisés pour traiter les transactions dans votre application.
Voici un exemple de création d’une instance du service Coffre-fort client :
customerVaultService = new CustomerVaultService.Builder()
.withApiClient(client) // le client de l’étape précédente
.build();
Créer des jetons à usage unique
Vous pouvez créer deux types de jetons : le jeton à usage unique de la carte et le jeton à usage unique de Google Pay.
Vous devez générer un nouveau jeton à usage unique pour chaque transaction par carte ou Google Pay que vous souhaitez traiter. Les jetons à usage unique ne sont valides que 15 minutes et ne sont pas consommés par la vérification.
Une fois qu’un jeton à usage unique est reçu de l’API Coffre-fort client, il doit être envoyé au serveur du marchand. Le marchand doit ensuite l’inclure dans la requête de paiement envoyée à l’API Paiements par carte (en utilisant la clé API pour les appels API de serveur à serveur).
Créer un jeton de carte à usage unique
Vous devez transmettre l’objet SingleUseTokenParams qui contient des informations sur le titulaire de la carte, les données de la carte et l’adresse de facturation à la méthode createSingleUseToken() du service Coffre-fort client.
La méthode createSingleUseToken() transmettra un appel au CustomerVaultCallback fourni lorsque la génération du jeton de carte à usage unique est terminée.
customerVaultService.createSingleUseToken(
new SingleUseTokenParams.Builder()
.withCard(new SingleUseTokenParams.Card.Builder()
.withHolderName("Danail Alexiev")
.withCardNumber("4000 0000 0000 1091")
.withCardExpiry(new CardExpiry.Builder()
.withMonth(10)
.withYear(2022)
.build()
)
.withBillingAddress(new BillingAddress.Builder()
.onStreet("Address1")
.onStreet2("Address2")
.inCity("Sofia")
.inCountry("Bulgaria")
.inState("Sofia")
.withZip("1000")
.build())
.build())
.build(),
new CustomerVaultCallback<SingleUseToken>() {
@Override
public void onSuccess(@NonNull SingleUseToken token) {
// envoyez le jeton à usage unique généré à votre serveur dorsal
}
@Override
public void onError(@NonNull Error error) {
// Traitez l’erreur
}
});
Créer un jeton Google Pay à usage unique
Vous devez transmettre l’objet GooglePayTokenParams qui contient les informations de paiement générées à partir de l’appareil Android pour que Google Pay crée la méthode GooglePayPaymentToken() du service Coffre-fort client.
La méthode createGooglePayPaymentToken() lancera un appel au CustomerVaultCallback fourni une fois la génération du jeton à usage unique Google Pay terminée.
customerVaultService.createGooglePayPaymentToken(
new GooglePayTokenParams.Builder()
.withToken(new GooglePayTokenParams.GooglePayPaymentToken.Builder()
.withProtocolVersion(GooglePayTokenParams.GooglePayPaymentToken.PROTOCOL_EC_V1)
.withSignedMessage("message")
.withSignature("signature")
.build())
.build(),
new CustomerVaultCallback<GooglePaySingleUseToken>() {
@Override
public void onSuccess(@NonNull GooglePaySingleUseToken token) {
// envoyez le jeton à usage unique généré à votre serveur dorsal
}
@Override
public void onError(@NonNull Error error) {
// Traitez l’erreur
}
});