Contenu
Utiliser l'URL de notification
Nous vous recommandons l'utilisation de l'URL de notification. Cette URL est à fournir dans le web service « doWebPayment » en entrée dans la balise « <notificationURL> ».
L'URL de notification vous permet d'être informé de la réalisation d'une tentative de paiement sur vos pages pour pouvoir aller chercher le résultat de la transaction par l'appel du web service «getWebPaymentDetails».
Dans le cas où le retour automatique à la boutique n'a pas fonctionné, la notification vous alerte pour que vous puissiez venir chercher le résultat de la transaction.
Return URL
L’url de return est l’url de retour à la boutique à la fin de la transaction web. Ne pas confondre avec l'URL d'acceptation.
Cancel URL
L’url cancel est une url de retour à la boutique quand l’acheteur, une fois arrivé sur la page de paiement, change d'avis et clique sur le bouton annuler avant même d’avoir saisi son numéro de carte.
Quel service web appelé quand vous êtes notifiés ?
| Valeur notificationType | Déclencheur de la notification | Paramètres envoyés dans l’URL | Arrêt de la notification | |
|---|---|---|---|---|
| WALLET | Modification d’un portefeuille à partir du CA | walletId contractNumber | Appel getWallet | |
| Création d’un portefeuille à partir du TPEV | ||||
| Appel createWallet | ||||
| Appel updateWallet | ||||
| TRS | Création de transaction à partir du CA | transactionId | Appel getTransactionDetails | |
| Validation d’une autorisation (partielle ou non) à partir du CA | ||||
| Demande d’autorisation sur le TPEV | ||||
| Appel doAuthorisation | ||||
| Appel doCapture | ||||
| Validation d’une transaction à partir du batch InterfaceBatch | ||||
| TRSWALLET | Paiement par portefeuille sur le TPEV | transactionId walletId | Appel getTransactionDetails | |
| Paiement par portefeuille à partir du batch InterfaceBatch | ||||
| Appel doImmediateWalletPayement | ||||
| Appel doSheduledWalletPayement | ||||
| WEBTRS | Appel doWebPayment | token | Appel getWebPaymentDetails | |
| WEBWALLET | Appel createWebWallet Appel updateWebWallet Appel manageWebWallet | token | Appel getWebWallet | |
| BILL | Échéance de paiement récurrent | paymentRecordId walletId transactionId billingRecordDate orderRef | Appel getPaymentRecord | |
| ALERT | Notification de fraude | alertId transactionId ruleName transactiondate | Appel getAlertDetails | notificationType= |
Web service : doWebPayment
La fonction doWebPayment permet d'initialiser une transaction de paiement web avant de rediriger votre client sur les pages de paiement Payline. Elle permet de realiser des paiements comptants, immediats ou differés, des paiements en Nfois ou par abonnement
Pour être informé du paiement de votre client une fois la demande d'autorisation acceptée et ce même s'il ne revient pas de lui-même sur votre site, vous devez renseigner le champ «notificationURL» sur votre configuration point de vente ou lors de votre demande d'initialisation d'un paiement web. Payline contacte une page de votre site et vous transmet en paramètre GET de la requête HTTP le jeton lié au paiement. Cette page doit être accessible par Internet au moyen du protocole HTTP/S.
A réception d'une notification, votre site doit réaliser une demande de résultat du paiement web notifié.
Si votre site n'est pas joignable, Payline réalise une tentative toute les minutes pendant 2 heures. Après ce délai, la notification de ce paiement est désactivée. Vous retrouverez vos paiements dans l'interface web du Centre d'Administration Commerçant.
returnURL | URL sur laquelle le navigateur de l'acheteur est redirigé après validation du paiement sur Payline. | oui | AN255 | http://... ou https://... |
par exemple: Pour un doWebPayment, le type de notification est WEBTRS et le service web a appeler est getWebPayment detail pour avoir le résultat de la transaction web. Dans ce cas, l'URL de notification complète sera:
http://URL_DE_NOTIFICATION?notificationType=webtrs&token=TOKEN_LORS_DU_DOWEBPAYMENT