중동 결제 게이트웨이 API 액세스 가이드

1. 중동 결제 시장 개요

중동(걸프협력회의 GCC 국가 포함)의 결제 생태계는 다음과 같은 특징이 있습니다:

• 신용카드 보급률은 높지만 여전히 현금이 중요합니다.
• Mada Card(사우디아라비아), Fawry(이집트), Benefit Pay(바레인) 등 현지 결제 수단 인기도
• 이슬람 금융에 대한 엄격한 규정 준수 요건
• 부가가치세율은 일반적으로 5%-15%입니다.

2. 주류 결제 게이트웨이 제공업체

a. PayTabs(본사: 사우디아라비아)

특수성::

• GCC 지역의 선도적인 옴니채널 솔루션
• 마다, 애플 페이, 비자/마스터카드 등을 지원합니다.
• 잘 문서화된 API 및 샌드박스 환경

b. Telr(본사: 아랍에미리트)

특수성::

• Shopify의 중동 지역 공식 권장 결제 옵션
• 원페이지 결제 솔루션

3. 페이탭 API 액세스 상세 가이드

a. 등록 및 인증 절차

1. 판매자 등록::

   • PayTabs 웹사이트를 방문하여 사업자 등록 서류를 제출하세요(영어 또는 아랍어 필수).
   • GCC 국가에서는 상업 등록(CR) 사본이 필요합니다.
   • 부가가치세 세금 코드 등록(해당되는 경우)

2. 계정 인증::

   • 법인 은행 계좌 인증(중동 현지 계좌가 더 통과하기 쉬움)
   • AML/KYC 규정 준수 검토(보통 영업일 기준 3~5일 소요)

b. API 기본 구성

# 파이썬 샘플 코드 - 페이탭 초기화

가져오기 요청



페이탭_판매자_이메일 = "[email protected]"

페이탭_비밀키 = "sk_live_xxxxxxxxxxxx"

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



헤더 = {

    "권한 부여": PAYTABS_SECRET_KEY,

    "콘텐츠 유형": "application/json"

}

c. 핵심 API 엔드포인트

4. Telr 통합 주요 단계

a. SDK 통합 접근 방식

// 자바스크립트 프론트엔드 통합 예시(Telr 임베디드 결제)

TelrGateway.init({

    키: 'MERCHANT_KEY',

    완료: 함수(응답) {

        if (response.status === '승인됨') { 

            // 결제 성공 로직 

        }

    }

});

b. 웹훅 구성 요구 사항

다음 알림 URL을 구현해야 합니다:

• https://yourdomain.com/telr/callback (HTTP POST)
• 콘텐츠 유형: application/x-www-form-urlencoded

보안 권장 사항::
1) 인증authkey매개변수
2) IP 화이트리스트 설정: 54.77..

5. 마다 카드 특별 취급 프로그램

사우디아라비아에서 Mada 카드를 결제하려면 추가 매개 변수가 필요합니다:

{

    "결제_방법": "마다",

    "customer_details": { 

        "id_number": "{사우디 ID 번호/이카마 번호}".

        "bank_code": "{발행 은행 코드}"

     }

}

다음 사항에 유의하십시오.Mada 거래 수수료는 일반적으로 국제 신용카드보다 0.51%~1% 낮습니다.

자주 묻는 질문 솔루션

Q1: GCC 지역에서 API 호출 실패의 일반적인 원인은 무엇인가요?
A1.
✅ 화이트리스트에 없는 IP(추가하려면 게이트웨이 기술 지원팀에 문의)
✅ VAT 계산 오류(pass 매개변수에 tax_amount 필드가 포함되어 있는지 확인)

Q2: 아랍 은행과 같은 현지 은행에서 거래를 거부하나요?
A2.
- 추가할 헤더 "수락 언어": "ar"
- 청구 주소에는 아랍어 문자 버전이 포함되어야 합니다.