Введение
API-PAY это многоканальная платежная платформа, которая объединяет плательщиков, онлайн-мерчантов, поставщиков услуг, эквайеров, банки и платежные системы.
Возможности
API-PAY предоставляет широкий спектр способов приема платежей, выплат клиентам, а также иные сервисы:
- Прием платежей на нашей платежной странице, для мерчантов, которые не имеют сертификата соответствия PCI DSS или просто не хотят обрабатывать конфиденциальные данные платежных карт на своей стороне. Данный метод приема платежа позволяет как принимать оплату картой, совершать платежи по токену карты, так и использовать Apple Pay, Google Pay™, Masterpass и иные способы оплаты
- Прием платежей по host-2-host протоколу для мерчантов, имеющих сертификат PCI DSS, и работающих с данными платежных карт на своей стороне. В данном случае доступна оплата картой, либо с использованием токена ранее сохраненной карты
- Токенизация карты (возможен как отдельный метод верификации карты с токенизацией, так и получение токена карты после успешного платежа)
- Выплаты на карту с использованием полного номера карты
- Выплаты на карту с использованием токена карты
- Другие виды платежей
С чего начать?
Прежде всего нужно понять, какие сервисы платежного шлюза будут вами использоваться.
Описание видов доступных сервисов вы можете найти в разделе Услуги данной документации, в котором последовательно и с примерами описан процесс проведения транзакции для каждого типа услуги.
Детальное описание каждого метода API, упоминающегося в документации по услугам, можно найти в соответствующем разделе Методы API.
В ходе интеграции понадобится также раздел Справочники, в котором вы сможете найти список статусов транзакций, коды ошибок API, коды причин отказа, а также списки тестовых номеров карт.
Когда будете готовы приступить к интеграции, мы выдадим вам необходимые учетные данные и инструкции для работы с API в тестовом режиме, в котором не проводится никаких реальных финансовых операций, и могут быть использованы только тестовые карты.
На данный момент тестовый режим доступен не для всех методов. Поэтому, если для метода нет тестового режима, мерчанту выдаются учетные данные для работы в продакшн-режиме
Получение учетных данных для работы с API
Для работы с API, вам будут выданы учетные данные для работы в тестовом окружении, которые включают:
| Имя | Описание | Пример |
|---|---|---|
| api_url | Базовый URL для запросов к API | https://api.api-pay.io |
| account_id | Идентификатор аккаунта мерчанта в платежном шлюзе API-PAY | 1234 |
| wallet_id | Идентификатор кошелька мерчанта в платежном шлюзе API-PAY. Каждый кошелек хранит в себе баланс в определенной валюте. Вы можете иметь один или более wallet_id, если в этом есть необходимость | 1234 |
| point_id | Идентификатор точки приема платежей. В некоторых случаях у вас может быть несколько точек. Настройки вашей платежной страницы, набор доступных услуг, комиссии, настройки защиты от мошенничества могут различаться для разных point_id | 1234 |
| service_id | Идентификатор услуги в платежном шлюзе. Обычно для вашей точки доступно несколько услуг (например, интернет-эк вайринг, выплаты на карту - это отдельные услуги, имеющие уникальный service_id) | 1234 |
| api_token | Секретная строка, использующаяся для авторизации в API | qwerty123456 |
Переход в продакшн
После завершения тестирования для вас будет создан новый аккаунт для работы в продакшн-режиме.
Вы получите новые account_id, wallet_id, point_id, api_token, а также для каждого типа услуги service_id. Тестовый аккаунт при этом также останется активным и вы сможете дальше продолжать его использование для тестирования каких-либо доработок.
Поддержка
Во время интеграции, у вас будет онлайн доступ к нашей техподдержке, где вы сможете задавать все интересующие вопросы, связанные с API, если вдруг не нашли ответа в данной документации, которая регулярно дополняется на основании часто поступающих от мерчантов вопросов.
Удачной вам интеграции и скорейшего запуска в продакшн!