Начало работы с Rapyd Collect для кредитных карт

Джеймс Олаогун

Использование дебетовых и кредитных карт находится на подъеме, и эта тенденция не проявляет признаков замедления. Владельцы бизнеса, которые отказываются принимать платежи по дебетовым или кредитным картам, скорее всего, потеряют значительную сумму денег, а также потенциальных клиентов.

Если вы хотите идти в ногу с современными клиентами, вы должны убедиться, что у вас есть системы, способные удовлетворить их платежные потребности. К счастью, разработать и настроить собственную инфраструктуру обработки карточных платежей легко с помощью такой платежной платформы, как Rapyd Collect.

Rapyd Collect — это универсальная платежная платформа с набором API, которые предприятия могут использовать для доступа к широкому кругу клиентов, желающих совершать транзакции с помощью предпочитаемых ими способов оплаты в своих странах.

Эти способы оплаты включают электронные кошельки, местные и международные карточные платежи и банковские переводы; используя API Rapyd Collect, предприятия могут легко авторизовать транзакцию и успешно зафиксировать авторизованную транзакцию с помощью любого из выбранных способов оплаты.

В этой статье вы узнаете об API Rapyd Collect, о случаях его использования, некоторых преимуществах и, самое главное, пошаговые инструкции по внедрению платежного процессора с использованием API Rapyd Collect для карт.

Rapyd Collect API

Rapyd Collect API — это набор определений и протоколов, который позволяет интегрировать платформу обработки онлайн-платежей в ваши приложения. Он обладает рядом возможностей, например, позволяет устанавливать повторяющиеся платежи, использовать выбранную вами валюту, отправлять массовые счета и разделять платежи:

  • Повторяющиеся платежи: Также известная как подписка, функция повторяющихся платежей позволяет вам и вашему клиенту виртуально договориться об оплате продуктов или услуг по заранее определенному графику. Часто такие платежи устанавливаются как еженедельные, ежемесячные или ежегодные, а с кредитной карты вашего клиента списываются средства в соответствии с заранее установленным графиком через Rapyd Collect.

  • Мультивалютность: Мультивалютная функция позволяет клиентам осуществлять платежи в пользу вашего бизнеса через Rapyd Collect, используя валюту по своему выбору. Rapyd также предоставляет мультивалютный кошелек клиента, который позволяет вашему бизнесу вести счета в нескольких валютах и конвертировать их между собой.

  • Беспрепятственное выставление счетов: Счета-фактуры используются для запроса оплаты после завершения услуги. Это могут быть единичные счета, которые запрашивают оплату за одну услугу, или массовые (также известные как массовые или пакетные) счета, которые представляют собой бесшовный способ создания нескольких счетов для нескольких объектов (то есть выполненных услуг).

  • Раздельные платежи: Функция раздельных платежей позволяет вашему бизнесу платить нескольким лицам за одну операцию путем разделения одного платежа на несколько кошельков Rapyd (обычно от двух до десяти кошельков).

Преимущества использования API Rapyd Collect

Теперь, когда вы хорошо понимаете, что включает в себя API Rapyd Collect, давайте рассмотрим некоторые его преимущества, которые включают в себя сбор международных и местных платежей, упрощенное управление счетами и безопасность (защита от мошенничества).

Сбор международных и местных платежей

API Rapyd Collect позволяет вам расширить свой бизнес на мировой рынок, что означает, что любой человек, имеющий доступ в интернет, может вести с вами бизнес и осуществлять платежи из любой точки мира.

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

Упрощенное управление счетами

Rapyd Collect API имеет портал, который позволяет вам управлять важной информацией, которую вы и ваши клиенты используете. С помощью портала Rapyd вы можете получить доступ и управлять информацией о своем счете, управлять связанными банковскими счетами для получения расчетов, управлять своим кошельком, конвертировать валюту, осуществлять платежи клиентам и так далее.

В результате вам не придется беспокоиться о том, чтобы вручную вести учет своих операций или финансов.

Безопасность

Защита конфиденциальной (или чувствительной) информации ваших клиентов и внедрение технологий безопасного шифрования данных для защиты от угроз может стать непростой задачей для вашего бизнеса. Rapyd Collect API поставляется с Rapyd Protect, системой обнаружения мошенничества на основе машинного обучения. Rapyd Hosted Check Page соответствует стандарту PCI DSS, обеспечивая высочайший уровень защиты для вас и ваших клиентов.

