베트남 디지털 지갑 개발자 리소스 모음

아래는 베트남의 디지털 지갑 개발자를 위한 리소스 모음으로, 주요 결제 플랫폼, API 문서, 기술 사양, 현지화 지원 정보 등 개발자가 베트남 시장에 빠르게 진출하는 데 도움이 되는 정보를 담고 있습니다:

I. 베트남의 주류 디지털 지갑 및 개발자 포털

  1. 모모 월렛

    • 공식 웹사이트. https://momo.vn
    • 개발자 문서. 모모 개발자 포털
      • 결제, 송금, QR코드 생성 등을 위한 API를 지원합니다.
      • 샌드박스 환경에서 테스트 도구 제공

  2. ZaloPay

  3. ViettelPay (통신 사업자 배경)

  4. VNPAY (은행 연합 프로그램)

II. 주요 기술 및 규정 준수 요구 사항

  1. 안전 인증

  2. QR코드 표준
    베트남 공통 QR코드 규격을 사용합니다:VMQR (국제 EMVCo와 호환)

  3. 필수 기능 인터페이스 샘플 코드 리포지토리(Github)::

# 모모 QR 생성 예제(Python)

가져오기 요청

api_endpoint = "https:/payment.momo/v1/generate-qr"

headers = {"X-Access-Key": "YOUR_KEY"}

data = {

    "금액": 100000.

    "orderId": "ORDER_123",

    "redirectUrl": "your_callback_url" 

}

응답 = requests.post(api_endpoint, json=데이터, headers=헤더)

샌드박스 테스트 계정 신청 경로
| 플랫폼 | 링크 요청하기 | 테스트 금액 제한 |
|————|———————————–|——————|
| ZaloPay | developers.zalopay/sandbox-signup | ≤500,000 VND/펜 | ≤500,000 VND/펜
| 모모 | momo.dev/sandbox-request | ≤200,000 VND/펜 | ≤200,000 VND/펜

IV. 현지화 고려 사항

  1. 언어 지원UI는 기본적으로 베트남어 + 영어 옵션이어야 합니다.
    2.수수료 모델:: 일반적으로 0.51 TP3T~1.1 TP3T 거래(해외 결제의 경우 더 높음)
    3.핫 시나리오 API:
    -휴대전화 요금 충전(충전) /공과금 납부(billpay)
    4. 사용자 인증: 도킹 필요eKYCVNG ID](( https ://id .vng.com .vn ))와 같은 서비스

최신 정책 업데이트 및 기술 지원을 받으려면 공식 개발자 커뮤니티(Facebook 그룹 또는 포럼)에 가입하는 것이 좋습니다.

아래는 베트남 디지털 지갑 개발자 리소스에 대한 고급 보충 자료로, 보다 실용적인 도구, 정책 세부 사항 및 생태학적 정렬에 대한 조언을 다루고 있습니다:

V. 고급 개발을 위한 리소스 및 도구

  1. SDK 공식 라이브러리

    • 모모 안드로이드/iOS SDKGitHub 리포지토리는 다음을 제공합니다.샘플 프로젝트
    • ZaloPay 웹훅 디버깅 도구콜백 요청의 실시간 시뮬레이션(개발자 백엔드 로그인 필요)

  2. 타사 패키징 라이브러리(커뮤니티 유지 관리)

    // Node.js용 VNPAY 비공식 패키지(npm 설치)
    
const vnpay = require('vnpay-sdk');
    
const client = new vnpay.Client({
    
    판매자 코드: 'YOUR_MERCHANT_ID',
    
    secureSecret: 'YOUR_HASH_KEY'
    
});

  3. Postman API 컬렉션
    여러 플랫폼에서 사전 구성된 Postman 환경 파일을 제공합니다:

VI. 규정 준수 및 뱅크 도킹 주요 사항

  1. 해외 결제 라이선스
    해외 수집이 포함되는 경우 추가 라이선스가 필요합니다(참조).SBV 번호 21/2024)

  2. 자금 세탁 방지(AML) 인터페이스 요구 사항
    정부에서 요구하는 인증 시스템 중 하나를 통합해야 합니다:

  3. 수수료 세금 처리 API 샘플 코드:

// 베트남 현지 부가가치세 계산(비즈니스 계정용)

public double calculateVAT(double amount, String serviceType) {

    double rate = switch(serviceType) {

        case "DOMESTIC_PAYMENT" -> 0.01; // 1% VAT

        case "CROSS_BORDER" -> 0.05; // 5% VAT

        default -> 새로운 IllegalArgumentException()을 던집니다;

    };

    반환 금액 * 요율.

}

VII. 성능 최적화 권장 사항
| 장면 | 추천 솔루션
|———————|———————————–|
| QR코드 고주파 생성 | CDN 캐싱 + 사전 생성 메커니즘 | QR코드 고주파 생성
| OTP SMS 지연 | 여러 이동 통신사에 대한 액세스 (예VinSMS) |
| 웹훅 시간 초과 | AWS 람다 베트남 노드 배포(ap-southeast-1) |

VIII. 대체 프로그램 및 대기 서비스 제공업체

  1. 실패한 거래의 자동 전환다음과 같은 대체 게이트웨이에 액세스할 수 있습니다:
그래프 LR.

A[메인 채널:모모] --> B{상태 코드 ≠ 200}.

B --> C [ZaloPay로 다운그레이드됨].

C --> D [최종적으로 은행 송금으로 대체].

2.틈새 시장이지만 빠르게 성장하는 지갑 API:

IX, 디버깅 기술 및 일반적인 오류 코드 표

일반적인 오류 및 해결 방법
| HTTP 상태 코드 > 모모 오류 코드 > 의미 > 대책 > 대책
|————|————