Alipay HK

Alipay HK決済方法を使用して、ウェブサイトでAlipay香港ユーザーからのオンライン決済を受け付けます。

概要

Alipay HKは、加盟店がAlipayHKウォレットを使用する香港居住者からの決済を処理することを可能にします。この決済方法により、中国本土のAlipayアカウントを必要とせずに香港の消費者にリーチできます。

主な機能：

• ✅ 香港ユーザー - 香港居住者に直接リーチ
• ✅ 中国アカウント不要 - AlipayHKウォレットのみで利用可能
• ✅ クロスボーダー対応 - 香港の旅行者やオンラインショッパーに対応
• ✅ QRとリダイレクト - デスクトップはQRコード、モバイルはアプリリダイレクト
• ✅ 安全なチェックアウト - 顧客はAlipayHKプラットフォームで承認

有効化が必要

Alipay HK決済を有効にするには、support@omise.coに機能リクエストをお問い合わせください。

対応地域

地域	通貨	最小金額	最大金額	APIバージョン
タイ	THB	฿20.00	฿150,000.00	2017-11-02
シンガポール	SGD	$1.00	$20,000.00	2017-11-02

仕組み

モバイルフロー

デスクトップフロー

デスクトップでは、顧客はリダイレクトされる代わりにAlipayHKアプリでQRコードをスキャンします。

一般的な完了時間： 30秒〜2分

実装方法

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

cURL

curl https://api.omise.co/sources \
  -u $OMISE_PUBLIC_KEY: \
  -d "amount=150000" \
  -d "currency=SGD" \
  -d "type=alipay_hk" \
  -d "platform_type=WEB"

Node.js

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

const source = await omise.sources.create({
    type: 'alipay_hk',
    amount: 150000,
    currency: 'SGD',
    platform_type: 'WEB'  // WEB, iOS, or ANDROID
});

PHP

<?php
$source = OmiseSource::create([
    'type' => 'alipay_hk',
    'amount' => 150000,
    'currency' => 'SGD',
    'platform_type' => 'WEB'
]);
?>

ステップ2：課金の作成

curl https://api.omise.co/charges \
  -u $OMISE_SECRET_KEY: \
  -d "amount=150000" \
  -d "currency=SGD" \
  -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=SGD" \
  -d "return_uri=https://example.com/payment/complete" \
  -d "source[type]=alipay_hk" \
  -d "source[platform_type]=WEB"

ステップ3：顧客のリダイレクト

// Redirect to AlipayHK authorization page
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);
        }
    }

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

課金ステータス値

ステータス	説明
pending	顧客の承認待ち
successful	決済完了
failed	決済失敗または拒否
expired	承認期限切れ

失敗コード

コード	説明
payment_rejected	発行者により決済拒否
failed_processing	一般的な処理エラー
invalid_account	有効なアカウントが見つからない
insufficient_fund	残高不足または限度額到達

返金とボイド

• ボイド期限: 作成後15分（GMT+8）
• 返金: 返金APIで全額返金に対応

ベストプラクティス

1. AlipayHKブランディングを表示 - Alipay CNとは異なるブランディングを使用
2. デバイスを検出 - 適切なplatform_typeを使用
3. モバイル/デスクトップ対応 - デスクトップはQRコード、モバイルはリダイレクト
4. Webhook処理 - 常にWebhookで確認

よくある質問

Alipay HKとは何ですか？

Alipay HK（AlipayHK）は香港居住者向けに設計されたAlipayの香港版です。中国本土のAlipay（Alipay CN）とは別であり、中国の銀行口座や本人確認を必要としません。

Alipay HKとAlipay CNの違いは何ですか？

Alipay HKは香港居住者向けでHKDで運用されます。Alipay CNは中国本土のユーザー向けでCNYで運用されます。これらは別々のウォレットシステムです。両方を受け付けたい場合は、両方の決済方法を連携するか、両方をカバーするAlipay+を使用する必要があります。

Alipay HKは別途有効化が必要ですか？

はい、Alipay HKは有効化が必要です。加盟店アカウントでの有効化をリクエストするには、support@omise.coにお問い合わせください。

モバイルとデスクトップで決済フローはどのように異なりますか？

モバイルデバイスでは、顧客は決済を承認するためにAlipayHKアプリにリダイレクトされます。デスクトップでは、顧客がAlipayHKアプリでスキャンするQRコードが表示されます。最適な体験のためにplatform_typeパラメータを適切に設定してください。

Alipay HK決済を返金できますか？

はい、返金APIで全額返金に対応しています。作成後15分（GMT+8）以内であれば取引をボイドすることも可能です。

Alipay HKはどの通貨に対応していますか？

Omise経由では、Alipay HKはTHB（タイ）とSGD（シンガポール）に対応しています。決済はこれらの通貨で処理され、香港の顧客向けに換算されます。

関連リソース

• Alipay+ 概要 - マルチウォレット連携
• Alipay CN - 中国本土Alipay
• Alipay - 従来のAlipay連携