Руководство по iOS SDK (Checkout)

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>yandexauth</string>
    <string>yandexauth2</string>
    <string>yandexauth4</string>
</array>
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>YandexLoginSDK</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>yx<Вставьте ваш Client Id></string>
        </array>
    </dict>
</array>

import YandexPaySDK

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()

        // Проверьте, что SDK проинициализирован
        guard YandexPaySDKApi.isInitialized else {
          assertionFailure("YandexPaySDK is not initialized.")
          return
        }
        
        // Укажите тему для кнопки
        // Параметр `dynamic` позволяет указать, нужно ли кнопке
        // менять свою цветовую палитру вместе со сменой системной темы
        let theme: = YandexPayButtonTheme(appearance: .dark, dynamic: true)

        // Инициализируйте конфигурацию
        let configuration = YandexPayButtonConfiguration(theme: theme)

        // Создайте кнопку
        let button = YandexPaySDKApi.instance.createCheckoutButton(configuration: configuration, delegate: self)

        // Укажите скругления для кнопки (по умолчанию - 8px)
        button.layer.cornerRadius = .zero

        // Добавьте кнопку в иерархию
        view.addSubview(button)

        // Установите layout для кнопки
        button.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
            button.centerYAnchor.constraint(equalTo: view.centerYAnchor),
            button.widthAnchor.constraint(equalToConstant: 250)
        ])
    }
}

import YandexPaySDK

extension ViewController: YandexPayCheckoutButtonDelegate {

    // Обработайте результат чекаута
    func yandexPayCheckoutButton(_ button: YandexPayButton, didCompletePaymentWithResult result: YPCheckoutResult) {
        switch result {
        case .succeeded(let checkoutInfo):
            // чекаут был совершен успешно
        case .failed(let checkoutError):
            // В процессе чекаута произошла ошибка
        case .cancelled:
            // Пользователь закрыл/смахнул форму YandexPay
        }
    }

    // Предоставьте UIViewController, с которого необходимо показать форму YandexPay по нажатию на кнопку
    func yandexPayCheckoutButtonDidRequestViewControllerForPresentation(_ button: YandexPayButton) -> UIViewController? {
        return self
    }

    // Предоставьте информацию о заказе
    func yandexPayCheckoutButtonDidRequestPaymentSheet(_ button: YandexPayButton) -> YPCheckoutPaymentSheet? {
        return YPCheckoutPaymentSheet(
            // Код валюты
            currencyCode: .rub,
            // Информация о корзине покупателя
            cart: YPPaymentCart(items: [
                YPProduct(id: "1", total: "434.39", quantity: YPQuantity(count: "1")),
                YPProduct(id: "2", total: "1474.86", quantity: YPQuantity(count: "2")),
            ]),
            orderId: nil,
            metadata: nil
        )
    }
}

import YandexPaySDK

// В этом примере мы используем объект-делегат, чтобы сообщать о событиях
// из контейнера в UIViewController, который написан на Objective-C.
// Чтобы данный протокол был доступен в Objective-C, помечаем его @objc
// атрибутом.
@objc
protocol YandexPayCheckoutButtonContainerDelegate: AnyObject {
    // Данный метод будем использовать для сообщения об успешном 
    // получении токена чекаута.
    func yandexPayCheckoutButtonDidSucceedWithOrderId(_ orderId: String)

    // Данный метод будем использовать для сообщения об ошибке,
    // полученной в процессе.
    func yandexPayCheckoutButtonDidFail()

    // Данный метод будем использовать для сообщения об отмене.
    func yandexPayCheckoutButtonDidCancel()

    // Данный метод будем использовать для получения UIViewController
    // объекта, из которого необходимо показать форму Яндекс Пэй.
    func yandexPayCheckoutButtonDidRequestViewController() -> UIViewController?

    // Для примера будем использовать отдельный метод для получения
    // информации о корзине покупателя. Модель CardProduct написана
    // на Objective-C и используется здесь, так как ее header-файл 
    // добавлен в bridging header файл проекта.
    func yandexPayCheckoutButtonDidRequestCardProducts() -> [CardProduct]
}

