Cas d'utilisation
- Comment proposer à l'acheteur d'enregistrer sa carte
- Comment faire un enregistrement de carte sans paiement
- Paiement one-clic : proposer la liste des cartes enregistrées
- Paiement one-clic : préremplir le formulaire avec une carte enregistrée
Chacun de ces cas d'utilisation sont directement gérés depuis la première étape du paiement. C'est à dire, au moment de l'envoi de la requête Charge/createPayment
.
Comment proposer à l'acheteur d'enregistrer sa carte
Si vous souhaitez proposer à l'acheteur d'enregistrer sa carte, il est nécessaire de :
- Renseigner l'e-mail de l'acheteur dans le
Charge/createPayment
, - Renseigner la référence acheteur (cela est très fortement recommandé, cette référence pourra ensuite être utilisée pour le paiement one-clic),
- Envoyer le paramètre
formAction : ASK_REGISTER_PAY
.
Il est de la responsabilité du marchand de s'assurer de l'unicité de la référence acheteur.
Exemple de requête :
{
"amount": ...,
"currency": ...,
"orderId": "myOrderId",
"formAction" : "ASK_REGISTER_PAY",
"customer": {
"reference": "cust-25634",
"email": "joh.doe@mail.com"
}
}
Lorsque l'acheteur entre sa carte dans le formulaire de paiement, si la carte est éligible à l'enregistrement, il aura alors automatiquement la possibilité d'enregistrer sa carte en cochant la case prévue à cet effet. Si l'acheteur coche la case et que le paiement est réussi, la réponse contiendra l'identifiant de l'alias créé qui sera utilisable pour préremplir le formulaire de paiement.
Comment faire un enregistrement de carte sans paiement
Si vous souhaitez enregistrer une carte mais sans faire de paiement, il est nécessaire de :
- Appeler le WS
Charge/createToken
à la place deCharge/createPayment
, - Renseigner l'e-mail de l'acheteur dans la requête
Charge/createToken
, - Renseigner la référence acheteur (cela est très fortement recommandé, cette référence pourra ensuite être utilisée pour le paiement one-clic).
Dans ce cas, l'utilisateur pourra enregistrer sa carte sans faire de paiement. La gestion des erreurs reste la même.
Paiement one-clic : proposer la liste des cartes enregistrées
Si vous souhaitez proposer la liste des cartes enregistrées, il est nécessaire de:
- Vous assurer que les cartes que vous enregistrez sont associées avec la référence acheteur, c'est à dire le paramètre
customer.reference
. - Renseigner le paramètre
customer.reference
dans le Web ServiceCharge/createPayment
. - Valoriser, lors des paiements, le champ formAction à CUSTOMER_WALLET dans la requête
Charge/createPayment
.
{
"amount": ...,
"currency": ...,
"orderId": "myOrderId",
"formAction": "CUSTOMER_WALLET",
"customer": {
"reference": "cust-25634",
"email": "joh.doe@mail.com"
}
}
Si une ou plusieurs cartes ont été enregistrées sur votre société avec la référence acheteur passée en paramètre, alors elles seront automatiquement proposées à l'acheteur dans le formulaire de paiement.
L'acheteur a aussi la possibilité de payer avec une autre carte.
Grâce au paramètre formAction : CUSTOMER_WALLET
, il pourra enregistrer cette nouvelle carte.
Paiement one-clic : préremplir le formulaire avec une carte enregistrée
Cela signifie que lorsque vous enregistrez une carte, vous avez récupéré l'identifiant de l'alias de la carte dans la réponse du SDK. L'identifiant de l'alias est renseigné dans le paramètre transaction.paymentMethodToken
.
Il est alors possible de le passer dans la requête Charge/createPayment
dans le paramètre : paymentMethodToken
.
{
"amount": ...,
"currency": ...,
"orderId": "myOrderId",
"paymentMethodToken": "268431681321684321681"
}
Le SDK affichera alors un formulaire de paiement prérempli en lecture seule, l'acheteur devra alors simplement saisir le CVV si celui ci est nécessaire.