Rapyd Collect API также защищает ваши бизнес-транзакции от овердрафтов, недостаточных средств и просроченных карт.

Как использовать Rapyd Collect API для приема платежей по кредитным картам

Теперь, когда вы ознакомились с некоторыми преимуществами Rapyd Collect, в следующих разделах представлен пошаговый процесс интеграции карточных платежей с помощью Rapyd Collect API.

Шаг 1: Создайте аккаунт Rapyd

Вы можете пропустить этот шаг, если у вас уже есть учетная запись Rapyd. Однако, если вы новичок в Rapyd, вам следует сначала создать учетную запись Rapyd Client Portal, чтобы получить доступ ко всему необходимому для начала работы.

Шаг 2: Получение ключей API

Чтобы получить ключи API, войдите в свою панель управления (если вы этого еще не сделали), а затем перейдите в раздел Developers > Credentials Details, где вы найдете свой секрет и ключ доступа.

Шаг 3: Генерирование подписи для каждого запроса

Подпись для каждого запроса API рассчитывается как хэш полезной нагрузки запроса и заголовков; используйте приведенную ниже формулу для генерации подписи для каждого запроса.

подпись = BASE64 ( HASH ( http_method + url_path + salt + timestamp + access_key + secret_key + body_string ) )

Где:

  • BASE64: является алгоритмом для кодирования Base-64.
  • HASH: обозначает алгоритм HMAC-SHA256.
  • http_method: обозначает метод HTTP. Все строчными буквами. (например, post, get).
  • url_path: обозначает раздел URL после базового URI (https://api.rapyd.net). Обычно он начинается с /v1. (например, /v1/data/countries)
  • соль: случайная строка из цифр, букв и специальных символов, обычно длиной 8-16 символов для каждого запроса.
  • timestamp: время запроса в Unix-времени (секунды).
  • access_key: уникальная строка для каждого пользователя, назначаемая Rapyd. Для его получения выполните предыдущий шаг.
  • secret_key: также является уникальной строкой для каждого пользователя, назначаемой Rapyd. Для ее получения выполните предыдущий шаг.
  • body_string: является правильной строкой JSON, которая содержит всю полезную нагрузку запроса или необработанные данные. Она может быть пустой, если запрос не содержит полезной нагрузки или необработанных данных.

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

Шаг 4: Создание запроса на список методов оплаты по странам

Rapyd предлагает сотни различных типов методов оплаты и выплат для разных стран. Вы можете получить список методов оплаты, доступных в определенной стране, используя API List Payment Methods by Country.

Разработчики могут использовать API, отправив запрос get по адресу https://sandboxapi.rapyd.net/v1/payment_methods/country?country&currency; он включает несколько полезных нагрузок, таких как:

Кроме того, access key, content-type, строка salt для подписи запроса, signature, рассчитанная для каждого запроса отдельно, и timestamp (по времени Unix) для запроса будут включены в заголовки запроса.

В следующем примере кода показано, как использовать curl для получения списка методов оплаты по странам:

curl --location --request GET 'https://sandboxapi.rapyd.net/v1/payment_methods/country?country=US&currency=USD' 
--header 'Content-Type: application/json' 
--header 'access_key: {{rapyd_access_key}}' 
--header 'salt: {{any_random_string}}' 
--header 'signature: {{rapyd_signature}}' 
--header 'timestamp: {{rapyd_request_timestamp}}'
Войти в полноэкранный режим Выход из полноэкранного режима

В официальной документации есть специальный раздел о полезной нагрузке, заголовках и формате ответа API List Payment Methods by Country; вы также можете найти примеры кода на предпочитаемом вами языке программирования.

Шаг 5: Выполнение запроса для получения обязательных полей метода оплаты

Как только вы получили список платежей, доступных в выбранной вами стране, следующее, что нужно сделать, это отправить запрос get на Get Payment Method Required Fields через https://sandboxapi.rapyd.net/v1/payment_methods/required_fields/type.

Полезная нагрузка API включает параметр type, обязательный параметр, который указывает на тип метода оплаты. Запрос также требует список заголовков, который был упомянут в предыдущем шаге. Кроме того, запрос возвращает список объектов, и имя каждого требуемого поля появляется в data -> fields -> name ответа.

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

curl --location --request GET '// Request URL: GET https://sandboxapi.rapyd.net/v1/payment_methods/required_fields/us_visa_card' 
--header 'Content-Type: application/json' 
--header 'access_key: {{rapyd_access_key}}' 
--header 'salt: {{any_random_string}}' 
--header 'signature: {{rapyd_signature}}' 
--header 'timestamp: {{rapyd_request_timestamp}}'
Вход в полноэкранный режим Выйти из полноэкранного режима

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

Шаг 6: Создание запроса на оплату

Последний шаг — отправка запроса post к API Create Payment. Этот API можно использовать для немедленного сбора оплаты за разовый платеж, пополнения одного или нескольких кошельков Rapyd, запуска процесса сбора в середине биллингового цикла, относящегося к подписке, замены неудачного платежа в групповом платеже и т.д.

При использовании API Create Payment следует помнить о некоторых моментах:

  • Только PCI-сертифицированные клиенты могут обрабатывать персональную идентифицирующую информацию для карт. В качестве альтернативы, клиенты, не имеющие PCI-сертификации, могут использовать Rapyd Checkout для сбора денег с карты.
  • Всегда убедитесь, что значение параметра is_tokenizable равно true, прежде чем совершать платеж с помощью токенизированного метода оплаты.
  • Клиент должен подтвердить подлинность транзакций с использованием 3DS-аутентификации в течение пятнадцати минут.

Приведенный ниже пример кода показывает, как использовать curl для создания нового запроса на оплату;

curl --location --request POST 'https://sandboxapi.rapyd.net/v1/payments' 
--header 'Content-Type: application/json' 
--header 'access_key: {{rapyd_access_key}}' 
--header 'salt: {{any_random_string}}' 
--header 'timestamp: {{rapyd_request_timestamp}}' 
--header 'signature: {{rapyd_signature}}' 
--data-raw '{
    "amount": 10,
    "currency": "USD",
    "customer": "cus_*******************",
    "payment_method": {
        "type": "us_visa_card'",
        "fields": {
            "number": "4111111111111111",
            "expiration_month": "12",
            "expiration_year": "23",
            "name": "John Doe",
            "cvv": "345"
        },
        "metadata": {
        "merchant_defined": true
    }
    },
    "capture": true
}'
Вход в полноэкранный режим Выйти из полноэкранного режима