// Объект-прослойка, который будет содержать в себе кнопку Яндекс Пэй и
// взаимодействовать с ней, а также взаимодействовать с Objective-C кодом.
final class YandexPayCheckoutButtonContainer: UIView {

    // Свойства, которые должны быть доступны из Objective-C помечаем
    // атрибутом @objc.
    @objc
    weak var delegate: YandexPayCheckoutButtonContainerDelegate?

    private var payButton: YandexPayButton!

    override init(frame: CGRect) {
        super.init(frame: frame)
        setupView()
    }

    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupView()
    }

    // Данный контейнер содержит только кнопку, поэтому переопределим
    // intrinsicContentSize. Если же у вас более сложный контейнер,
    // то его разметка может быть любой на ваше усмотрение.
    override var intrinsicContentSize: CGSize {
        return payButton.intrinsicContentSize
    }

    private func setupView() {
        // Проверяем, проинициализирован ли SDK.
        guard YandexPaySDKApi.isInitialized else {
            assertionFailure("YandexPaySDKApi is not initialized.")
            return
        }

        // Указываем тему для кнопки.
        let payButtonTheme = YandexPayButtonTheme(appearance: .dark, dynamic: true)

        // Указываем конфигурацию кнопки.
        let payButtonConfiguration = YandexPayButtonConfiguration(theme: payButtonTheme)

        // Создаем кнопку с помощью YandexPaySDKApi.
        payButton = YandexPaySDKApi.instance.createCheckoutButton(configuration: payButtonConfiguration, delegate: self)

        // Размещаем кнопку в иерархии.
        payButton.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        payButton.frame = bounds
        addSubview(payButton)
    }
}

// Реализуем делегат кнопки, чтобы получать от нее события.
extension YandexPayCheckoutButtonContainer: YandexPayCheckoutButtonDelegate {
    func yandexPayCheckoutButton(_ button: YandexPayButton, didCompletePaymentWithResult result: YPCheckoutResult) {
        // Получаем события об успешном получении токена или об ошибке.
        switch result {
        case .succeeded(let checkoutInfo):
            // Сообщаем через делегат Objective-C коду о получении.
            // платежного токена
            delegate?.yandexPayCheckoutButtonDidSucceedWithOrderId(checkoutInfo.orderId)
        case .failed:
            // Сообщаем через делегат Objective-C коду об ошибке.
            delegate?.yandexPayCheckoutButtonDidFail()
        case .cancelled:
            // Сообщаем через делегат Objective-C коду об отмене.
            delegate?.yandexPayCheckoutButtonDidCancel()
        @unknown default:
            break
        }
    }

    func yandexPayCheckoutButtonDidRequestViewControllerForPresentation(_ button: YandexPayButton) -> UIViewController? {
        // Запрашиваем через делегат у Objective-C кода UIViewController
        // объект, в котором необходимо показывать форму Яндекс Пэй.
        return delegate?.yandexPayCheckoutButtonDidRequestViewController()
    }

    func yandexPayCheckoutButtonDidRequestPaymentSheet(_ button: YandexPayButton) -> YPCheckoutPaymentSheet? {
        guard let delegate = delegate else {
            assertionFailure("Delegate is missing.")
            return nil
        }

        // Здесь конструируем YPCheckoutPaymentSheet объект и возвращаем его
        // кнопке. Для создания YPCheckoutPaymentSheet объекта, очевидно,
        // нужно использовать некоторую бизнес-логику, которая написана
        // на Objective-C. Для того, чтобы с данной бизнес-логикой
        // взаимодействовать, вы можете использовать тот же объект
        // делегата или же можете использовать другие Objective-C
        // классы (например, какие-нибудь сервисы или интеракторы), 
        // которые данную логику инкапсулируют. Для этого
        // сделайте данные классы доступными в Swift, добавив их
        // header-файлы в bridging header файл вашего проекта.
        // Стоит отметить, что бизнес-логика, реализованная в 
        // Objective-C будет использовать модели, реализованные на
        // Objective-C. Поэтому здесь вы можете реализовать их маппинг
        // в модели YandexPaySDK.

        // В текущем примере мы используем объект делегата.
        let products = delegate.yandexPayCheckoutButtonDidRequestCardProducts()

        // Конструируем YPCheckoutPaymentSheet
        return YPCheckoutPaymentSheet(
            currencyCode: .rub,
            cart: YPPaymentCart(items: products.map { 
                YPProduct(id: $0.productID, total: $0.total, quantity: YPQuantity(count: $0.quantity)) 
            }),
            orderId: nil,
            metadata: nil
        )
    }
}

