DuitNow Online Banking/Wallets (OBW)

DuitNow OBWを使用して、マレーシアの顧客からオンラインバンキングポータルまたはデジタルウォレット経由で支払いを受け付けます。

概要

DuitNow OBW（Online Banking/Wallets）は、加盟店が顧客の銀行オンラインバンキングポータルやデジタルウォレットを通じて支払いを受け付けることができます。顧客が銀行のセキュアなプラットフォームで認証し、支払いを承認するリダイレクトベースのフローを使用します。

主な特徴:

✅ 18以上の銀行をサポート - マレーシアのすべての主要銀行
✅ 安全な銀行認証 - 顧客は銀行のプラットフォームで承認
✅ リダイレクトフロー - シンプルなリダイレクト統合
✅ リアルタイム確認 - 即時の支払い確認
✅ 180日間の返金期間 - 全額および部分返金をサポート

有効化が必要です

DuitNow OBWを加盟店アカウントで有効にするには、support@omise.coまでお問い合わせください。

対応地域

地域	通貨	最小金額	最大金額	APIバージョン
マレーシア	MYR	RM1.00	RM20,000.00	`2017-11-02`

対応銀行

銀行コード	銀行名
`affin`	Affin Bank
`alliance`	Alliance Bank
`agro`	AGRONet
`ambank`	AmBank
`islam`	Bank Islam
`muamalat`	Bank Muamalat
`rakyat`	Bank Rakyat
`bsn`	BSN
`cimb`	CIMB Clicks
`hongleong`	Hong Leong Bank
`hsbc`	HSBC
`kfh`	KFH
`maybank2u`	Maybank2U
`ocbc`	OCBC
`publicbank`	Public Bank
`rhb`	RHB Bank
`sc`	Standard Chartered
`uob`	UOB

仕組み

決済フロー:

顧客がDuitNow OBWを選択し、銀行を選ぶ
加盟店が銀行コード付きソースを作成
顧客が銀行のオンラインバンキングにリダイレクト
顧客がログインしてOTPで支払いを確認
顧客が加盟店サイトに戻る
Webhookで支払いステータスを確認

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

実装

ステップ1: ソースの作成

cURL
Node.js
PHP
Omise.js

curl https://api.omise.co/sources \
  -u $OMISE_PUBLIC_KEY: \
  -d "amount=150000" \
  -d "currency=MYR" \
  -d "type=duitnow_obw" \
  -d "bank=maybank2u"

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

const source = await omise.sources.create({
    type: 'duitnow_obw',
    amount: 150000,  // MYR 1,500.00
    currency: 'MYR',
    bank: 'maybank2u'  // 顧客が選択した銀行
});

<?php
$source = OmiseSource::create([
    'type' => 'duitnow_obw',
    'amount' => 150000,
    'currency' => 'MYR',
    'bank' => 'maybank2u'
]);
?>

Omise.setPublicKey(omise_public_key);

Omise.createSource('duitnow_obw', {
    amount: 150000,
    currency: 'MYR',
    bank: 'maybank2u'
}, function(statusCode, response) {
    console.log(response);
});

ステップ2: 課金の作成

curl https://api.omise.co/charges \
  -u $OMISE_SECRET_KEY: \
  -d "amount=150000" \
  -d "currency=MYR" \
  -d "return_uri=https://example.com/payment/complete" \
  -d "source=src_test_xxx"

統合リクエスト

ソースと課金を1つのリクエストで作成:

curl https://api.omise.co/charges \
  -u $OMISE_SECRET_KEY: \
  -d "amount=150000" \
  -d "currency=MYR" \
  -d "return_uri=https://example.com/payment/complete" \
  -d "source[type]=duitnow_obw" \
  -d "source[bank]=maybank2u"

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

// 銀行のオンラインバンキングポータルにリダイレクト
window.location.href = charge.authorize_uri;

ステップ4: Webhookの処理

app.post('/webhooks/omise', (req, res) => {
    const event = req.body;

    if (event.key === 'charge.complete') {
        const charge = event.data;

        if (charge.status === 'successful') {
            fulfillOrder(charge.metadata.order_id);
        } else if (charge.status === 'failed') {
            notifyCustomer(charge.metadata.order_id, charge.failure_message);
        }
    }

    res.status(200).send('OK');
});

銀行選択UI

顧客向けの銀行選択ドロップダウンを表示:

