Подготовка бэкенда

Добавьте на ваш бэкенд метод API для получения токенов заказа и пользователя, например, /startPaymentWithSavedCard. Метод должен:

1. Получить объект Customer.
   • Если Customer уже создан, запросить его через метод GetCustomerByID или GetCustomers с параметром external_id.
   • Если для текущего авторизованного пользователя ещё не создан Customer, создать его через метод CreateCustomer.
2. Получить объект Order.
   • Если Order уже создан, запросить его через метод GetOrderByID или GetOrders с параметром external_id. Крайне рекомендуется выполнить этот шаг для того, чтобы избежать дублирования заказов и возможного дублирования оплат.
   • Если для текущего заказа еще не создан Order, создать его через метод CreateOrder. В параметрах передать значение customer_id, это нужно, чтобы при оплате новой картой, ее можно было сохранить для текущего пользователя.
3. Вернуть access_token-ы из полученных объектов Order и Customer.

Пример:

API_URL = "https://stage-api.ioka.kz"
API_KEY = 'YOUR_API_KEY'

app = Flask()

app.route('/startPaymentWithSavedCard', methods=['POST'])
def start_payment_with_saved_card():
    order = customer = None  # Инициализация `Order` и `Customer` объектов

    # Получаем тело запроса с необходимыми свойствами (`external_id`, `amount`, `description` и т.д.)
    payload = json.loads(request.data)

    # 1: Запрашиваем объект `Customer` с помощью `external_id`
    response = requests.get(
        url=f"{API_URL}/v2/customers",
        headers={
            'API-KEY': API_KEY
        },
        params={
            'external_id': payload['customer_external_id']
        }
    )
    if response.status_code == 200:
        # `Customer` найден. Парсим и сохраняем объект.
        customer = response.json()[0]
    elif response.status_code == 404:
        # `Customer` не найден. Создаём новый объект путём передачи `external_id`, `email` и (опционально) `phone`
        response = requests.post(
            url=f"{API_URL}/v2/customers",
            headers={
                'Content-Type': 'application/json',
                'API-KEY': API_KEY
            },
            json={
                "external_id": payload['customer_external_id'],
                "email": payload['email'],
                "phone": payload['phone']
            }
        )
        if response.status_code == 200:
            # `Customer` создан. Парсим и сохраняем объект.
            customer = response.json()

    if customer is None:
        # Что-то пошло не так. Обрабатываем и возвращаем ошибку.
        return jsonify({
            'status': 'error'
        })

    # 2: Запрашиваем объект `Order` с помощью `external_id`
    response = requests.get(
        url=f"{API_URL}/v2/orders",
        headers={
            'API-KEY': API_KEY
        },
        params={
            'external_id': payload['order_external_id']
        }
    )
    if response.status_code == 200:
        # `Order` найден. Парсим и сохраняем объект.
        order = response.json()[0]
        # Дополнительно: Можно обновить свойство `customer_id` у объекта `Order` если оно отличается от того, которое было получено в объекте `Customer`
    elif response.status_code == 404:
        # `Order` не найден. Создаём новый объект путём передачи `external_id`, `amount` и (опционально) `customer_id`
        response = requests.post(
            url=f"{API_URL}/v2/orders",
            headers={
                'Content-Type': 'application/json',
                'API-KEY': API_KEY
            },
            json={
                "external_id": payload['order_external_id'],
                "amount": payload['amount'],
                "customer_id": customer['id'],
                # `customer_id` это свойство того объекта `customer`, который мы только что создали
            }
        )
        if response.status_code == 200:
            # `Order` создан. Парсим и сохраняем объект.
            order = response.json()

    if order:
        # 3. Валидные объекты `Order` и `Customer` доступны. Возвращаем `access_token` обоих объектов.
        return jsonify({
            "order_access_token": order['access_token'],
            "customer_access_token": customer['access_token']
        })

    # Что-то пошло не так. Обрабатываем и возвращаем ошибку.
    return jsonify({
        'status': 'error'
    })

При необходимости создайте вебхуки, чтобы обрабатывать изменения состояния заказа. Скорее всего, вам понадобится обрабатывать события оплаты или авторизации платежа.