#import <YandexPaySDK/YandexPaySDK-Swift.h>

// Добавляем соответствие протоколу.
@interface ViewController (ViewControllerYandexPayButtonContainer) <YandexPayCheckoutButtonContainerDelegate>

@end

// Объявляем приватные методы.
@interface ViewController ()

- (void)showAlertWithMessage:(NSString *)message;

@end

// Реализация ViewController класса.
@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    self.view.backgroundColor = [UIColor systemBackgroundColor];

    // Используем объект-прослойку для показа кнопки Яндекс Пэй.
    YandexPayCheckoutButtonContainer *container = [[YandexPayCheckoutButtonContainer alloc] init];

    // Указываем объект делегата для прослойки.
    container.delegate = self;

    // Добавляем объект-прослойку в иерархию.
    container.translatesAutoresizingMaskIntoConstraints = false;
    [self.view addSubview:container];
    [[container.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor] setActive:TRUE];
    [[container.centerYAnchor constraintEqualToAnchor:self.view.centerYAnchor] setActive:TRUE];
}

- (void)showAlertWithMessage:(NSString *)message {
    UIAlertController *controller = [UIAlertController alertControllerWithTitle:@"Message" message:message preferredStyle:UIAlertControllerStyleAlert];
    [controller addAction:[UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleDefault handler:nil]];
    [self presentViewController:controller animated:TRUE completion:nil];
}

- (void)yandexPayCheckoutButtonDidSucceedWithOrderId:(NSString *)orderId {
    // Получили токен и можем провести чекаут с помощью 
    // этого токена.
    [self showAlertWithMessage:[NSString stringWithFormat:@"Checkout complete: %@", orderId]];

    // Обращение к платежному шлюзу
    // ...
}

- (void)yandexPayCheckoutButtonDidFail {
    // Получили событие об ошибке.
    [self showAlertWithMessage:@"Checkout failed"];
}

- (void)yandexPayCheckoutButtonDidCancel {
    // Получили событие об отмене.
    [self showAlertWithMessage:@"Checkout was cancelled by the user"];
}

- (UIViewController *)yandexPayCheckoutButtonDidRequestViewController {
    // Возвращаем текущий UIViewController для показа формы.
    return self;
}

- (NSArray<CardProduct *> *)yandexPayCheckoutButtonDidRequestCardProducts {
    // Если необходимо, передавайте информацию о заказе и другую
    // информацию через делегат или любым другим удобным способом.
    NSMutableArray *products = [[NSMutableArray alloc] init];
    [items addObject:[[CardProduct alloc] initWithProductID:@"ID-1" total:@"1000.00" quantity: @"1"]];
    [items addObject:[[CardProduct alloc] initWithProductID:@"ID-2" total:@"500.00" quantity: @"2"]];
    return products;
}

@end

@interface Product : NSObject

@property (readonly, copy, nonatomic) NSString *productID;
@property (readonly, copy, nonatomic) NSString *total;
@property (readonly, copy, nonatomic) NSString *quantity;

- (instancetype)initWithProductID:(NSString *)productID
                            total:(NSString *)total
                         quantity:(NSString *)quantity;

@end