Content
Use the notification URL
We recommend using the notification URL. This URL is to be provided in the "doWebPayment" web service as an entry in the "<notificationURL>" tag.
The notification URL allows you to be informed of the completion of a payment attempt on your pages to be able to fetch the result of the transaction by calling the "getWebPaymentDetails" web service.
In case the automatic return to the shop did not work, the notification alerts you so that you can pick up the result of the transaction.
Return URL
The url of return is the url back to the shop at the end of the web transaction. Do not confuse with the acceptance URL.
Cancel URL
The cancel url is a return url to the shop when the buyer, once arrived on the payment page, changes his mind and clicks the cancel button before having entered his card number.
What web service to call when you are notified?
| NotificationType value | Trigger of notification | Parameters sent in the URL | Stopping the notification | |
|---|---|---|---|---|
| WALLET | Editing a portfolio from the CA | walletId contractNumber | Call getWallet | |
| Creation of a portfolio from the TPEV | ||||
| Appel createWallet | ||||
| Appel updateWallet | ||||
| TRS | Transaction creation from the CA | transactionId | Call getTransactionDetails | |
| Validation of an authorization (partial or not) from the CA | ||||
| Application for authorization on the TPEV | ||||
| Appeal ofAuthorization | ||||
| TRSWALLET | Portfolio payment on the VPEZ | transactionId walletId | Call getTransactionDetails | |
| Wallet payment from the InterfaceBatch batch | ||||
| CallImmediateWalletPayment | ||||
| Call doSheduledWalletPayment | ||||
| WEBTRS | Call doWebPayment | token | Call getWebPaymentDetails | |
| WEBWALLET | Appel createWebWallet Appel updateWebWallet Apple manageWebWallet | token | Call getWebWallet | |
| BILL | Recurring payment deadline | paymentRecordId walletId transactionId billingRecordDate orderRef | Call getPaymentRecord | |
| ALERT | Fraud notification | alertId transactionId ruleName transactiondate | Apple getAlertDetails | notificationType= |
Web service : doWebPayment
The doWebPayment function allows you to initialize a web payment transaction before redirecting your customer to the Payline payment pages. It allows to make cash payments, immediate or deferred, payments in Nfois or by subscription
To be informed of your customer's payment once the authorization request has been accepted and even if it does not return to your site by itself, you must enter the "notificationURL" field on your point of sale configuration or when your request to initialize a web payment. Payline contacts a page of your site and sends you the payment token as a GET parameter of the HTTP request. This page must be accessible over the Internet using the HTTP / S protocol.
Upon receipt of a notification, your site must make a request for result of the notified web payment.
If your site is not reachable, Payline makes an attempt every minute for 2 hours. After this time, notification of this payment is disabled. You will find your payments in the web interface of the Merchant Administration Center.
returnURL | URL on which the buyer's browser is redirected after validation of payment on Payline. | Yes | AN255 | http: // ... or https://... |
for example: For a doWebPayment, the notification type is WEBTRS and the web service to call is getWebPayment detail to get the result of the web transaction. In this case, the complete notification URL will be:
http: // URL_DE_NOTIFICATION NOTIFICATIONTYPE = webtrs & token = TOKEN_LORS_DU_DOWEBPAYMENT?