Руководство по доступу к API платежного шлюза Ближнего Востока

1. Обзор рынка платежей на Ближнем Востоке

Экология платежей на Ближнем Востоке (включая страны Совета сотрудничества стран Персидского залива GCC) характеризуется следующим:

Уровень проникновения кредитных карт высок, но наличные по-прежнему важны
Популярность местных способов оплаты, таких как Mada Card (Саудовская Аравия), Fawry (Египет) и Benefit Pay (Бахрейн)
Жесткие требования к соблюдению норм исламского финансирования
Ставки НДС обычно составляют 5%-15%

2. основные поставщики платежных шлюзов

a. PayTabs (штаб-квартира: Саудовская Аравия)

особенности::

Ведущее омни-канальное решение в регионе Персидского залива
Поддержка Mada, Apple Pay, Visa/Mastercard и др.
Хорошо документированный API и среда "песочницы

b. Telr (штаб-квартира: ОАЭ)

особенности::

Официальные рекомендованные Shopify варианты оплаты для Ближнего Востока
Одностраничные решения для оформления заказа

3. Подробное руководство по доступу к API PayTabs

a. Процесс регистрации и сертификации

Регистрация торговцев::
- Посетите веб-сайт PayTabs для подачи документов на регистрацию бизнеса (требуется английский или арабский язык)
- Для стран Персидского залива требуется копия CR (Commercial Registration).
- Регистрация налогового кода НДС (если применимо)
Проверка учетной записи::
- Проверка корпоративного банковского счета (легче пройти проверку на местных ближневосточных счетах)
- Проверка соблюдения требований AML/KYC (обычно занимает 3-5 рабочих дней)

b. базовая конфигурация API

Код примера # Python - Инициализация PayTabs

запросы на импорт



PAYTABS_MERCHANT_EMAIL = "[email protected]"

PAYTABS_SECRET_KEY = "sk_live_xxxxxxxxxxxxxxxxxx"

PAYTABS_BASE_URL = "https://secure.paytabs.com/"



заголовки = {

    "Авторизация": PAYTABS_SECRET_KEY,

    "Content-Type": "application/json"

}

c. Основные конечные точки API

функциональность	Метод HTTP	Конечная точка
Создайте страницу оплаты	ПОСТ	/платеж/запрос
Запрос сделки	ПОЛУЧИТЬ	/payment/query/{transaction_id}
Оформление возврата	ПОСТ	/ оплата/возврат

4. Основные этапы интеграции Telr

a. Подход к интеграции SDK

// Пример интеграции с фронтендом на JavaScript (встроенный платеж Telr)

TelrGateway.init({

    ключ: 'MERCHANT_KEY',

    завершить: function(response) {

        if (response.status === 'approved') { 

            // Логика успеха платежа 

        }

    }

});

b. Требования к конфигурации Webhook

Должен быть реализован следующий URL-адрес уведомления:

https://yourdomain.com/telr/callback (HTTP POST)
Content-Type: application/x-www-form-urlencoded

Рекомендации по безопасности::
1) Верификацияauthkeyпараметры
2) Настройка "белого списка" IP-адресов: 54.77..

5. специальная программа обработки карт Mada

Для оплаты картой Mada в Саудовской Аравии требуются дополнительные параметры:

{

    "payment_method": "mada",

    "customer_details": { 

        "id_number": "{номер саудовского удостоверения личности/номер икамы}".

        "bank_code": "{код банка-эмитента}".

     }

}

принимать к сведениюКомиссия за транзакции Mada обычно на 0,5%-1% ниже, чем по международным кредитным картам.

FAQ Часто задаваемые вопросы Решения

Вопрос 1: Каковы распространенные причины сбоев при выполнении вызовов API в регионах GCC?
A1.
✅ IP-адрес не внесен в белый список (обратитесь в службу технической поддержки шлюза для добавления)
✅ Ошибка расчета НДС (убедитесь, что параметр pass содержит поле tax_amount)

Q2: Местные банки, такие как Arab Bank, отказывают в проведении операций?
A2.
- Заголовок для добавления "Accept-Language": "ar"
- Адрес для выставления счетов должен содержать арабские символы

Руководство по доступу к API платежного шлюза Ближнего Востока