中国の顧客に人気のデジタルウォレット、アリペイについて学ぶ。 #
アリペイは中国のデジタルウォレットで、世界中に10億人以上のアクティブユーザーを持つ。アリペイのユーザーは、ログイン認証情報またはアリペイアプリを使用して、ウェブまたはモバイルデバイスで支払うことができます。アリペイは紛争率が低く、顧客のログイン認証情報を使用して支払いを認証することにより、詐欺を減らすことができます。
特徴 #
顧客ロケーション | 中国の消費者 華僑 中国人旅行者 |
---|---|
通貨の処理 | CNY、GBP、USD、EUR、HKD |
決済通貨 | GBP、HKD、EUR |
最低取引額 | 0.01元 |
最大取引額 | 制限なし |
払い戻し | ✅ |
一部払い戻し | ✅ |
複数回の一部払い戻し | ❌ |
チャージバック | ❌ |
禁止業種 WooshPayとアリペイ・プラスの両社は、両社のサービスを利用できない禁止事業者リストを管理しています。WooshPayでアリペイ・プラスをご利用いただくには、アリペイ・プラスの利用を制限されたり、アリペイの禁止事業者リストに掲載されたりすることはできません。ご自身の事業が禁止事業者に該当するかどうか不明な場合、またはこれらの要件がどのように適用されるかについてご質問がある場合は、以下までお問い合わせください。 [email protected].
サブプロダクト #
製品 | 支払いシナリオの説明 |
---|---|
ウェブ決済 | デスクトップのブラウザで、アリペイを支払い方法として選択すると、QRコードが表示される。その後、買い物客は携帯電話でアリペイアプリを開き、ブラウザページに表示されたバーコードをスキャンして支払いを完了する。 |
APP決済 | モバイルブラウザ上で、買い物客はマーチャントのチェックアウト時に支払い方法としてアリペイを選択し、ブラウザからアリペイアプリにリダイレクトされて支払いを完了した後、マーチャントのブラウザにリダイレクトされる。 |
支払いの流れ #
ウェブ決済 #
APP決済 #
統合方式 #
支払い方法の列挙値: アリペイ
アリペイには2つの統合方法がある。
- ダイレクトAPI
- チェックアウト
統合方式 | 支払いシナリオ | terminal_type列挙値 |
---|---|---|
ダイレクトAPI | ウェブ決済 | ウェブ |
ダイレクトAPI | APP決済 | APP |
チェックアウト | ウェブ決済 | を特定する必要はない。 ターミナル・タイプ チェックアウト時にチェックアウトの際、利用者の端末に応じて自動的にQRコードが生成されるか、アリペイアプリにリダイレクトされる。 |
チェックアウト | APP決済 | を特定する必要はない。 ターミナル・タイプ チェックアウト時にチェックアウトの際、利用者の端末に応じて自動的にQRコードが生成されるか、アリペイアプリにリダイレクトされる。 |
ダイレクトAPI #
PaymentIntentは、顧客から支払いを収集する意図を表すオブジェクトで、支払いプロセスのライフサイクルを追跡します。サーバー上にPaymentIntentを作成し、収集する金額とサポートする通貨を指定します。
PaymentIntentの作成 #
APIを直接統合する場合、PaymentIntentを作成し、1ステップでURLを取得することができます。以下は、PaymentIntentを作成するデモです:
- ウェブ決済
- APP決済
端末タイプの列挙値を変更することで、Payment Intentで生成される支払いシナリオを制御できます。payemen_method_options.alipay.terminal_type。
ウェブ決済 #
リクエスト
{
"金額":20,
"通貨":「CNY"、
"confirm": true、
"payment_method_options":{
"アリペイ":{
"client_ip":"192.168.0.1",
"terminal_type":"WEB"、
"os_type":"IOS"
}
},
"payment_method_data":{
"type":「アリペイ
},
"payment_method_types":[
「アリペイ
],
"return_url":"https://wooshpay.com"
}
応答
{
"id":"pi_1666729870215872512",
"オブジェクト":"payment_intent"、
"created":1686214342000,
「通貨」:「CNY"、
金額20,
"status":「requires_action": true
「livemode": true、
"client_secret": "pi_1666729870215872512_secret_jmGL6NBNInPx5zdjIJ2utli4",
"next_action":{
"type":"redirect_to_url"、
"alipay_handle_redirect":{
"url":"https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=28166604009zSv0130nTr0bKfhzSwT08YvSW"
}
},
"payment_method_types":[
"アリペイ"
],
"confirmation_method":"自動"、
"payment_method_options":{
"alipay":{
"terminal_type":"WEB"、
"os_type":"IOS"、
"client_ip":"192.168.0.1"
}
},
"return_url":"https://wooshpay.com"、
"payment_method":"pm_1666729870102626304",
"capture_method":"automatic"
}
について url
next_actionからリンクを開くと、アリペイのチェックアウトページにリダイレクトされます。顧客はQRコードをスキャンするか、ウォレットにログインして支払うことができます。
APP決済 #
リクエスト
{
"金額":20,
"通貨":「CNY"、
"confirm": true、
"payment_method_options":{
"アリペイ":{
"client_ip":"192.168.0.1",
"terminal_type":"APP"、
"os_type":"IOS"
}
},
"payment_method_data":{
"type":「アリペイ
},
"payment_method_types":[
「アリペイ
],
"return_url":"https://wooshpay.com"
}
応答
{
"id": "pi_1666732544285999104",
"object": "payment_intent",
"created": 1686214980000,
"currency": "CNY",
"amount": 20,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1666732544285999104_secret_NRUV59FL6qtFyz2bXVeDyLD4",
"next_action": {
"type": "redirect_to_url",
"alipay_handle_redirect": {
"url": "https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2Fplatformapi%2FstartApp%3FappId%3D10000007%26actionType%3Droute%26qrcode%3D281666040092tD6e6GlEzzTlQl6HrEqv3kOI%26externalThrough%3D%257B%2522acTerminalType%2522%253A%2522WAP%2522%257D"
}
},
"payment_method_types": [
"alipay"
],
"confirmation_method": "automatic",
"payment_method_options": {
"alipay": {
"terminal_type": "APP",
"os_type": "IOS",
"client_ip": "192.168.0.1"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666732544155975680",
"capture_method": "automatic"
}
チェックアウト #
アリペイ決済をサポートするには、チェックアウトセッションが以下の条件をすべて満たす必要があります:
- すべての行項目の価格は同じ通貨でなければなりません。異なる通貨で商品を購入する場合は、通貨ごとにチェックアウトセッションを作成してください。
- 使用できるのは1回限りの項目のみです。
支払い方法としてアリペイを有効にする
新しいチェックアウト・セッションを作成する際には、以下のことが必要です:
アリペイプラスをリストに加える payment_method_types(支払い方法タイプ
.すべての 行目
同じ通貨を使う。
セッションの作成 #
を特定する必要はない。 ターミナル・タイプ をクリックしてください。チェックアウトの際、自動的にQRコードが生成されるか、相手のデバイスに応じてアリペイアプリにリダイレクトされます。
リクエスト
{
"cancel_url":"www.baidu.com"、
"mode":「支払い」、
"success_url":"https://wooshpay.com/"、
"payment_method_types":[
「アリペイ
],
"line_items":[
{
"price_data":{
"currency":"CNY"、
"unit_amount":100000,
"active": true、
"product_data":{
"name":"台湾風力"
},
"billing_scheme":"testscheme"、
"lookup_key":"test_lookup_key"
},
「数量":1
}
]
}
応答
{
"id":"cs_1666733999608823808",
"オブジェクト":"checkout.session"、
"created":1686215327000,
「通貨":"CNY"、
"顧客":"",
"mode":「支払い」、
「livemode": true、
「ステータス":「オープン
「url":"https://checkout.wooshpay.com/pay/cs_1666733999608823808?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo="、
"cancel_url":"www.baidu.com"、
「line_items":{
"object":"リスト"、
"data":[
{
"id":"li_1666733999642378240",
"object":"item": "アイテム"、
「通貨":通貨": "CNY
"説明":"台湾風"、
「価格":{
"id":"price_1666733999659155456",
"object":"価格"、
"created":1686215327000,
"active": true、
「通貨":「CNY"、
"product":{
"id":"prod_1666733999675932672",
"object":"product"、
"created":1686215327000,
"active": true、
"name":「taiwan fengli」、
"livemode": true、
「更新": true1686215327000
},
"type":「one_time」、
"livemode": true、
"unit_amount":100000,
「課金方式":"per_unit"、
「lookup_key":"test_lookup_key"
},
"quantity":1,
「amount_subtotal": 100000、
「金額_合計": 100000
}
]
},
"payment_intent":"pi_1666733999864676352",
"payment_method_types":[
「アリペイ
],
"payment_status":「未払い
"success_url":"https://wooshpay.com/"、
"amount_subtotal": 100000、
「金額_合計": 100000、
"billing_address_collection":"自動"、
"expires_at":1686301726587,
"payment_link":"",
"client_secret": "pi_1666733999864676352_secret_5S1FMaseZU6gfIZjl2QlOdY7"
}
について url
next_actionからリンクを開くと、アリペイのチェックアウトページにリダイレクトされます。顧客はQRコードをスキャンするか、ウォレットにログインして支払うことができます。
次のステップ #
必要に応じて、統合にさらに機能を追加することができます。
ウェブフックの作成 #
統合が自動的にリアクションをトリガーできるように、WooshPayアカウントのイベントをリッスンします。enabled_eventsとurlにフォーカスしたWebhookを作成します。
払い戻しの作成 #
顧客に資金を返済するために返金を作成します。部分払い戻しを行うこともできますが、すべての支払い方法が対応しているわけではありません。部分払い戻しとは、元の取引金額の一部のみを払い戻すことです。