Integration scenarios
 
About the scenarios
YooMoney supports several payment scenarios. They differ in respect to where the user selects the payment method and enter information for payment.
ScenarioPayment method selectionPayment data entry
Smart paymentOn YooMoney’s sideOn YooMoney’s side
YooMoney widgetOn your side (using the widget)On your side (using the widget)
Payments in the mobile appOn your side (via mobile SDK)On your side (via mobile SDK)
Manual-
integration
On your sideOn your side or on YooMoney’s side (depending on the payment method and your store’s settings)
Card payment form on your websiteOn your sideOn your side (via web SDK)
 
Smart payment
The most simple scenario. You only need to redirect the user to the YooMoney page where they’ll select one of the available payment methods and securely enter information for payment.
Example of implementation:
  1. The user proceeds to checkout on your side (for example, by clicking a button).
  2. You create a Smart payment and redirect the user to the YooMoney’s page.
  3. The user selects the payment method and enters information for payment on YooMoney’s side.
  4. YooMoney implements the required payment confirmation scenario (for example, redirects the user to Internet banking).
  5. The user confirms the payment.
  6. YooMoney returns the user to the payment completion page on your side.
More about Smart payment
 
YooMoney widget
It allows embedding the payment form to your website. The YooMoney widget provides the security of data entry and user interaction.
Example of implementation:
  1. The user proceeds to checkout on your side (for example, by clicking a button).
  2. You create a payment, obtain a YooMoney token for widget initialization, and display the payment form.
  3. The user selects the payment method in the payment form, enters the details, and proceeds to the payment.
  4. YooMoney implements the required payment confirmation scenario (for example, redirects the user to Internet banking).
  5. The user confirms the payment.
  6. YooMoney returns the user to the payment completion page on your side.
More about the YooMoney widget
 
Payments in the mobile app
Embed the payment form to your iOS or Android mobile app using YooMoney’s mobile SDK. The SDK will ensure the security of bank card data entry.
Example of implementation:
  1. The user selects the payment method, enters information for payment and proceeds to checkout on your side.
  2. You receive a token with payment details via mobile SDK.
  3. You create the payment using the received payment token and implement the required payment confirmation scenario.
Using mobile SDK
 
Manual integration
In Smart payment, all payment methods available to your store are displayed on the YooMoney’s page. With manual integration, the user selects the payment method on your side in your interface. Depending on the payment method and store’s settings you can also implement payment data collection, for example, by asking the user’s login in Internet banking.
Example of implementation:
  1. The user selects the payment method, enters information for payment and proceeds to checkout on your side.
  2. You create the payment with the selected method and implement the required payment confirmation scenario.
More about payment methods and manual integration
 
Card payment form on your website
If you want to accept bank card payments, you can embed a payment form to your website using YooMoney’s web SDK. The SDK will ensure the security of bank card data entry.
Example of implementation:
  1. The user selects the payment method, enters information for payment and proceeds to checkout on your side.
  2. You receive a token with payment details via web SDK.
  3. You create the payment using the received payment token and implement the required payment confirmation scenario.
Using web SDK
 
See also
Payment by 54-FZDeclined paymentsNotificationsTesting