Скип на основной контент

Начало работы — Client Onboarding

Этот гид проведет вас через настройку 4pay.online С нуля: от получения доступа к обработке первой транзакции.

Шаг вперед 1 - Получите ваши учетные данные администратора​

После подписания договора вы получите:

  • Консоль Admin URL: https://4pay.online/admin_area/signin
  • Начальный логин администратора и пароль
  • Ваша организация ID

Войдите в систему Консоль Admin Измените свой пароль при первом входе.

Шаг вперед 2 Настройте своего первого поставщика платежей​

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

  1. В консоль администратора, перейдите к Терминалы → Новый терминал
  2. Выберите поставщика из каталога (например, Stripe, Adyen, ваш местный банк)
  3. Введите необходимые учетные данные для этого поставщика (API ключи, торговые идентификаторы и т. Д.
  4. Установите тип терминала: payment, payout, or both
  5. Установите валюты и географический охват
  6. Сохранить и активировать

Видишь? Терминалы и маршрутизация Для полного руководства и Каталог поставщиков для требуемых учетных данных на одного поставщика.

Шаг вперед 3 Создайте своего первого партнера (торговца)​

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

  1. Go to Партнеры → Новый партнер
  2. Введите имя партнера, учетные данные входа и контактную информацию
  3. Назначение терминалов партнеру — они смогут маршрутизировать транзакции только через назначенные терминалы.
  4. Сохранить и активировать

Партнер получит приглашение по электронной почте для доступа к Партнерская зона at https://4pay.online/partner_area/signin.

Видишь? Управляющие партнеры Для расширенной конфигурации партнеров.

Шаг вперед 4 - Создать ан API Ключ к партнеру​

Каждый партнер нуждается в API Ключ, чтобы сделать API Звонки.

  1. Go to Партнеры → [Имя партнёра] → API Ключи
  2. щелкнуть Создать ключ
  3. Делитесь ключом с партнером — он показывается только один раз

Партнёр использует этот ключ в x-api-key Заголовок для всех API просьбы — **Вместе с тем x-organization-id**Выполняя свою организацию UUIDКлюч находится вверху *внутри *, что организация, поэтому ключ сам по себе ничего не аутентифицирует: платформа отказывается от вызова неаутентифицированный ()401 на конечных точках платежа, 400 Дайте партнеру обоих. Ценности, а не только ключ.

Шаг вперед 5 Обработка первой тестовой транзакции​

Попросите вашего партнера запустить тестовую транзакцию с помощью песочницы. API Ключ и тест-карта. Песочница и тестирование в документации Партнера.

Или бегать быстро API дымовые испытания:

curl -X POST https://4pay.online/api/v1/session \
  -H "Content-Type: application/json" \
  -d '{"login": "your-admin@example.com", "password": "yourpassword"}'

Этот вход — намеренное исключение из правила двух заголовков: сессии admin и client не привязаны к организации, поэтому на этом этапе организацию указывать не нужно. Исключение действует только при входе. Сессия partner или person принадлежит своей организации, и возвращённый ею токен можно найти только при указании организации в запросе. Поэтому каждый последующий запрос должен содержать x-organization-id; без него токен будет считаться неизвестным. Для входа person этот заголовок также необходим; вход partner определяется и без него.

Успешный ответ с токеном сеанса подтверждает, что ваша платформа настроена и доступна.

Шаг вперед 6 - Настройка правил маршрутизации (необязательно)​

Если у вас настроено несколько терминалов, настройте Умная маршрутизация Для автоматического выбора лучшего провайдера для каждой транзакции:

  • Маршрут по валюте (например, EUR транзакции SEPA поставщик, USD → US приобретатель карточек
  • Маршрут по географии (например, азиатские транзакции → местный азиатский провайдер)
  • Маршрут по стоимости (например, сначала поставщик с самой низкой платой)
  • Правила отказа (например, если первичный поставщик терпит неудачу, повторите повторную попытку на вторичном).

Видишь? Терминалы и маршрутизация Для конфигурации маршрутизации.

Шаг вперед 7 Иди живи​

Перед тем, как отправиться в путь:

  • Все провайдеры прошли тестирование на реальных API верительные грамоты (не песочница)
  • партнер API Регенерированные ключи для производства
  • Конечные точки Webhook развернуты и проверены
  • Правила маршрутизации проверены и проверены
  • Пределы и правила борьбы с мошенничеством
  • Учетные записи команды администратора, созданные с соответствующими ролями

Поддержка​

  • Техническая посадка на борт: помощница4pay.online
  • Коммерческие вопросы: partners@2pir.org
  • Документация: docs.4pay.online