アリペイプラスペイメント #
アリペイプラスは中国発のデジタルウォレットで、東南アジアと中国の顧客にサービスを提供している。アリペイ・プラスのユーザーは、ログイン情報またはアリペイ・プラスがサポートする特定のアプリを使用して、ウェブまたはモバイルデバイスで支払うことができる。
特徴 #
顧客ロケーション
- 中国の消費者
- 華僑
- 中国人旅行者
- 東南アジアの消費者
プレゼント通貨
CNY、HKD、GBP、IDR、MYR、PHP、THB
財布リスト
- アリペイHK
- DANA
- TNG
- ビーピーアイ
- うさぎLINE Pay
- GCash
- ブースト
- アクラク・ペイレイター
禁止業種
WooshPayとAlipay Plusの両方が、サービスの利用を許可されていない禁止事業者のリストを管理しています。WooshPayでAlipay Plusを利用するには、Stripeの利用を制限されたり、Alipayの禁止事業者リストに掲載されたりすることはできません。貴社の事業が禁止事業者に該当するかどうか不明な場合、またはこれらの要件が貴社にどのように適用されるかについてご質問がある場合は、[email protected]。
サーバー間の統合 #
アリペイ・プラスを使えば、顧客はあなたのウェブサイトやアプリからリダイレクトして支払い、別のウォレットで支払いを承認し、あなたのウェブサイトやアプリに戻ると、支払いが成功したか失敗したかの通知をすぐに受け取ることができる。
概要 #
APIとの直接統合の場合、支払いインテントを作成し、urlを取得する1つのステップで済みます:
- ペイメントインテントを作成する
- 払い戻し
- ウェブフック
1.PaymentIntentを作成する。 #
PaymentIntentは、顧客から支払いを収集する意図を表すオブジェクトで、支払いプロセスのライフサイクルを追跡します。サーバー上にPaymentIntentを作成し、収集する金額とサポートする通貨を指定します。すでにPaymentIntentを統合している場合は、支払い方法の種類のリストにalipayplusを追加します。
リクエスト PaymentIntentの作成
{
"金額": 200、
"currency": "IDR", //通貨が異なるとウォレットが異なる場合があります。
"confirm":true、
"payment_method_options":{」を選択します。
"alipayplus":{
"terminal_type": "WEB"
}
},
Payment_method_data":{ "タイプ": "alipayplus".
"type": "alipayplus"
},
"return_url": "https://wooshpay.com"
}
応答
{
"id":"pi_1646355176136638464",
"オブジェクト":"payment_intent"、
"created":1681356636000,
「通貨」:"IDR"、
「金額":200,
"status":「requires_action": true
「livemode": true、
"client_secret": "pi_1646355176136638464_secret_gxkV1LYb76c2nFvtzDmHevyw",
"next_action":{
"alipayplus_handle_redirect":{
"normalUrl":"https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040092tDht8YNMR2t2u648Mu5v476I"
}
},
"payment_method_types":[
「アリペイ
"wechat_pay"、
"カード"、
"アリペイプラス"
],
"confirmation_method":"自動"、
"payment_method_options":{
"alipayplus":{
"terminal_type":"WEB"
}
},
"return_url":"https://wooshpay.com"、
"payment_method":"pm_1646355176006615040",
"capture_method":"automatic"
}
からのnormalUrl。 次のアクション
リンクから開くことができ、顧客は通貨に応じて異なるウォレットを表示され、顧客は支払いたいウォレットを選択し、QRコードをスキャンするか、ウォレットにログインすることができる。
2.払い戻し #
APIまたはダッシュボードを使用して、成功した支払いの一部または全額を払い戻すことができます。すべての払い戻しのリストを表示するには、ダッシュボードの払い戻された支払いページに移動します。
APIを使用して支払いを払い戻すには、PaymentIntentを指定して払い戻しを作成します。
リクエスト 払い戻しを行う
{
"reason": "requested_by_customer"、
"payment_intent":"pi_1575055712604651520"
}
応答
{
"id":"re_1575092157281206272",
"object": "refund"、
"created":1664366209000,
「金額": 20、
「通貨": "CNY"、
"metadata": "null"、
"reason": "requested_by_customer"、
"status": "成功しました、
description": "null"、
"payment_intent":"pi_1575055712604651520",
「失敗理由": null
}
3.ウェブフック #
WooshPayアカウントのイベントをリッスンして、統合が自動的にリアクションをトリガーできるようにします。主に次のようなWebhookを作成します。 有効なイベント
そして url
.
ウェブフックを受信する手順
- 監視したいイベントと、解析するイベント・ペイロードを特定する。
- ローカルサーバー上にHTTPエンドポイント(URL)としてWebhookエンドポイントを作成します。
- Webhookエンドポイントが正しく動作しているかテストし、コールバックを受け取ったか確認してください。
リクエスト
{
"url": "https://apitest.wooshpay.com/v1/receives"、
"description": "I_am_description"、
"enabled_events":[
"payment_intent.created"、
"payment_intent.payment_failed"、
"payment_intent.succeeded"、
"charge.refund.updated"
],
"api_version":"1.0.1"
}
応答
{
"id":"we_1575093135514533888",
"object": "webhook_endpoint"、
"created":1664366442000,
"description": "I_am_description"、
"metadata":null、
"status": "enabled"、
「url": "https://apitest.wooshpay.com/v1/receives"、
「livemode":false、
"api_version":"1.0.1",
"enabled_events":[
"payment_intent.created"、
"payment_intent.payment_failed"、
"payment_intent.succeeded"、
"charge.refund.updated"
]
}
チェックアウト #
アリペイプラス決済をサポートするには、チェックアウトセッションが以下の条件をすべて満たす必要があります:
- すべての項目の価格は同じ通貨でなければなりません。
異なる通貨で商品を購入する場合は、通貨ごとにチェックアウトセッションを作成してください。 - 使用できるのは1回限りの項目のみです。
アリペイプラスを支払い方法として有効にする #
新しいチェックアウト・セッションを作成する際には、以下のことが必要です:
アリペイプラスをリストに加える payment_method_types(支払い方法タイプ
.
すべての 行目
同じ通貨を使う。
リクエスト セッションの作成
{
"cancel_url":"www.baide.com"、
"mode":「支払い」、
"success_url":"www.wooshpay.com"、
"payment_method_options":{ //支払い方法としてalipayplusを追加する
"alipayplus":{
"terminal_type":"WEB"
}
},
"line_items":[
{
"price_data":{
"currency":"GBP"、
"product": null、
"unit_amount":5,
"active": true、
「メタデータ":{
"key1":"value1"、
"key2":"value2"
},
"ニックネーム":"fengli"、
"product_data":{
"id": null、
"name": null:"taiwan fengli"、
"active": true、
"description": "とても美味しい":「とてもおいしい」、
"メタデータ":{
"key1":"value1": "値1"、
"key2":"value2"
},
"url":"www.baidu.com"
},
"billing_scheme":"testscheme"、
「lookup_key":"test_lookup_key"
},
「数量":1
}
]
}
応答
{
"id":"cs_1597163428114333696",
"オブジェクト":"checkout.session"、
"created":1669628410000,
「通貨":「GBP"、
"customer":"",
"mode":「支払い」、
「livemode": true、
「shipping": null、
「ステータス":「オープン
「url":"https://checkout.wooshpay.com/pay/cs_1597163428114333696?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo="、
"cancel_url":"www.baidu.com"、
「client_reference_id": null、
「customer_email": null、
"line_items":{
"object":"リスト"、
"data":[
{
"id":"li_1597163428139499520",
"object":"item": "アイテム"、
"currency":「GBP"、
"説明":"台湾風"、
「価格":{
"id":"price_1597163428152082432",
"object":"価格"、
"created":1669628410000,
"active": true、
通貨": "GBP「GBP"、
"metadata":{
"key1":"value1"、
"key2":"value2"
},
"ニックネーム":"fengli"、
"product":{
"id":"prod_1597163428164665344",
"オブジェクト":"product"、
"created":1669628410000,
"active": true、
"説明": "とても美味しい":「とてもおいしい」、
"metadata":{
"key1":"value1": "値1"、
"key2":"value2"
},
"name":「taiwan fengli」、
"livemode": true、
"url":"www.baidu.com"、
"updated":1669628410000,
「画像": null
},
"type":「one_time": true、
"livemode": true、
"unit_amount":5,
「課金方式":"per_unit"、
「lookup_key":"test_lookup_key"
},
"quantity":1,
「amount_subtotal": 5、
「金額_合計": 5
}
],
"url": null、
"has_more": null
},
"payment_intent":"pi_1597163428336631808",
"payment_method_types": null、
"payment_status": "未払い":「未払い」、
"success_url":"www.wooshpay.com"、
"amount_subtotal": 5、
「金額_合計": 5、
"billing_address_collection":"自動"、
"expires_at":1669714809783,
"payment_link":"",
"payment_method_options": null、
「phone_number_collection":null、
"shipping_address_collection": null、
"client_secret": "pi_1597163428336631808_secret_pxwFDDYAbSnC99NpAKVwE1Sr"
}
顧客は、QRコードをスキャンするか、ウォレットにログインして、支払いたいウォレットを選択することができます。