Alipay CN

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

概要

Alipay CNは、加盟店が中国にAlipayアカウントを持つ顧客からの決済を受け付けることを可能にします。顧客はAlipayの安全なチェックアウトページにリダイレクトされて決済を承認し、完了後にウェブサイトに戻ります。

主な機能：

• ✅ 10億人以上のユーザー - 中国最大のモバイル決済プラットフォームにアクセス
• ✅ クロスボーダー対応 - 国際加盟店向けに構築
• ✅ 安全なチェックアウト - 顧客はAlipayのプラットフォームで承認
• ✅ 即時確認 - リアルタイムの決済処理
• ✅ モバイル最適化 - デスクトップはQRコード、モバイルはアプリリダイレクト

従来の連携を置き換え

Alipay CNは現在の標準であり、従来の「Alipay（オンライン）」連携を置き換えるものです。

対応地域

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

仕組み

決済フロー：

1. 顧客がチェックアウトでAlipay CNを選択
2. ソースと課金を作成
3. 顧客をauthorize_uriにリダイレクト
4. 顧客がAlipayアプリで承認またはQRコードをスキャン
5. 顧客がサイトに戻る
6. Webhookで決済ステータスを確認

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

実装方法

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

cURL

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

Node.js

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

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

PHP

<?php
$source = OmiseSource::create([
    'type' => 'alipay_cn',
    '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"

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

// Redirect to Alipay 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_expired	取引期限切れ
payment_rejected	発行者により決済拒否
failed_processing	一般的な処理エラー
invalid_account	有効な決済アカウントが見つからない
insufficient_fund	残高不足または限度額到達

返金とボイド

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

ベストプラクティス

1. デバイスを検出 - platform_typeパラメータを適切に使用
2. タイムアウト処理 - 明確な有効期限のカウントダウンを表示
3. Webhook優先 - リダイレクト戻りのみに依存しない
4. 明確なブランディング - チェックアウトにAlipayロゴを表示

よくある質問

Alipay CNとは何ですか？

Alipay CNはAnt Groupが運営するAlipayの中国版です。10億人以上のユーザーを持つ中国最大のモバイル決済プラットフォームです。Alipay CNを使用すると、中国本土のAlipayアカウントを持つ顧客からの決済を受け付けることができます。

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

Alipay CNは中国本土のAlipayユーザー専用です。Alipay+は複数のウォレット（Alipay CN、Alipay HK、GCash、KakaoPayなど）を接続するクロスボーダーネットワークです。中国の顧客を特にターゲットにする場合はAlipay CNを使用し、より広いアジアのウォレット対応が必要な場合はAlipay+を使用してください。

platform_typeパラメータは何のためですか？

platform_typeパラメータ（WEB、iOS、ANDROID）は、顧客のデバイスに合わせて決済フローを最適化します。モバイルではAlipayアプリへのディープリンクを有効にします。Webではスキャン用のQRコードを表示します。

顧客が決済を完了するまでの時間はどのくらいですか？

承認期限は限られています。顧客がタイムアウト期間内に決済を完了しない場合、課金は期限切れになります。リダイレクト戻りに依存するのではなく、成功した決済を検出するために常にWebhook処理を実装してください。

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

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

なぜこの決済方法を有効にする必要があるのですか？

Alipay CNは追加の加盟店確認または契約が必要な場合があります。アカウントでAlipay CNを有効にするには、support@omise.coにお問い合わせください。

関連リソース

• Alipay+ 概要 - マルチウォレット連携
• Alipay HK - 香港Alipay
• Alipay - 従来のAlipay連携