Bangkok Bank Mobile Banking (Bualuang mBanking)

タイ最大の資産を持つBangkok BankのBualuang mBankingアプリ経由で、全国1,800万人以上の顧客から即時決済を受け付けます。

決済フロー

Mobile Banking Payment Flow

モバイルバンキング決済プロセスのステップバイステップ:

❶ 銀行を選択 - 顧客がマーチャントのチェックアウトで銀行を選択

❷ 銀行にリダイレクト - システムが銀行の決済承認ページにリダイレクト

❸ バンキングアプリを開く - ディープリンクが銀行のモバイルアプリを自動的に起動

iOS: Universal Links経由で開く
Android: App Links経由で開く
顧客に「[銀行]アプリで開く」プロンプトが表示される

❹ 認証 - 顧客がバンキングアプリにログイン（まだログインしていない場合）

PINの入力（6桁）
指紋スキャン
Face ID認識

❺ 決済を確認 - アプリに取引詳細が表示される:

マーチャント名
決済金額
注文参照
引き落とし口座

❻ 決済を承認 - 顧客が取引を確認

銀行が要求する場合は追加のPIN/OTPを入力
「決済を確認」ボタンをタップ

❼ 決済処理 - 銀行が即座に資金を転送

❽ 確認 - アプリに成功画面が表示される

取引参照番号
ダウンロード可能な領収書

❾ マーチャントに戻る - 顧客がマーチャントのウェブサイトにリダイレクトされる

自動リダイレクトまたは「マーチャントに戻る」ボタン
注文確認ページが表示される

一般的な完了時間: 30〜90秒

概要

Bualuang mBankingは、タイ最大の総資産を持つBangkok Bankのモバイルバンキングアプリケーションです。顧客は、PINまたは生体認証を使用してモバイルアプリから直接銀行口座から安全に決済できます。

主な機能:

✅ 最大の銀行 - 1,800万人以上の顧客、タイで資産No.1
✅ 迅速な確認 - ほぼリアルタイムの決済検証（通常数秒以内）
✅ 高額制限 - 1取引あたり最大฿150,000
✅ 信頼できる機関 - 1944年設立、政府支援
✅ 24時間365日利用可能 - 休日を含めていつでも利用可能
✅ 安全な認証 - PIN、指紋、または顔認識

対応地域

地域	通貨	最小金額	最大金額	1日の制限
タイ	THB	฿20.00	฿150,000	銀行により異なる*

*1日の制限は顧客の銀行口座設定に基づいて異なり、Omiseでは指定されていません

仕組み

顧客体験:

顧客がチェックアウトで「Bangkok Bank」を選択
Bangkok Bank決済ページにリダイレクト
ディープリンク経由でBualuang mBankingアプリを開く
アプリで取引詳細を確認
6桁のPIN、指紋、またはFace IDで認証
決済を確認
マーチャントのウェブサイトに戻る

一般的な完了時間: 1〜3分

実装

ステップ1: Bangkok Bankソースを作成

curl https://api.omise.co/sources \
  -u skey_test_YOUR_SECRET_KEY: \
  -d "type=mobile_banking_bbl" \
  -d "amount=100000" \
  -d "currency=THB"

const omise = require('omise')({
    secretKey: 'skey_test_YOUR_SECRET_KEY'
});

const source = await omise.sources.create({
    type: 'mobile_banking_bbl',
    amount: 100000,  // THB 1,000.00
    currency: 'THB'
});

<?php
$source = OmiseSource::create(array(
    'type' => 'mobile_banking_bbl',
    'amount' => 100000,
    'currency' => 'THB'
));
?>

import omise

omise.api_secret = 'skey_test_YOUR_SECRET_KEY'

source = omise.Source.create(
    type='mobile_banking_bbl',
    amount=100000,
    currency='THB'
)

require 'omise'

Omise.api_key = 'skey_test_YOUR_SECRET_KEY'

source = Omise::Source.create({
  type: 'mobile_banking_bbl',
  amount: 100000,
  currency: 'THB'
})

source, err := client.Sources().Create(&operations.CreateSource{
    Type:     "mobile_banking_bbl",
    Amount:   100000,
    Currency: "THB",
})

Source source = client.sources().create(new Source.CreateParams()
    .type("mobile_banking_bbl")
    .amount(100000L)
    .currency("THB"));

var source = await client.Sources.Create(new CreateSourceRequest
{
    Type = "mobile_banking_bbl",
    Amount = 100000,
    Currency = "THB"
});

レスポンス:

{
  "object": "source",
  "id": "src_test_5rt6s9vah5lkvi1rh9c",
  "type": "mobile_banking_bbl",
  "flow": "redirect",
  "amount": 100000,
  "currency": "THB"
}

ステップ2: チャージを作成

