Contents
Sommaire | ||||
---|---|---|---|---|
|
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 a company number (SIRET) 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 informationCompany :
- Company name: name of your company declared in the commercial register ;
- Company Number declared in the commercial register .(SIRET) ;
- Commerciale email and technical email.Email address of the commercial and technical correspondent
- User account :
- User name and first name ;
- Email Email Address: This e-mail address will be used as the user ID on the Merchant Payline 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 allowsYou will receive by email your merchant ID, a password and MerchantAccessKey. Your merchant ID and access key allow your servers to communicate with Payline servers.
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"
User
- To protect your account, choose a password. 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.
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. payment.
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 on "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 You can test your configuration by downloading package on the www.payline.com website.
The sample pages are available in integration kit and are available for PHP, .NET and JAVA platforms .in Kit and eModule menu
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 method is offered. For more information, please refer to back office User Manualdocumentation.
- 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 accepte or refusal of refuse 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 transaction 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, transaction identifier and authorization number.
If you need help with this that 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 modules that offers the Payline payment solution is available upon request from Payline Technical Support.
- Integration kit : an easy installation
Integrate Payline with a integratio 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 interface client interface with secure standard web services (Web page or Direct).
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
configurationconfiguration