Официальная документация содержит более подробное объяснение того, как использовать API Create Payment, его обязательную и необязательную полезную нагрузку и заголовки запросов; в ней также есть демонстрационный код на различных языках программирования, а также необходимые асинхронные веб-крючки.

Шаг 7: Активируйте свой аккаунт

Чтобы использовать любой из функционалов Rapyd в производстве (принимать реальные платежи), вы должны сначала пройти через процесс Rapyd’s Know Your Business (KYB) и получить одобрение приложения.

Однако европейские компании могут обрабатывать фактические платежи (в производстве) до определенной суммы без одобрения KYB, но платежи не будут зачисляться на их банковский счет до тех пор, пока KYB не будет одобрен. Шаги KYB для полной активации вашего аккаунта можно найти на вашем портале Rapyd, и вы можете проверить этот список ограниченных предприятий, чтобы убедиться, что вы имеете право подать заявку на аккаунт Rapyd.

Наконец, скачайте и используйте коллекцию Rapyd Postman Collection, чтобы увидеть рабочий пример всех API Rapyd на выбранном вами языке программирования. Обратите внимание, что для успешного доступа к конечным точкам необходимо перейти в среду Rapyd Sandbox Environment в Postman и ввести значения для ваших ключей доступа и секретных ключей.

Заключение

Теперь у вас есть полное представление об API Rapyd Collect, включая некоторые случаи его использования и преимущества, а также пошаговое руководство по началу работы и внедрению Rapyd Collect для международных и местных карточных платежей.

Если вы владеете бизнесом, обслуживающим клиентов со всего мира, вы можете начать использовать Rapyd Collect прямо сейчас и воспользоваться всеми преимуществами, которые он дает, включая те, что описаны в этой статье.

API Rapyd Collect работает на базе Rapyd, платежной платформы, которая интегрирует финтех в любое приложение и упрощает сложный мир обработки местных и международных платежей.

Такие компании, как электронная коммерция, гиг-платформы, платформы денежных переводов, онлайн-кредиторы и традиционные банки могут использовать Rapyd, чтобы отказаться от старой инфраструктуры и ограничений и использовать современную инфраструктуру для обслуживания широкого круга клиентов. Предприятия и клиенты также могут проводить местные и трансграничные транзакции на любом рынке, используя платежную сеть Rapyd и платформу Fintech-as-a-Service.

Оцените статью
devanswers.ru
Добавить комментарий