YooMoney API
Guides
Old versions of the API
Help
Sign up for YooMoney
Selecting integration scenario
 
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 Checkout 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 integrationOn 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 Checkout.js)
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 Checkout Widget
It allows embedding the payment form to your website. The YooMoney Checkout 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.
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.
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.
Card payment form on your website
If you want to accept bank card payments, you can embed a payment form to your website using Checkout.js. The Checkout.js 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 Checkout.js.
  3. You create the payment using the received payment token and implement the required payment confirmation scenario.
See also