YooMoney API
Old versions of the API
Help
Sign up for YooMoney
Instructions for Simpla
Installing the module
  1. Download the archive
  2. Copy the contents of the archive to the root folder of the website on your server.
Setting up payment acceptance in Simpla
To set up payment acceptance using this manual, you need to sign up for YooMoney and get the shopId and Secret key parameters.
  • shopId will appear in your Merchant Profile by itself when you sign up for the service,
  • Secret key is issued independently and requires activation in Merchant Profile. More in YooMoney's help guide
Once you get both parameters, you can proceed with the configuration.
Payment acceptance settings depend on your chosen scenario. There are two:
  • Selecting the payment method on the YooMoney's side
  • Selecting the payment method on your website
Settings of the first scenario: selecting the payment method on the YooMoney's side.
  1. Select Settings in the website's dashboard, then the Payment tab. Click Add payment method.
  2. Enter "YooMoney" in the top line of the panel for adding a new payment method. Check the Active box to the right of the line.
  3. Select "YooMoney" in the drop-down menu.
  4. Fill out the shopId and Secret key fields: you can get both parameters in your YooMoney Merchant Profile.
  5. Set On YooMoney's side in the Payment method selection column.
  6. If you configured the transmission of receipts to the Tax service via YooMoney partner services (in accordance with Federal Law No. 54-FZ), enable the transmission of receipt data, then indicate the VAT rate to be specified in your receipts.
  7. Once you set up everything for 54-FZ, you can enable the Second receipt option. The module will automatically generate a closing receipt if the order has items with full prepayment and if this order has moved to the selected status. For example, "Completed".
    Under 54-FZ, two receipts are needed if the customer makes a prepayment and only then receives the product or service. The first receipt is for settlements made to your account, the second is for shipment of the goods or performance of the services. In the first receipt, "full prepayment" is specified as the "payment method attribute". In the second one, "full payment" is specified as the "payment method attribute".
  8. Click Save. That's it, now you can test payment acceptance.
Settings of the second scenario: selecting the payment method on the store's side.
  1. Select Settings in the website's dashboard, then the Payment tab. Click Add payment method.
  2. Enter "YooMoney" in the top line of the panel for adding a new payment method. Check the Active box to the right of the line.
  3. Select "YooMoney" in the drop-down menu.
  4. Fill out the shopId and Secret key fields: you can get both parameters in your YooMoney Merchant Profile.
  5. Set On the store's side in the Payment method selection column.
  6. Select payment methods indicated in your contract with YooMoney in the Payment method column.
  7. If you configured the transmission of receipts to the Tax service via YooMoney partner services (in accordance with Federal Law No. 54-FZ), enable the transmission of receipt data, then indicate the VAT rate to be specified in your receipts.
  8. Once you set up everything for 54-FZ, you can enable the Second receipt option. The module will automatically generate a closing receipt if the order has items with full prepayment and if this order has moved to the selected status. For example, "Completed".
    Under 54-FZ, two receipts are needed if the customer makes a prepayment and only then receives the product or service. The first receipt is for settlements made to your account, the second is for shipment of the goods or performance of the services. In the first receipt, "full prepayment" is specified as the "payment method attribute". In the second one, "full payment" is specified as the "payment method attribute".
  9. Click Save.
  10. Repeat steps 1 to 8 for each payment method indicated in your contract with YooMoney.