中東決済ゲートウェイAPIアクセスガイド

中東決済ゲートウェイAPIアクセスガイド

1.中東決済市場の概要

中東（湾岸協力会議GCC諸国を含む）の支払いエコロジーの特徴は以下の通りである：

  • クレジットカードの普及率は高いが、現金の重要性は依然として高い
  • Mada Card（サウジアラビア）、Fawry（エジプト）、Benefit Pay（バーレーン）など、現地の決済方法の人気
  • イスラム金融に対する厳しいコンプライアンス要件
  • VAT税率は通常5%-15%である。

2.主流の決済ゲートウェイプロバイダー

a. ペイタブ（本社：サウジアラビア）

特性::

  • GCC地域をリードするオムニチャネル・ソリューション
  • Mada、Apple Pay、Visa/Mastercardなどに対応。
  • 十分に文書化されたAPIとサンドボックス環境

b. Telr（本社：アラブ首長国連邦）

特性::

  • Shopifyが中東で公式に推奨する支払い方法
  • ワンページ・チェックアウト・ソリューション

3.ペイタブAPIアクセス詳細ガイド

a. 登録と認証プロセス

  1. マーチャント登録::

    • ペイタブズのウェブサイトにアクセスし、事業登録書類を提出する（英語またはアラビア語が必要です）
    • GCC諸国ではCR（商業登記）のコピーが必要。
    • VATタックスコード登録（該当する場合）

  2. アカウント認証::

    • 法人銀行口座確認（中東現地口座の方が通りやすい）
    • AML/KYCコンプライアンス審査（通常3～5営業日かかる）

b. APIベース構成

# Pythonサンプルコード - PayTabsの初期化

輸入リクエスト



paytabs_merchant_email = "[email protected]"

PAYTABS_SECRET_KEY = "sk_live_xxxxxxxxxxxx"

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



ヘッダー = {

    「Authorization": PAYTABS_SECRET_KEY、

    「Content-Type": "application/json"

}

c. コア API エンドポイント

官能性 HTTPメソッド エンドポイント
支払いページの作成 ポスト /支払い/リクエスト
取引照会 ゲット /payment/query/{transaction_id}。
返金処理 ポスト /支払い/払い戻し

4.Telr統合の主なステップ

a. SDK統合アプローチ

// JavaScriptフロントエンド統合の例（Telr埋め込み決済）

TelrGateway.init({)

    キー: 'MERCHANT_KEY'、

    complete: function(response) {

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

            // 支払い成功のロジック 

        }

    }

});

b. Webhookの構成要件

以下の通知URLを実装する必要がある：

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

セキュリティに関する推奨事項::
1) 検証認証キーパラメーター
2) IPホワイトリスト設定：54.77..

5.マダカード特別取扱プログラム

サウジアラビアでのマダカード決済には追加パラメータが必要です：

{

    "payment_method"："mada"、

    "customer_details": { 

        「id_number": "{サウジアラビアID番号/イカーマ番号}".

        "bank_code": "{発行銀行コード}"

     }

}

銘記するマダの決済手数料は通常、国際クレジットカードより0.5%-1%安い。

FAQ よくある質問 ソリューション

Q1: GCC地域でAPIコールに失敗する一般的な理由は何ですか？
A1.
✅ IP がホワイトリストに登録されていない (ゲートウェイのテクニカルサポートに連絡して追加する)
✅ VAT計算エラー（passパラメータにtax_amountフィールドが含まれ ていることを確認してください。）

Q2: アラブ銀行などの地方銀行は取引を拒否しているのか？
A2.
- 追加するヘッダー 「Accept-Language": "ar"
- 請求先住所にはアラビア文字が含まれていること