ベトナムデジタルウォレット開発者リソース集

以下は、ベトナムのデジタルウォレット開発者向けのリソース集で、主要な決済プラットフォーム、APIドキュメント、技術仕様、ローカリゼーションサポート情報などを網羅し、開発者がベトナム市場に迅速にアクセスできるよう支援します：

I. ベトナムの主流デジタルウォレットとデベロッパーポータル

モモ・ウォレット
- 公式サイト https://momo.vn
- 開発者のドキュメント。 Momoデベロッパーポータル
  - 決済、送金、QRコード生成などのAPIをサポート。
  - サンドボックス環境はテストツールを提供
ザロペイ
- 公式サイト https://zalopay.vn
- APIドキュメント。 ZaloPayオープンAPI
  - 統合ガイド（Java/PHPサンプルコード付き）
ベトテルペイ (電気通信事業者の経歴）
- デベロッパー・センターベトテル・デジタル・サービス
ブイエヌペイ (銀行同盟プログラム）
- APIゲートウェイ。 VNPAY統合マニュアル

II.主要技術とコンプライアンス要件

安全認証
- PCI DSS準拠（クレジットカードデータを処理する場合）
  参考までに：ベトナム国立銀行セキュリティ基準
QRコード規格
ベトナム共通QRコード仕様を使用する：VMQR (国際EMVCoに対応）
エッセンシャル・ファンクション・インターフェースサンプル・コード・リポジトリ（Github）::

# Momo QR生成例（Python）

輸入リクエスト

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

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

データ = {

    「金額」：100000。

    「orderId": "ORDER_123"、

    "redirectUrl": "your_callback_url" 

}

response = requests.post(api_endpoint, json=data, headers=headers)

III.サンドボックス・テスト・アカウント・アプリケーション・ルート
| プラットフォーム｜リンクのリクエスト｜限度額のテスト
|————|———————————–|——————|
| ザロペイ｜developers.zalopay/sandbox-signup｜≦500,000VND/pen｜｜。
| モモ｜momo.dev/sandbox-request｜≦200,000VND/pen｜｜。

IV.ローカリゼーションへの配慮

言語サポートUIはデフォルトでベトナム語＋英語（オプション）が必要
2.手数料モデル通常0.5%～1.%取引（クロスボーダー決済の場合はそれ以上）
3.ホットシナリオAPI:
-電話料金の支払いトップアップ)/公共料金の支払い(ビルペイ)
4.ユーザー認証：ドッキングが必要eKYCVNG ID](( https ://id .vng.com .vn )) などのサービス。

最新のポリシーアップデートやテクニカルサポートのために、公式開発者コミュニティ（Facebookグループまたはフォーラム）に参加することをお勧めします。

以下は、ベトナムデジタルウォレット開発者リソースの上級補足資料で、より実用的なツール、政策の詳細、生態系の調整に関するアドバイスをカバーしています：

V. 高度な開発のためのリソースとツール

SDK公式ライブラリ
- Momo Android/iOS SDKGitHubリポジトリは以下を提供する。サンプルプロジェクト
- ZaloPay Webhookデバッグツールコールバックリクエストのリアルタイムシミュレーション（開発者バックエンドへのログインが必要です。）

サードパーティのパッケージング・ライブラリ（コミュニティによるメンテナンス）

// VNPAY for Node.js 非公式パッケージ (npm install)

const vnpay = require('vnpay-sdk')；

const client = new vnpay.Client({)

    merchantCode: 'YOUR_MERCHANT_ID'、

    secureSecret: 'YOUR_HASH_KEY'

});

ポストマンAPIコレクション
複数のプラットフォームで、Postmanの設定済み環境ファイルが提供されている：
- ベトテルペイ・コレクション

コンプライアンスとバンク・ドッキングのポイント

クロスボーダー決済ライセンス
国際的な収集が含まれる場合は、追加のライセンスが必要です。SBV 21/2024号)
マネーロンダリング防止（AML）インターフェース要件
政府が義務付けている認証システムのいずれかを統合しなければならない：
- 全国eKYCプラットフォーム (市民データベース直リンク)
手数料税処理APIサンプルコード:

// ベトナム現地VAT計算（ビジネスアカウント用）

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 -> throw new IllegalArgumentException()；

    };

    金額 * レートを返す。

}

VIII.代替プログラムと待機的サービス・プロバイダー

失敗した取引の自動切り替え以下の代替ゲートウェイにアクセスできる：

グラフLR。

A[メインチャンネル：モモ]→B{ステータスコード≠200}。

B --> C [ZaloPayに格下げ]。

C --> D [最終的に銀行振込にフォールバック]。

2.ニッチだが急成長中のウォレットAPI:

ShopeePay（ショッピーペイ (eコマースシナリオの優位性)
グラブペイ・ベトナム

IX、デバッグスキル、一般的なエラーコード表

典型的なエラーと解決策
| HTTPステータスコード｜モモエラーコード｜意味｜対策
|————|————

ベトナムデジタルウォレット開発者リソース集