インドネシア現地決済SDKの概要とインターフェイスガイド

インドネシア現地決済SDKの概要とインターフェイスガイド

紹介

東南アジアにおけるデジタル経済の急速な成長に伴い、同地域最大の市場の一つであるインドネシアでは、電子決済に対する需要が引き続き高まっている。インドネシア市場への参入を目指す企業にとって、現地の決済手段へのアクセスは非常に重要です。この記事では、開発者が効率的に統合を完了し、ユーザーエクスペリエンスを最適化できるよう、インドネシアで主流のローカル決済SDKとそのドッキングプロセスについて詳しく紹介する。

なぜインドネシア現地決済へのアクセスが必要なのですか？

  1. ユーザー行動インドネシアの消費者の多くは、国際クレジットカードよりも現地の電子財布や銀行振込を好む。
  2. 政策遵守規制上の要件を満たすため、一部の取引は現地チャネルを通じて行う必要がある。
  3. コンバージョン率の向上馴染みのある支払い方法を提供することで、離脱率を大幅に減らすことができる。

インドネシア現地決済SDKの概要

1.ダナ

  • 簡単アント・グループが投資する電子財布で、小売、請求書支払い、その他のシナリオをカバーする。
  • 適用シナリオEコマース、ゲームチャージ、請求書支払い。
  • 料金表約1%～2%。
  • APIドキュメンテーションアドレス::DANAデベロッパーセンター(要登録）

2.OVO（オーヴォ

  • 簡単QRコードとオンライン決済をサポートするGrabのエコ支援型ヘッドウォレット。
  • 特性::
    • 分割払いのサポート（PayLater）
    • 高いオフライン加盟店カバー率
  • ドッキング法：
    • モバイル向けREST APIとSDKを提供
    • テスト・サンドボックス環境の改良

3.リンクアジャ

  • 国有の背景複数の銀行や通信事業者の残高を統合するアグリゲーション・プラットフォームである。
    |特長|解説|解説
    |—|—|
    |決済サイクル｜T+3営業日
    |最安手数料|0.5%

注：本番環境にサインアップするためには、BPJタックスファイルの提出が必要です。

4.銀行振込（バーチャル口座）
マンディリのVA、BCAのVAなど。

//擬似コードのサンプル：BCA仮想アカウントを生成する

PaymentRequest request = new PaymentRequest()

 .setAmount(50000)

 .setCustomerId("USER123"); .

レスポンス resp = BcaSdk.createVirtualAccount(request)；

一般的なドッキング手順

1.資格取得の準備
   

インドネシア現地決済SDKドッキングステップ詳細

1.資格の準備

インドネシアのローカル決済SDKにアクセスする前に、企業は以下の基本的な資料が利用可能であることを確認する必要がある：

  • 会社登記書類(営業許可証、税務登録証明書など）
  • 銀行口座情報(通常、インドネシア現地の銀行口座が必要)
  • APIリクエストフォーム(支払者によっては記入・提出が必要）
  • BPJS Ketenagakerjaan (社会保障番号、LinkAjaなど一部のプラットフォームでは必須)

⚠️ 注：支払い方法によっては、資格取得のための追加要件がある場合がある。例えば、OVOはグラブとの協力関係を証明するものを要求する場合がある。

2.適切な統合モデルの選択

ビジネスのニーズに応じて適切なドッキング方法を選択します：

統合モード 適用シナリオ 長所と短所
直接API/SDK統合 - B2C eコマース、ゲーム・トップアップ
- 高頻度取引業務		 高い柔軟性
❌ 開発費の増加
サードパーティのアグリゲーション・プラットフォーム（Xendit、Midtransなど） -迅速なアクセスが可能な中小企業
-複数の決済チャネルを一元管理		 低コード／無コード番組
手数料がやや高い。

3.SDKのダウンロードと環境設定

例えばDANA：

  1. インタビュー開発者ポータルアカウント登録
  2. Android/iOS SDKをダウンロードするか、REST APIドキュメントを入手してください。
  3. 鍵をテストするためにサンドボックス環境を設定する： 
    # Android サンプル gradle 依存関係
    
実装 'id.dana:sdk:3.12.0'

4.コア機能 ドッキング

(1) SDKの初期化

// OVO SDKの初期化例

OvoPayment.init(

    context = applicationContext、

    merchantId = "YOUR_MID"、

    apiKey = "TEST_123456"

)

(2) 支払い請求を開始する

代表的なパラメータは以下の通り：

  • オーダーID (マーチャントオーダー番号）
  • 量 (IDRに換算される金額）
  • カスタマーフォン (OVO/DANAプッシュ用ユーザーの携帯電話番号）

(3) コールバック通知の処理

実装しなければならないサーバー側のロジック：

# DANAコールバック署名を検証するフラスコの例

app.route('/dana/callback', methods=['POST'])

def handle_callback().

    signature = request.headers.get('X-DANA-SIGNATURE')

    if verify_signature(request.data, signature).

        update_order_status(request.json['orderId'])

        OK",200を返す

5.テストと本番稼動のポイント

(1) サンドボックス・テスト・プロセス
テスト環境はすべての主要プロバイダーから提供されている。
|DANAサンドボックス|OVOステージング
|—|—|—|
バーチャルアカウント|88810000001‾100(固定)|ダイナミックジェネレーション

⚠️ 共通エラーコード処理。

40030：残高不足（DANA）

RP03: ユーザーキャンセル（OVO PayLater）

(2) 生産環境の切り替え条件

以下のステップを完了し、ライブを開始する。
✅ 少なくとも 20 回のテストトランザクションに合格したこと
✅ 正式な協力協定の締結
✅ セキュリティ監査の完了（一部の銀行 VA は HTTPS + IP ホワイトリストを要求する）

6.最適化の推奨とコンプライアンス事項

パフォーマンス最適化
✔️ ローカルキャッシュを有効にして、よく使われるトークンを保存する。
✔️ 和解文書の非同期処理

法的リスクの回避
ギャンブルなどの違法産業へのアクセスを禁止する（PHYTONなどのプラットフォームは定期的にスキャンされる）。
取引記録を少なくとも10年間保存する（BI規則No22/2019に準拠）。

コードベースの完全なリファレンスは、GitHubで "indonesia-payment-samples "を検索してください。例えば、2024年第2四半期にGoPayは新しい暗号化標準AES-GCMに移行する。