Integration scenarios
 About the scenarios
Yandex.Checkout 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 Yandex.Checkout’s sideOn Yandex.Checkout’s side
Yandex.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-
integration
On your sideOn your side or on Yandex.Checkout’s side (depending on the payment method and your store’s settings)
 Smart payment
The most simple scenario. You only need to redirect the user to the Yandex.Checkout 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 Yandex.Checkout’s page.
  3. The user selects the payment method and enters information for payment on Yandex.Checkout’s side.
  4. Yandex.Checkout implements the required payment confirmation scenario (for example, redirects the user to Internet banking).
  5. The user confirms the payment.
  6. Yandex.Checkout returns the user to the payment completion page on your side.
More about Smart payment
 Yandex.Checkout widget
It allows embedding the payment form to your website. The Yandex.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 Yandex.Checkout 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. Yandex.Checkout implements the required payment confirmation scenario (for example, redirects the user to Internet banking).
  5. The user confirms the payment.
  6. Yandex.Checkout returns the user to the payment completion page on your side.
More about the Yandex.Checkout widget
 Payments in the mobile app
Embed the payment form to your iOS or Android mobile app using Yandex.Checkout’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 Yandex.Money’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
This scenario is deprecated. We recommend using the Yandex.Checkout widget for embedding the payment form.
If you want to accept bank card payments, you can embed a payment form to your website using Yandex.Checkout’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 mobile 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