Contenu
Plus d'information
Activer Alipay sur mon compte
Vous devez vous rapprocher de votre responsable de compte pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (compte profil et compte supplier).
Ensuite veuillez adresser un email à notre équipe support avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.
Contactez le support Monext Online.
Le code du moyen de paiement est ALIPAY_MNXT.
Proposer le paiement Alipay à vos acheteurs
Les principes d'utilisation
Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline en indiquant le contrat du moyen de paiement Contrat_Number.
Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetails.
Les web services en mode web
Les web services selon les fonctions disponibles (vérifier les disponibilités dans le tableau ci dessus) :
Interfaces de paiement : API WebPayment.
Paiement à la commande et portefeuille : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
- Mode de paiement : comptant avec le code Mode = CPT.
- Demande de remboursement d'une transaction remisée : utilisez le service doRefund pour rembourser la commande (délai max de 180 jours).
- Module fraude : règles sur la transaction, l'acheteur et sur le moyen de paiement.
Libellé sur le ticket de paiement
Vous pouvez choisir d'alimenter un libellé sur le ticket de paiement avec le champ payment.softDescriptor du service doWebPayment.
S'il est vide alors le nom d'enseigne du moyen de paiement dans le centre administration sera sélectionné.
Et si ce dernier est vide alors le nom d'enseigne du compte commerçant dans le centre administration sera sélectionné.
Les champs obligatoires
Les champs obligatoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.
| Nom du champ | Exemple |
|---|---|
payment.action | 101 |
payment.mode | CPT |
payment.amount | 1000 |
order.amount | 1000 |
order.currency | 978 |
| buyer.firstname | John |
| buyer.lastname | Doe |
| buyer.email | john.doe@monext.net |
Le montant de la commande doit être égale ou supérieur à la demande de paiement : order.amount >= payment.amount
Réaliser des tests
Sur l'environnement d'homologation (Test), vous êtes connecté à un simulateur vous proposant directement sur l'interface avec deux options :
- Paiement accepté avec un code retour = ACCEPTED - 0000
- toutes les cartes sont acceptées.
- Paiement abandonné avec un code retour = CANCELLED - 02008
Lors du paiement une page du simulateur vous propose deux boutons sur l'environnement d'homologation (TEST) : un succès (MAKE A PAYMENT) et un abandon (ABORT).
Les codes de retour
Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. Les états retournés : La gestion des états et des codes retour sont listés ici.
Les codes du moyen de paiement :
| Code | ShortMessage | LongMessage |
|---|---|---|
| 02012 | ERROR | Unmatched partner return code |
| 02308 | ERROR | Invalid value for |
| 02008 | CANCELLED | Transaction canceled by user |
| 02324 | REFUSED | The session expired before the consumer has finished the transaction |
| 02020 | REFUSED | Transaction refused by partner |
| 02106 | ERROR | Payment partner error |