YooMoney API
Old versions of the API
Sign up for YooMoney
YooMoney Checkout Widget
Using the YooMoney Checkout Widget, you can embed a ready-made payment form on your website. Users will have access to popular payment methods: YooMoney wallets, bank cards, SberPay, and other methods.
YooMoney Checkout Widget’s payment form
Key features
Payment methods
Payment methods supported by the widget:
  • YooMoney wallets;
  • bank cards: linked to the YooMoney wallet or SberID or manually entered by the user;
  • Mir Pay;
  • SberPay;
  • Tinkoff Pay;
  • FPS (Faster Payments System);
  • “Credit purchases” by SberBank (loans and installment plans).
If you process two-stage payments or if you save the payment method for autopayments, only the payment methods which support the feature you're using are displayed in the payment form. Learn more about payment methods and their features
Payment form
The payment form automatically adjusts to the size of the user’s device, checks the entered data and alerts the user if something is entered incorrectly. You can set the interface language and customize the color scheme of the payment form.
If a payment doesn't go through, the widget processes processes unsuccessful attempts: it displays an error message to the user and prompts them to try again and select the payment method once more. Contact your manager if you'd like to disable this feature and process unsuccessful attempts on your own.
To process a payment via the widget, just create a payment using the YooMoney API, initialize the widget, and display the form on the payment page or in a pop-up window.
You can handle widget events to interact with users after the payment is finished or in case the pop-up window with the payment form is closed.
Payment processing scenario
  1. User proceeds to payment.
  2. You send a request for creating a payment to YooMoney.
  3. YooMoney returns the created payment object with a token for initializing the widget.
  4. You initialize the widget and display the form on the payment page or in a pop-up window.
  5. User selects a payment method, enters their details.
  6. Widget redirects the user to the payment confirmation page or displays a pop-up window (for example, for 3-D Secure authentication) if required.
  7. User confirms the payment.
  8. If a payment doesn't go through for some reason (for example, if there wasn't enough money) and the token for initializing the widget hasn't expired yet, the widget displays an error message to the user and prompts them to try again and select the payment method once more.
  9. If the user has confirmed the payment or if the token for initialization has expired, the widget will redirect the user to the page for finishing the payment on your side or executes the actions that you scripted for the event when the payment is finished.
  10. You display the relevant information depending on the payment status.
Use Quick start to make your first payment using the YooMoney Checkout Widget.
See also