Création d'un alias avec paiement
Documentation API : Charge/CreatePayment
Requête
- Création automatique d'un alias.
Exemple de requête
Champs obligatoires :
- montant : 10 000 XPF.
- email de l'acheteur : "sample@example.com".
- formAction :
REGISTER_PAY.
Champs recommandés :
- Référence de la commande : "myOrderId-1234".
- Référence de l'acheteur : "myCustomerRef-123456".
{
"amount": 990,
"currency": "XPF",
"customer": {
"email": "sample@example.com",
"reference": "myCustomerRef-123456"
},
"orderId": "myOrderId-1234"
}Pour connaître l'intégralité et la description des champs, consultez le playground : Charge/CreatePayment (menu à gauche).
- Proposition à l'acheteur de créer un alias
Exemple de requête
Champs obligatoires :
- montant : 10 000 XPF.
- email de l'acheteur : "sample@example.com".
- formAction :
ASK_REGISTER_PAY.
Champs recommandés :
- Référence de la commande : "myOrderId-1234".
- Référence de l'acheteur : "myCustomerRef-123456".
{
"amount": 990,
"currency": "XPF",
"customer": {
"email": "sample@example.com",
"reference": "myCustomerRef-123456"
},
"formAction": "ASK_REGISTER_PAY",
"orderId": "myOrderId-1234"
}Pour connaître l'intégralité et la description des champs, consultez le playground : Charge/CreatePayment (menu à gauche).
Réponse
Récupèrez le formToken pour afficher le formulaire de paiement (Plus d'infos : Afficher le formulaire).
A la fin du paiement, une transaction de type DEBIT sera créée. L'alias sera retourné dans transactions[0].paymentMethodToken (Plus d'infos : Analyser le résultat du paiement)
Exemple de réponse
{
"shopId": "123456",
"orderCycle": "CLOSED",
"orderStatus": "PAID",
"serverDate": "2023-10-20T13:53:41+00:00",
(...)
"_type": "V4/OrderDetails"
},
(...)
"transactions": [
{
"shopId": "123456",
"uuid": "b72e91826ce14bfd802249d16eb30849",
"amount": 990,
"currency": "XPF",
"paymentMethodType": "CARD",
"paymentMethodToken": "b6e51ba31f934ac5b25ccad2a52ccd56",
"status": "PAID",
"detailedStatus": "AUTHORISED",
"operationType": "DEBIT",
"effectiveStrongAuthentication": "DISABLED",
(...)
"_type": "V4/Payment"
}Dans cet exemple, l'alias (champ paymentMethodToken) a pour valeur : "b6e51ba31f934ac5b25ccad2a52ccd56".
Pour connaître l'intégralité et la description des champs, consultez le playground : answer/Payment.