<div class="bank-selection">
    <label for="bank">銀行を選択:</label>
    <select id="bank" name="bank" required>
        <option value="">-- 銀行を選択してください --</option>
        <option value="maybank2u">Maybank2U</option>
        <option value="cimb">CIMB Clicks</option>
        <option value="publicbank">Public Bank</option>
        <option value="rhb">RHB Bank</option>
        <option value="hongleong">Hong Leong Bank</option>
        <option value="ambank">AmBank</option>
        <option value="affin">Affin Bank</option>
        <option value="alliance">Alliance Bank</option>
        <option value="islam">Bank Islam</option>
        <option value="muamalat">Bank Muamalat</option>
        <option value="rakyat">Bank Rakyat</option>
        <option value="bsn">BSN</option>
        <option value="hsbc">HSBC</option>
        <option value="ocbc">OCBC</option>
        <option value="sc">Standard Chartered</option>
        <option value="uob">UOB</option>
    </select>
</div>

課金ステータス値

ステータス	説明
`pending`	銀行での顧客承認待ち
`successful`	支払い完了
`failed`	支払い拒否または処理エラー
`expired`	顧客が7日以内に完了しなかった

失敗コード

コード	説明
`payment_expired`	承認期間が終了
`payment_rejected`	銀行が取引を拒否
`failed_processing`	一般的な処理エラー
`invalid_account`	支払いに有効なアカウントがない
`insufficient_fund`	残高または限度額が不足

返金

DuitNow OBWは、取引から180日以内の全額および部分返金をサポートしています:

// 全額または部分返金
const refund = await omise.charges.refund('chrg_test_xxx', {
    amount: 50000  // MYR 500.00の部分返金
});

ベストプラクティス

銀行ロゴを表示 - 選択用に認識しやすい銀行ロゴを表示
処理中を表示 - リダイレクト中にローディング状態を表示
タイムアウトを処理 - 顧客は支払いを完了するのに7日間の猶予がある
Webhookを優先 - 常にWebhookで注文処理を行う
モバイル最適化 - 銀行ポータルはモバイルデバイスでも動作

よくある質問

DuitNow OBWとは何ですか？

DuitNow OBW（Online Banking/Wallets）は、マレーシアの顧客が銀行のオンラインバンキングポータルを通じて直接支払いを行うことができる決済方法です。顧客は銀行を選択し、ログイン用にリダイレクトされ、OTP確認で支払いを承認します。

DuitNow OBWとDuitNow QRの違いは何ですか？

DuitNow OBW: 顧客は銀行のオンラインバンキングポータルにリダイレクトされて支払いを承認します。デスクトップやウェブチェックアウトフローに適しています。

DuitNow QR: 顧客は銀行アプリや電子ウォレットでQRコードをスキャンします。店舗決済やモバイルファーストの体験に適しています。

どちらもマレーシアのDuitNow決済インフラの一部です。

どの銀行がサポートされていますか？

DuitNow OBWは、Maybank、CIMB、Public Bank、RHB、Hong Leong、AmBank、Affin、Alliance、Bank Islam、Bank Muamalat、Bank Rakyat、BSN、HSBC、OCBC、Standard Chartered、UOBを含む18以上のマレーシアの銀行をサポートしています。

顧客が支払いを完了するまでの期間はどのくらいですか？

顧客は課金作成後、支払いを完了するまで最大7日間の猶予があります。ただし、個々の銀行セッションのタイムアウトはより短い場合があります。支払いが完了しない場合、課金ステータスはexpiredになります。

DuitNow OBW支払いを返金できますか？

はい、元の取引日から180日以内であれば、全額返金と部分返金の両方がサポートされています。

DuitNow OBWはFPXより優れていますか？

DuitNow OBWとFPXはどちらもマレーシアでのオンラインバンキング決済を可能にします。DuitNow OBWはPayNetのDuitNowインフラの下での新しい標準です。どちらも同様に機能します - 既存の統合や加盟店アカウントでのPayNet/FPXの利用可能性に基づいて選択してください。

概要​

対応地域​

対応銀行​

仕組み​

実装​

ステップ1: ソースの作成​

ステップ2: 課金の作成​

統合リクエスト​

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

ステップ4: Webhookの処理​

銀行選択UI​

課金ステータス値​

失敗コード​

返金​

ベストプラクティス​

よくある質問​

関連リソース​

概要