Перейти к основному содержимому

Razorpay

Razorpay — ведущий онлайн-шлюз для платежей, широко используемый бизнесом в Индии для безопасного приема и обработки цифровых платежей.

Он предоставляет платформу для торговцев и бизнеса, чтобы интегрировать решения для платежей в свои веб-сайты и мобильные приложения. Это позволяет клиентам совершать онлайн-платежи с использованием различных методов оплаты, таких как кредитные карты, дебетовые карты, интернет-банкинг, UPI (Unified Payments Interface) и цифровые кошельки.

warning

На данный момент публикация в веб с включенным Razorpay ограничена из-за некоторых регуляций.

Предварительные требования

Перед началом настройки платежей убедитесь, что у вас есть,

  1. Полная настройка Firebase для вашего проекта.
  2. Включенная аутентификация Firebase для вашего проекта.
  3. Обновленный проект Firebase до плана Blaze. Мы используем Firebase Cloud Functions для обработки транзакций.

Интеграция Razorpay​

Интеграция Razorpay в ваше приложение включает следующие шаги:

  1. Настройка Razorpay
  2. Запуск платежа Razorpay
  3. Тестирование
  4. Выпуск в продакшн

1. Настройка Razorpay​

Настройка платежей Razorpay включает создание учетной записи, включение тестового режима, получение ключей из учетной записи Razorpay и добавление их в ваш проект.

warning

Всегда тестируйте платежи в тестовом режиме перед выпуском в продуктивное приложение. Поэтому приведенные ниже инструкции помогут вам получить тестовые ключи.

Вот шаги:

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

Включение тестового режима

  1. В левом меню выберите Account & Settings > В разделе Website and app settings выберите API keys.
  2. Если вас попросят добавить ссылку на веб-сайт, но ваше приложение еще не опубликовано, вы можете временно опубликовать его на поддомене с помощью нашей функции публикации в веб. Позже вы сможете обновить это на ваш реальный домен как в FlutterFlow, так и в Razorpay.

add-website-link

  1. Нажмите Generate Test Key и скопируйте Key Id и Key Secret. Чтобы перегенерировать, нажмите Regenerate Test Key и выберите, как вы хотите деактивировать старый ключ.

Generate Test Key

  1. Вернитесь к проекту FlutterFlow, перейдите в Settings and Integrations > In App Purchases & Subscriptions > Razorpay. Используйте переключатель, чтобы включить платежи Razorpay.
  2. В разделе Test Credentials вставьте Key ID и Key Secret, полученные на предыдущем шаге.
  3. Укажите название бизнеса.
  4. Нажмите кнопку Deploy.

deploy

2. Запуск платежа Razorpay [действие]​

Чтобы инициировать платеж с помощью Razorpay, используйте действие Razorpay Payment. Это действие позволяет пользователям обрабатывать платежи внутри вашего приложения с использованием кредитных карт, дебетовых карт, интернет-банкинга, UPI (Unified Payments Interface) и цифровых кошельков через Razorpay.

Следуйте шагам ниже, чтобы добавить это действие:

  1. Выберите виджет (например, кнопку оформления заказа), на который вы хотите добавить действие.
  2. В панели свойств (правое меню) выберите Actions и нажмите Open. Это откроет Action Flow Editor в новом всплывающем окне. Нажмите + Add Action.
  3. Найдите и выберите действие Razorpay Payment (в разделе Integrations).
  4. Введите или используйте переменную для указания общей суммы в разделе Amount. Обратите внимание, что значение должно быть указано в наименьшей единице валюты.
    • Например, $24.99 следует передать как 2499 (в виде округленного целого числа; иначе оно будет автоматически округлено); аналогично, для суммы ₹120.00 следует передать 12000.
    • Скорее всего, вы укажете это значение из переменной. Если так, вам может понадобиться эта встроенная функция для преобразования общей суммы в требуемый формат: amount.toStringAsFixed(2).replaceAll(".", "");
  5. Введите код валюты для суммы, например, INR, USD, EUR или BRL. Убедитесь, что вы ввели действительный код валюты; иначе транзакция не пройдет. Скачайте полный список поддерживаемых валют.

Указание суммы и кода валюты вручную

  1. С помощью этого действия вы также можете добавить некоторые необязательные поля, такие как Receipt Number, Description, User Name, User Email, User Contact и Timeout (время, в течение которого диалог оформления заказа должен оставаться активным. По умолчанию 180 секунд).

  1. Вы также можете настроить цветовую схему для листа платежей с помощью свойств, таких как Dialog Color, Barrier Color, Text Color, Processing Color, Success Color, Error Color и другие.

Настройка листа платежей Razorpay

  1. Введите имя выходной переменной действия, где будет храниться ID платежа при успешной транзакции.
  2. Теперь вы должны проверить, был ли платеж успешным. Для этого добавьте условное действие. Для этого нажмите кнопку "+" под плиткой предыдущего действия и выберите Add Conditional.
  3. На правой стороне (Set Condition for Action),
    1. Выберите UNSET > Condition > Single Condition.
    2. First Value > Action Output Variable Name.
    3. Установите оператор Is Set and Not Empty.
  4. В разделе TRUE добавьте действие, которое будет запущено, если платеж успешен.
  5. В разделе FALSE добавьте действие, которое будет запущено, если платеж не удался.

warning

Убедитесь, что пользователь аутентифицирован перед запуском этого действия; иначе возникнет ошибка. Вы можете следовать шагам на этой странице, чтобы настроить аутентификацию Firebase.

3. Тестирование​

Вы можете тестировать платежи Razorpay в режиме Run, Test, на эмуляторе/симуляторе или на физическом устройстве.

Чтобы протестировать платежи в Test или Run:

  1. В проекте FlutterFlow перейдите в Settings and Integrations > In App Purchases & Subscriptions > Razorpay.
  2. Убедитесь, что Is Production отключен.
  3. Убедитесь, что вы ввели правильные тестовые учетные данные.
  4. Запустите приложение в режиме Test.
  5. Чтобы протестировать покупку, вы можете попробовать любой метод отсюда.

4. Выпуск в продакшн​

После завершения тестирования интеграции Razorpay и когда вы будете готовы перейти в режим live, следуйте шагам ниже:

  1. Завершите KYC (или форму активации), чтобы получить доступ к Live API Razorpay.
  2. Войдите в панель управления Razorpay и переключитесь на Live Mode в меню.
  3. В левом меню выберите Account & Settings > В разделе Website and app settings выберите API keys.
  4. Нажмите Generate Live Key и скопируйте Key Id и Key Secret. Чтобы перегенерировать, нажмите Regenerate Live Key и выберите, как вы хотите деактивировать старый ключ.
  5. Вернитесь к проекту FlutterFlow, перейдите в Settings and Integrations > In App Purchases & Subscriptions > Razorpay. Включите Is Production.
  6. В разделе Production Credentials вставьте Key ID и Key Secret, полученные на предыдущем шаге.
  7. Нажмите кнопку Deploy.
  8. Протестируйте ваше приложение.