Setting up integration with YooMoney

Integration settings

To activate payments, you need to set up integration: connect your website to the YooMoney service and place payment forms.

You can set up integration while filling in the contract details. But first you need to select a payment acceptance method in the contract details (under Payment acceptance section).

Important It's possible to accept payments without integration right away after signing the contract: by customers' accounts from your Merchant Profile or using a mobile terminal

For integration, you can use a ready-made solution or configure it independently using the documentation. To make everything work properly, you'll need an SSL certificate.

Ready-made solution

YooMoney offers ready-made solutions for integration with major systems: payment modules for CMS, SaaS, or frameworks, as well as solutions for CRM and messengers.

How to set up a ready-made solution

You need to specify your system and payment module in the Merchant Profile and configure your module according to the instructions.

Go to Integration — Ready-made solutions.
Select your system from the list. Start typing the name to see the suitable options.
Important If your system isn't on the list, contact your developers and ask them to help you set up integration with YooMoney.
If there're several payment modules suitable for your system, you'll see the list. Select the module you use and click Save.
Configure the payment module according to the instructions. Each module has its own instructions: click How to customize next to the module you need to check them.
Some modules have built-in instructions. To check them, go to your system and find the instructions in the module settings.
Once configured, you can test the integration in a demo store to make sure payments are completed correctly.
1. Issue a secret key in a demo store and reprogram it in the module settings.
  Some modules don't require a secret key: you can simply switch to the demo store in the module settings.
2. Place an order and pay for it on your website just in the same way your customers will do. Use the test details: the payment will be completed as a real one, but no real money will be charged.
3. If the test payment was completed correctly, then you can start accepting payments.
  Don't forget to switch from the demo store to the real one: either change the store in the module settings, or issue a secret key in the store and reprogram it in the module.

Manual integration

When integrating this way, you connect your system to YooMoney independently using the API documentation

You probably will need the assistance to integrate the service independently. In order to invite your developer to the Merchant Profile, grant them access

Use a demo store to set up and test integration

SSL certificate

To make integration work properly, install an SSL certificate. It's required when you interact with YooMoney via HTTP protocol: you send payment requests and receive notifications in response.

Check if your certificate is installed: put https:// at the beginning of your website address and try to open it. If it doesn't open, the certificate isn't installed. In this case, you need to receive and install it.

Where to receive an SSL certificate for a domain

From your provider. The certificate is often included in the hosting fee. Contact your provider's support service to learn more.
Alongside with CMS, CRM, or another engine. The certificate is included in the package of some 1C-Bitrix (Bitrix24), ABCP, Gollos, InSales, LPgenerator, Resonline, SiteEdit, Umi.ru, AutoWebOffice, and other systems' fees.