Введение

API-PAY это многоканальная платежная платформа, которая объединяет плательщиков, онлайн-мерчантов, поставщиков услуг, эквайеров, банки и платежные системы.

Возможности

API-PAY предоставляет широкий спектр способов приема платежей, выплат клиентам, а также иные сервисы:

• Прием платежей на нашей платежной странице, для мерчантов, которые не имеют сертификата соответствия PCI DSS или просто не хотят обрабатывать конфиденциальные данные платежных карт на своей стороне. Данный метод приема платежа позволяет как принимать оплату картой, совершать платежи по токену карты, так и использовать Apple Pay, Google Pay™, Masterpass и иные способы оплаты
• Прием платежей по host-2-host протоколу для мерчантов, имеющих сертификат PCI DSS, и работающих с данными платежных карт на своей стороне. В данном случае доступна оплата картой, либо с использованием токена ранее сохраненной карты
• Токенизация карты (возможен как отдельный метод верификации карты с токенизацией, так и получение токена карты после успешного платежа)
• Выплаты на карту с использованием полного номера карты
• Выплаты на карту с использованием токена карты
• Другие виды платежей

С чего начать?

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

Детальное описание каждого метода API, упоминающегося в документации по услугам, можно найти в соответствующем разделе Методы API.

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

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

warning

На данный момент тестовый режим доступен не для всех методов. Поэтому, если для метода нет тестового режима, мерчанту выдаются учетные данные для работы в продакшн-режиме

Получение учетных данных для работы с API

Для работы с API, вам будут выданы учетные данные для работы в тестовом окружении, которые включают:

Имя	Описание	Пример
api_url	Базовый URL для запросов к API	https://api.api-pay.net
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, если вдруг не нашли ответа в данной документации, которая регулярно дополняется на основании часто поступающих от мерчантов вопросов.

Удачной вам интеграции и скорейшего запуска в продакшн!