Работает с

Добавьте армянские платежи в любой сайт или приложение

Если ваш сайт или приложение - собственный код, вы интегрируетесь один раз с REST API Paynet и получаете за ним каждый способ: карты через сеть ARCA, Idram, Telcell и ArcaQR. Суммы указываются в целых армянских драмах. Создание платежа - это один POST, покупатель переходит на размещённую страницу оплаты, а истина о заказе всегда на расстоянии одного GET. Есть JavaScript SDK, если вы предпочитаете удерживать покупателя на своей странице - встроенно или в модальном окне.

Создать бесплатный аккаунт Читать документацию для разработчиков

Как это работает

  1. 01

    Создайте API-ключ в панели управления. Он показывается один раз, поэтому храните его в переменной окружения и никогда в коде браузера; тестовый ключ превращает каждый созданный им платёж в тестовый платёж sandbox.

  2. 02

    Создайте платёж на своём сервере: POST /api/v1/payments с суммой в целых драмах, собственным ID заказа и URL возврата на верифицированном домене.

  3. 03

    Отправьте покупателя на полученный checkout_url, либо передайте его JS SDK, чтобы открыть встроенно или модальным окном.

  4. 04

    Подтвердите исход, когда покупатель возвращается, считав GET /api/v1/orders/{order_id}/payment, вместо того чтобы доверять редиректу, с которым он пришёл.

  5. 05

    Проверьте вебхук - это строчный шестнадцатеричный HMAC-SHA256 сырого тела в заголовке X-Paynet-Signature, устраните дубли по delivery id, быстро ответьте 200 и считайте платёж обратно, прежде чем пометить заказ оплаченным.

Что понадобится

  • Сервер, способный хранить секретный ключ и принимать HTTPS-коллбэк.
  • Домен, верифицированный в Paynet: ваши URL возврата, отмены и коллбэка должны находиться на нём.
  • Собственные учётные данные провайдера для способов, которые вы хотите предложить, и верификацию бизнеса перед реальными платежами.

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

Способы оплаты, которые вы можете предложить

Idram Принимайте платежи Idram на своём сайте Telcell Принимайте платежи Telcell на своём сайте Банковские карты ARCA Принимайте карты Visa, Mastercard и ArCa онлайн ArcaQR Принимайте платежи по QR из банковского приложения

Вопросы

Четыре, плюс вебхук, который вы размещаете у себя: создать платёж, прочитать платёж по uuid или по собственному ID заказа, и вернуть деньги. Платёжные ссылки, балансы и список способов, которые предлагает домен, доступны, когда захотите, но ни одна интеграция не обязана их использовать.
Отправляйте заголовок Idempotency-Key при создании платежа: повтор с тем же ключом в течение 24 часов возвращает исходный платёж с кодом 200 вместо создания второго. Возвраты тоже принимают Idempotency-Key, а вебхуки несут delivery id для устранения дублей.
Всё. Используйте тестовый ключ или провайдера Sandbox, и номер карты определяет исход: одобрено, отклонено эмитентом, недостаточно средств, тайм-аут процессора, ошибка 3-D Secure и другие. Вебхуки срабатывают с livemode false, ничего не списывается, а тестовые платежи находятся в панели управления на отдельной вкладке.
Это v1, и он останется v1. Изменения только добавляют: поля никогда не удаляются, не переименовываются и не меняют тип, коды ошибок никогда не меняют смысл, а нагрузки вебхуков только приобретают новые ключи. Всё, что когда-либо придётся убрать, объявляется минимум за 90 дней по электронной почте и в списке изменений. Игнорируйте незнакомые вам ключи, и ваша интеграция продолжит работать.

Примите первый платёж уже сегодня

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

Создать бесплатный аккаунт

Idram, Telcell, ARCA, ArcaQR, а также названия банков и платформ на этой странице являются товарными знаками их владельцев; Paynet - независимый платёжный шлюз и не связан ни с одним из них и не одобряется ими.