Steps
- Application for connection
In the morme applications form for "VM" a technical specialist of the integrator must be declared. - Passing the test scenarios
Because The agent will use the implementation of the integrator, immediately put the business process to the stage of passing the test scenarios. - Signing of the contract of EDS
Sign the contract electronically - Access to production environment
Get access to the production environment and complete integration - Maintenance
Use the all of capabilities of the S7 Agent API and stay tuned for a new features!
Target period ~ 3 working days
Anchor | ||||
---|---|---|---|---|
|
Environment
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Contact to manager of your region and request for an application form at vm@s7.ru
Fill in the application form with a link to your portal and send it to S7 manager
- S7 checks your form and initiates registration in our systems, including JIRA for communication with our technical support
- Receive JIRA account To register in jira, you must provide the contact information of the representative Agent. Receive JIRA account credentials from S7 and follow steps follow steps for connection to JIRA
Anchor | ||||
---|---|---|---|---|
|
fdgdfgdfgdfgdfgdfgdfgdfg///////////////////////////////////////
Panel | ||
---|---|---|
| ||
Menu → Preferences → Advanced → ViewCertificates → Your Certificates → Import → Choose created key store file (*.p12) on previous step |
Panel | ||
---|---|---|
| ||
Settings → Advanced Settings → HTTPS/SSL → Import → Choose created key store file (*.p12) on previous step |
2. For a better experience, we prefer to use SoapUI for testing:
Panel |
---|
Download the last binary version of SoapUI at https://www.soapui.org/downloads/soapui.html and install software |
3. Open SoapUI and create a new SOAP project
Panel |
---|
|
4. Assign created key store file to the project
Panel |
---|
Do not use global settings (SoapUI → File → Preferences → SSL Setting) to save ability of using both environments without any additional setting changes |
5. Create new request and set basic authentication
Panel |
---|
You have to set it for all your requests |
6. Set assigned keystore
Panel |
---|
You have to set it for all your requests |
7. Set the endpoint of test environment at the top of request window
8. Fill in the request textarea by an example described below and send it!
Passing the test scenarios
9. If you have no results, try to check your connection to exclude the case of incorrect credentials before you contact to our technical support by JIRA.
Panel |
---|
|
1. Choose one of available versions at test environment at the top of the page
2. Use header's parameters for selected version (If the parameter is not defined, the oldest version will be used by default):
3. Read the API's documentation
4. Try to execute the user story with the simplest flow and then other scenarios that you are interested in
Panel |
---|
|
5. Give us a feedback through your manager or our technical support by JIRA
6. Ready to production environment? Notify our technical support by JIRA for final testing under the supervision of our technologists- Because the Agent will use the implementation of the integrator, we immediately proceed to the stage of passing testing scenarios.
Агенту не выпускаем сертификат на qa площадку. все операции на qa среде производит интегратор своим сертом и реквизитами доступа. - You start a task on the passage of the Test scenario
расскажи о том что есть 2 flow
Без 3д и с 3д.
Communication at all stages of the test scenarios is done with the help of a technical specialist integrator.
Anchor | ||||
---|---|---|---|---|
|
3: Signing of the contract of EDS
1. Contact with your account manager to sign a contract
2. Create a new validator (without transactions history) for our GDS to have ability to execute all basic shopping scenarios
3. If you are interesting in discounts for corporate client you have to enter into 3D agreement between Agent, S7 and corporate client
Panel |
---|
As a result Agent ID and Client ID will be defined in 3D agreement. They are required to execute scenarios with 3D Agreement |
4. Once all the documents have been completed, your account manager will notify you when you can proceed to the production environment
Anchor | ||||
---|---|---|---|---|
|
4: Access to production environment
Create a new certificate for production environment (similar as for test environment but the new one — check Step 2 for more details):
- Create private key
- Create a request for SSL certificate
- Fill in the details of the request for SSL certificate
- Create a new task with the request of SSL certificate (request_csr) by JIRA
- Receive credentials for production environment from our technical support:
- a SSL certificate (*.crt file)
- personal credentials for basic authentication (login and password)
- access parameters for requests (XML block Party)
- Client ID and Agent ID (only If you are entered into 3D agreement)
- Import SSL certificate and create key store file
Anchor | ||||
---|---|---|---|---|
|
5: Maintenance
1. Choose one of available and tested versions at production environment at the top of the page
2. Use header's parameters for tested selected version (If the parameter is not defined, the default version will be executed):
3. Try to use read operations to check the correctness of your first bookings (read operation) and issued tickets (retrieveTicket operation)
Note |
---|
Avoid making mistakes in the production environment due to the penalties specified in the signed contract! |
4. Don't forget to check our updates!
Panel |
---|
|
Info |
---|
If you still have any questions, try to find an answer using our FAQ and documentation or ask for technical support by JIRA or email at api.support@s7.ru |