curl https://api.omise.co/charges \
  -u skey_test_YOUR_SECRET_KEY: \
  -d "amount=100000" \
  -d "currency=THB" \
  -d "source=src_test_5rt6s9vah5lkvi1rh9c" \
  -d "return_uri=https://yourdomain.com/payment/callback"

ステップ3: 顧客をリダイレクト

app.post('/checkout/bangkok-bank', async (req, res) => {
    try {
        const { amount, order_id } = req.body;

        // 金額を検証
        if (amount < 2000 || amount > 200000000) {
            return res.status(400).json({
                error: '金額は฿20から฿2,000,000の間である必要があります'
            });
        }

        // ソースを作成
        const source = await omise.sources.create({
            type: 'mobile_banking_bbl',
            amount: amount,
            currency: 'THB'
        });

        // チャージを作成
        const charge = await omise.charges.create({
            amount: amount,
            currency: 'THB',
            source: source.id,
            return_uri: `${process.env.BASE_URL}/payment/callback`,
            metadata: {
                order_id: order_id
            }
        });

        // Bangkok Bankにリダイレクト
        res.redirect(charge.authorize_uri);

    } catch (error) {
        console.error('Bangkok Bankエラー:', error);
        res.status(500).json({ error: error.message });
    }
});

返金サポート

返金不可

Bangkok Bankモバイルバンキングは、Omise経由での返金またはキャンセルをサポートしていません。決済が完了すると、API経由で返金できません。必要に応じて銀行振込で返金を手動で処理する必要があります。

よくある問題とトラブルシューティング

問題: 顧客がBualuang mBankingアプリを持っていない

原因: 顧客がBangkok Bankを選択したがアプリがインストールされていない

解決策:

function isMobile() {
    return /Android|iPhone|iPad|iPod/i.test(navigator.userAgent);
}

if (!isMobile()) {
    alert('Bangkok Bankモバイルバンキングには、Bualuang mBankingアプリが必要です。モバイルデバイスを使用するか、別の決済方法を選択してください。');
}

ベストプラクティス

1. 明確な手順を表示

<div class="bangkok-bank-instructions">
    <h3>Bangkok Bank (Bualuang mBanking)で支払う</h3>
    <ol>
        <li>Bualuang mBankingアプリがインストールされていることを確認してください</li>
        <li>アプリを開くためにリダイレクトされます</li>
        <li>6桁のPIN、指紋、またはFace IDで認証</li>
        <li>決済を確認してください</li>
    </ol>
    <p><strong>決済は15分以内に完了する必要があります</strong></p>
    <a href="https://www.bangkokbank.com/en/Personal/Digital-Banking/Mobile-Banking">
        Bualuang mBankingをダウンロード
    </a>
</div>

FAQ

Bualuang mBankingとは何ですか？

Bualuang mBankingは、Bangkok Bankの公式モバイルバンキングアプリケーションで、1,800万人以上のユーザーがいます。顧客は、PIN、指紋、または顔認識を使用して銀行口座から直接支払うことができます。

顧客はBangkok Bank口座が必要ですか？

はい、顧客はアクティブなBangkok Bank口座とBualuang mBankingアプリがインストールされている必要があります。アプリはiOSとAndroidで無料です。

取引制限は何ですか？

1取引あたり: ฿20から฿2,000,000
1日の制限: 最大฿5,000,000（口座タイプと設定により異なる）

顧客はアプリ設定で制限を調整できます（銀行の承認が必要）。

Bangkok Bankの決済を返金できますか？

いいえ、Bangkok Bankモバイルバンキングは、Omise経由での返金またはキャンセルをサポートしていません。必要に応じて銀行振込で返金を手動で処理する必要があります。

テスト

テストモード

Bangkok Bank Mobile BankingはテストAPIキーを使用してテストできます。テストモードでは:

テスト認証情報:

テストAPIキーを使用（skey_test_xxx）
通貨: THB（タイバーツ）
テストに実際のBangkok Bank口座は不要

テストフロー:

テストAPIキーでソースとチャージを作成
顧客をテストauthorize_uriにリダイレクト
テストページがBangkok Bankモバイルバンキング承認をシミュレート
Omiseダッシュボードアクションを使用してチャージを成功/失敗としてマーク
WebhookとReturn_uri処理を検証

包括的なテストガイドラインについては、テストドキュメントを参照してください。

次のステップ

Bangkok Bankソースを作成
リダイレクトフローを実装
Webhook処理を設定
決済フローをテスト
本番環境に移行

決済フロー​

概要​

対応地域​

仕組み​

実装​

ステップ1: Bangkok Bankソースを作成​

ステップ2: チャージを作成​

ステップ3: 顧客をリダイレクト​

返金サポート​

よくある問題とトラブルシューティング​

問題: 顧客がBualuang mBankingアプリを持っていない​

ベストプラクティス​

1. 明確な手順を表示​

FAQ​

テスト​

テストモード​

関連リソース​

次のステップ​