Contents
Step 1 - Create your account
This step allows you to create a test account in the probate environment required for Payline integration.
You have declared your company in the commercial register, have a SIRET number and a valid email address. Follow the following steps step by step:
To register, send a request to sales@payline.com with
- your company information with special attention to the following information:
- Company name: name of your company declared in the commercial register
- Number declared in the commercial register.
- Email address of the commercial and technical correspondent
- User account :
- User name and first name
- Email Address: This e-mail address will be used as the user ID on the Merchant back office.
- User Password: To protect your account, choose a password that is easy to remember for you but hard to find by another. Never share your password with anyone else. For security reasons your password must contain at least 8 characters consisting of a combination of uppercase, lowercase letters, numbers and special characters such as +,?, *. For example: "Jean-pierre09" is a compliant password.
- Question and secret answer: if you forget the password.
You will receive by email:
- your merchant ID and the associated access key that allows your servers to communicate with Payline servers.
- your user ID and the password that allows you to log in to the Payline Merchant Administration Center.
Step 2 - Set up your account
This step allows you to set up your test account through Payline back office.
- Using your Internet browser, go to the following address: https://homologation-admin.payline.com
- Enter your Merchant ID, User ID and Password and click "Sign In"
Point of sale
- Click on the "Configuration" menu and the "Your points of sale" sub-menu, then click on "your single point of sale" created by default when you create your account. Fill out the form that specifies the expected operation of your point of sale. Note: on this page you can also create new points of sale by clicking on the button "Create a point of sale".
Example for e-commerce site: Fill in form as follows
| yes |
| POS my-site |
| webmaster@mon-site.com |
| French |
| empty |
| |
| empty |
| empty |
| yes |
| yes |
| yes |
| no |
Payment method
Click on the "Configuration" menu and the "Your points of sale" submenu, then click on the "New payment method" button in order to add a new payment method to your "POS my-site" point of sale.
In order to use a new payment method in production, you must first obtain a TPV contract from the bank acquirer. In test environment, no control will be carried out. You are therefore free to test all payment method.
Step 3 - Test immediately with the sample pages provided
This step allows you to ensure that your account is properly configured using downloadable sample pages on the www.payline.com website.
The sample pages are available in integration kit and are available for PHP, .NET and JAVA platforms.
Once the sample pages have been downloaded, you must follow the instructions in the readme.txt file:
- Update your test platform and activate the necessary libraries.
- Install and configure the sample pages with the following items:
- merchantID : You must enter the merchant ID that was communicated to you during your registration.
- merchantAccesskey : You must enter the merchant key that was communicated to you during your registration. If you have lost your access key, you can regenerate a new one on the Payline back office.
- contractNumber : You must enter the VAD contract number you entered when activating a payment method on your merchant account
- proxyInternet : You must specify whether your Internet connection requires the setting of an Internet proxy. If you are testing from a computer connected to a corporate network, you are likely to be connected to the Internet through an Internet proxy. In this case, you only need to specify the DNS name and the port as follows:
proxy = proxy.monentreprise.com
port = 8080
- Start your web server
- Using your Internet browser, go to the url "http: // localhost / payline /". If you use a different port than port 80, you must specify it like this:
- For example: port 9000 to http: // localhost: 9000 / payline /
- On the home page, click on the "web" tab
- Page 1 : The page shown simulates the "Order Summary" page of your e-commerce site. By clicking on the "Start Payment Process" button, it initiates a payment request by transmitting to Payline a unique order reference (order.Ref), an amount multiplied by 100 (order.Amount), the ISO code of the currency ( order.Currency), the means of payment to offer to your customer, etc.
- Page 2 : This page is part of the Payline web payment pages. It allows your customer to choose his payment method. It is customizable to your sign (color, text, logo, etc.) and may not be displayed if only one means of payment is offered. For more information, please refer to back office User Manual.
- Page 3 : Enter on this page the appropriate test card number for the payment method you have selected. If you have selected the VISA card as a payment method, you can use the test card no. 4970 1000 0032 5734 with a valid expiry date and the visual cryptogram 123. You will find in the additional documentation functional specification by card, the Test card number that you must use for cards other than VISA.
- Page 4 : This page informs your customer of the agreement or refusal of payment. Click on the "Finish Payment" button to complete the payment process and simulate the return to the merchant site.
- Page 5 : The page presented allows you to view the return message that you will be able to obtain following a payment web. It retrieves the result of the transaction from Payline by transmitting the authentication token associated with your order. The identifier of the Payline transaction and the authorization number issued in the event of a debit agreement from the purchaser are communicated to you.
If you need help with this test, please contact Payline Support at support@payline.com
Step 4 - Integrate into your application
You can now choose how to integrate the Payline payment solution into your application.
There are three ways to use Payline:
- E-commerce suite: immediate use
Use a Payline certified e-commerce suite and have no integration to make. The list of e-commerce suites that offers the Payline payment solution is available upon request from Payline Technical Support.
- Integration kit: an easy installation
Integrate Payline with a kit. You must have knowledge of HTML and a scripting language such as PHP, C # and Java for the use of the selected integration kit.
- SOAP API: a complete integration
Integrate Payline using the SOAP API. You must master the development of client interface with secure standard web services.
Step 5 - Validate your integration
This step allows you to control that your integration is correct.
- When you registered, you have to receive from our support team, a contrat to sign to confirm yours functional tests.
- Realize a transaction.
- Check the transaction in back office.
Step 6 - Request the activation of your account in production
When you validate the Payline integration in your application, activate your account in production by following :
- Download the general conditions of use of Payline service available on the website www.payline.com
- Return the completed and signed order form to our sales team subscribe@payline.com
- Send your sales contract (s) and Payline contrat signed to Payline support : support@payline.com
Perform pilot production transactions to verify the operation and contracts configuration