Table of contents
Integration of the EC touch point with Checkout
In the case of Payment at the EC’s frontend, the pagoPA platform is integrated by means of Checkout, which is a web application that permits every user to navigate the payment instruments made available by the PSPs registered with the pagoPA platform.
Checkout navigation can take place only in Guest mode, and an email is requested for sending the outcome of the transaction.
.png)
Integration with Checkout is activated by means of a redirect triggered via a POST call, specifying the following parameters:
- emailNotice: email address to which to send the payment receipt, it can be changed during the payment process
- idCart: identifier of the cart attributed to the creditor, the parameter is entered when activating the paymentNote tag of paGetPayment
- returnUrls: return addresses to the creditor site
- returnOkUrl: cases of success
- returnCancelUrl: cases of cancellation
- returnErrorUrl: cases of error
- an array of the notices to pay, with a maximum number of 5, and the following must be specified for each
- noticeNumber: number of the notice
- fiscalCode: fiscal code of the creditor
- amount: amount of the payment notice (in hundredths of a euro)
- companyName: name of the creditor
- description: description of the payment
- allCCP: by setting it to TRUE, the creditor communicates to the pagoPA platform that all transfers of the notice can be associated with the postal IBAN, the paGetPayment that the creditor receives for the activation of the current notice will contain the parameter transferType set to POSTAL.
An HTTP Status 302 is obtained as a response to that call, which instructs the user’s browser to redirect to the page where to proceed with the payment.
When the payment session has ended, the user is returned to the url indicated by the EC based on the payment outcome.
Checkout will be displayed in the language set in the user’s browser. If the language is not supported, Italian will be used. The user can change the language at any moment.
The development of the Checkout follows the design guidelines for the PA digital services.
In particular, compatibility is ensured with browser versions that have an average penetration among the population of at least 1 person for every 100 residents.
This means that with the data available to this date, the following browsers are supported:
- Chrome
- Safari
- Firefox
- Samsung Internet Browser
- Edge
- Opera
Tell us what you think
For clarifications on implementation specifications, such as SACI and SANP, you can open an issue on GitHub