中国のお客様に人気のデジタルウォレット、WeChat Payについてご紹介します。 #
WeChat Payは、WeChatとして知られる中国の人気スーパーアプリに統合されたデジタルウォレットとして機能している。長年にわたり、国内外を問わず中国の消費者とのつながりを求める企業にとって不可欠な決済ソリューションとして、大きな注目を集めてきた。WeChatは包括的なエコシステムへと変貌を遂げ、中国の買い物客にチャット、商品やサービスの閲覧、決済を統一プラットフォーム内でシームレスに行える利便性を提供している。この統合により、ショッピング体験は、まるで仲間と友好的な会話をするように、すべて一箇所で簡単に行えるようになった。
特徴 #
顧客ロケーション | 中国の消費者 華僑 中国人旅行者 |
---|---|
通貨の処理 | CNY、GBP、USD、EUR、HKD |
決済通貨 | 英ポンド、ユーロ、米ドル、香港ドル |
最低取引額 | 制限なし |
最大取引額 | 50,000 米ドル |
払い戻し | ✅ |
一部払い戻し | ✅ |
複数回の一部払い戻し | ✅ |
チャージバック | ❌ |
サブプロダクト #
支払いケース | 製品 | 支払いシナリオの説明 |
---|---|---|
QRコード | ウェブ決済 | デスクトップのブラウザで、WeChatPayを支払い方法として選択すると、QRコードが表示される。その後、買い物客は携帯電話でWeChatアプリを開き、ブラウザページに表示されたバーコードをスキャンして支払いを完了する。 |
QRコード | クイックペイ | 販売時点では、加盟店は端末にQRコードを表示することができ、買い物客は携帯電話のWeChatアプリを開いてQRコードをスキャンし、支払いを完了することができる。 |
モバイルH5フロー | H5支払い | モバイルブラウザ上で、買い物客はWeChatPayを支払い方法として選択し、ブラウザからWeChatPayアプリにリダイレクトされ、支払いを完了した後、マーチャントのブラウザにリダイレクトされる。 |
モバイル - WeChatアプリ内 | 公式アカウント | 通常、より中国語圏の市場で人気があり、マーチャントはWeChatソーシャルサイト上にプロフィールページを構築し、買い物客にWeChatソーシャルサイト環境内で商品を選択し、支払いを完了するよう促すことを検討することができる。 |
モバイル - WeChatアプリ内 | ミニ・プログラム | ミニプログラムは、WeChatソーシャルサイト内のウェブサイトのようなもので、マーチャントによるカスタマイズが可能で、買い物客はその中で商品を選び、支払いを済ませることができる。 |
支払いの流れ #
QRコード #
モバイルH5フロー #
モバイル - WeChatアプリ内 #
統合方式 #
支払い方法の列挙値: ウィーチャットペイ
Wechatペイには2つの統合方法がある。
- ダイレクトAPI
- チェックアウト
統合方式 | Wechat Payサブプロダクション | terminal_type列挙値 |
---|---|---|
ダイレクトAPI | ウェブ決済 | ウェブ |
ダイレクトAPI | クイックペイ | SCAN_CODE |
ダイレクトAPI | H5支払い | WAP |
ダイレクトAPI | 公式アカウント支払い | 公式アカウント |
ダイレクトAPI | ミニ・プログラム | ミニ・プログラム |
統合方式 | Wechat Payサブプロダクション | terminal_type列挙値 |
---|---|---|
チェックアウト | ウェブ決済 | チェックアウト時に端末の種類を特定する必要はありません。チェックアウトの際、端末の種類を特定する必要はありません。チェックアウトの際、端末の種類に応じて自動的にQRコードが生成されるか、WeChatアプリにリダイレクトされます。 |
チェックアウト | H5支払い | チェックアウト時に端末の種類を特定する必要はありません。チェックアウトの際、端末の種類を特定する必要はありません。チェックアウトの際、端末の種類に応じて自動的にQRコードが生成されるか、WeChatアプリにリダイレクトされます。 |
ダイレクトAPI #
PaymentIntentは、顧客から支払いを収集する意図を表すオブジェクトで、支払いプロセスのライフサイクルを追跡します。サーバー上にPaymentIntentを作成し、収集する金額とサポートする通貨を指定します。
PaymentIntentの作成 #
APIを直接統合する場合、PaymentIntentを作成し、1ステップでURLを取得することができます。以下は、PaymentIntentを作成するデモです:
- ウェブ決済
- H5支払い
- クイックペイ
- 公式アカウント支払い
ウェブ決済 #
リクエスト
{
"金額": 20、
"通貨": "CNY"、
"confirm":true、
"payment_method_options":{」とあります。
"wechat_pay":{」となります。
"terminal_type": "WEB"、
「os_type": "IOS"、
"client_ip":"192.168.0.1"
}
},
"payment_method_data":{」を参照してください。
"タイプ": "wechat_pay"
},
"return_url": "https://wooshpay.com"
}
応答
{
"id":"pi_1666625039547498496",
"オブジェクト":"payment_intent"、
"created":1686189348000,
"livemode": false、
「通貨」:「CNY"、
「金額":20,
「ステータス":requires_action": "requires_action"、
"client_secret": "pi_1666625039547498496_secret_qGj2VEg4khXSWkXvRI7Y3yZe",
"next_action":{
"type":wechat_pay_display_qr_code": "wechat_pay_display_qr_code"、
"wechat_pay_display_qr_code":{
"image_data_url":"weixin://wxpay/bizpayurl?pr=lJhTByDzz": "weixin://wxpay/bizpayurl?pr=lJhTByDzz"
}
},
"payment_method_types":[
「wechat_pay"、
],
"confirmation_method":「自動"、
"payment_method_options":{
"wechat_pay":{
"terminal_type":"WEB"、
"os_type":"IOS"、
"client_ip":"192.168.0.1"
}
},
"return_url":"https://wooshpay.com"、
"payment_method":"pm_1666625039430057984",
"capture_method":"automatic"
}
について 画像_データ_url
より wechat_pay_display_qr_コード
より 次のアクション
リンクを開くと、加盟店は対応するQRコードを生成できる。そして、対応するQRコードを使ってチャージする。
H5支払い #
リクエスト
{
"金額":20,
"通貨":「CNY"、
"confirm": true、
"payment_method_options":{
"wechat_pay":{
"terminal_type": "WAP":"WAP"、
"client_ip":"192.168.124.133" /顧客の携帯ip
}
},
"payment_method_data":{
"type":"wechat_pay"
},
"return_url":"あなたのウェブサイト"
}
応答
{
"id": "pi_1666625208749916160",
"object": "payment_intent",
"created": 1686189389000,
"livemode": false,
"currency": "CNY",
"amount": 20,
"status": "requires_action",
"client_secret": "pi_1666625208749916160_secret_BeEXcbvAQNUkrV9C6ZFjOamS",
"next_action": {
"type": "wechat_pay_redirect_to_web",
"wechat_pay_redirect_to_web": {
"url": "https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx08095629694611f41b32df91d6ea160000&package=3449031350&redirect_url=https%3A%2F%2Fwooshpay.com"
}
},
"payment_method_types": [
"wechat_pay"
],
"confirmation_method": "automatic",
"payment_method_options": {
"wechat_pay": {
"terminal_type": "WAP",
"os_type": "IOS",
"client_ip": "172.31.5.62"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666625208624087040",
"capture_method": "automatic"
}
について url
より wechat_pay_redirect_to_web
より 次のアクション
リンクから開くことができ、顧客は支払のためのwechat APPに直接であり、に直接である。 return_url
支払い後
クイックペイ #
リクエスト
{
"金額": 10、
"通貨": "CNY"、
"confirm":true、
"payment_method_options":{」とあります。
"wechat_pay":{
"terminal_type": "SCAN_CODE"、
"os_type": "IOS"、
"client_ip":"192.168.0.1"
}
},
"payment_method_data":{」とある。
"type": "wechat_pay"、
"wechat_pay":{
"payment_code":"132993614656096754"
},
"return_url": "https://yourweb.com"
}
応答
{
"id":"pi_1666627489012645888",
"オブジェクト":"payment_intent"、
"created":1686189932000,
"livemode": false、
「通貨」:「CNY"、
「金額":10,
「ステータス":requires_action": "requires_action"、
"client_secret": "pi_1666627489012645888_secret_t6oeKYYGb9egt3koNMsntfSg",
"payment_method_types":[
"wechat_pay"
],
"confirmation_method":"自動"、
"payment_method_options":{
"wechat_pay":{
"terminal_type":"SCAN_CODE": "SCAN_CODE"、
"os_type":"IOS"、
"client_ip":"192.168.0.1"
}
},
"return_url":"https://yourweb.com"、
"payment_method":"pm_1666627488878428160",
"capture_method":"automatic"
}
パスワード不要の支払いは直接支払うことができ、そうでない場合は携帯電話でパスワードや指紋などを入力して支払う必要がある。
公式アカウント支払い #
リクエスト
{
"金額":20,
"通貨":「CNY"、
"confirm": true、
"payment_method_options":{
"wechat_pay":{
"terminal_type":「公式アカウント
"client_ip":"192.168.0.1",
"openid":""
}
},
"payment_method_data":{
"type":"wechat_pay"
}
}
応答
{
"id":"pi_1666626536515567616",
"オブジェクト":"payment_intent"、
"created":1686189705000,
"livemode": false、
「通貨」:「CNY"、
「金額":20,
「ステータス":requires_payment_method": "requires_payment_method"、
"client_secret": "pi_1666626536515567616_secret_CcrukFKgxbPp7UEAxodLlNRD",
"last_payment_error":{
"code":「payment_method_provider_decline」、
"message":"サービスエラーです。もう一度お試しください、
"payment_method":{
"id":"pm_1666626536389738496",
"object":"payment_method"、
"created":1686189705000,
"livemode": false、
"type":「wechat_pay"、
"billing_details":
},
"decline_code":"invalid_request_error": "無効なリクエストエラー"
},
"payment_method_types":[
"wechat_pay"
],
"confirmation_method":"自動"、
"payment_method_options":{
"wechat_pay":{
"openid":"",
"terminal_type":"official_account": "公式アカウント"、
"client_ip":"192.168.0.1"
}
},
"payment_method":"pm_1666626536389738496",
"capture_method":"自動"
}
wechat_pay_official_account_params
より 次のアクション
には、フロントエンドで使用する必要のあるパラメータがいくつか含まれています。以下はパラメータの使用例です。 js 例
function onBridgeReady(){
WeixinJSBridge.invoke(
'getBrandWCPayRequest', {
"appId":"wx7a154c094f74e84f",
"timeStamp":"1682239457",
"nonceStr":"kLRl3fI6FiP8PXxNNAiytwuQBdoCWXvZ",
"package":"prepay_id=wx23164417189051acf8825c57d275230000",
"signType":"MD5",
"paySign":"703868ed93842f83c9dff4d80d0cad67"
},
function(res){
if(res.err_msg == "get_brand_wcpay_request:ok" ) {} // Using the above method to judge the front-end return, the WeChat team solemnly reminds: res.err_msg will return ok after the user's payment is successful, but it does not guarantee that it is absolutely reliable.
}
);
}
if (typeof WeixinJSBridge == "undefined"){
if( document.addEventListener ){
document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false);
}else if (document.attachEvent){
document.attachEvent('WeixinJSBridgeReady', onBridgeReady);
document.attachEvent('onWeixinJSBridgeReady', onBridgeReady);
}
}else{
onBridgeReady();
}
ミニ・プログラム #
リクエスト
{
"金額":20,
"通貨":「GBP"、
"confirm": true、
"payment_method_options":{
"wechat_pay":{
"terminal_type":「ミニプログラム
"client_ip":"192.168.0.1",
"openid":"ojt******QnCY"
}
},
"payment_method_data":{
"type":"wechat_pay"
}
}
応答
{
"id":"pi_1684807723566235648",
"オブジェクト":"payment_intent"、
"created":1690524438000,
"livemode": true、
「通貨":「GBP"、
「金額":20,
"status":requires_action": "requires_action"、
"client_secret": "pi_1684807723566235648_secret_V3rhLjnidzwNnc7UomZJzzxc",
"next_action":{
"type":wechat_pay_mini_program_params": "wechat_pay_mini_program_params"、
"wechat_pay_mini_program_params":{
"appId":"***********",
"timeStamp":"1690524439",
"nonceStr":"VVdQaFzG9LjOSNyGNLFbt7NZAn2oE87z"、
"signType":"MD5"、
"paySign":"9d0a90a35935d71d7a0f5f33689030fe",
"package":"prepay_id=wx281407195596079e2b5253415099630000"
}
},
"payment_method_types":[
「wechat_pay"、
],
"confirmation_method":「自動"、
"payment_method_options":{
"wechat_pay":{
"openid":"**********",
"terminal_type":"mini_program": "ミニプログラム"、
"client_ip":"192.168.0.1"
}
},
"payment_method":"pm_1684807723448795136",
"capture_method":"自動"
}
チェックアウト #
また、WooshPayがホストするチェックアウトでWeChat Payを利用することもできます。支払いをサポートするには、チェックアウトセッションが以下の条件をすべて満たす必要があります:
- すべての行項目の価格は同じ通貨でなければなりません。異なる通貨で商品を購入する場合は、通貨ごとにチェックアウトセッションを作成してください。
- 使用できるのは1回限りの項目のみです。
支払い方法としてwechat payを有効にする
新しいチェックアウト・セッションを作成する際には、以下のことが必要です:
のリストにWechat Payを追加する。 payment_method_types(支払い方法タイプ
.すべての 行目
同じ通貨を使う。
セッションの作成 #
リクエスト
{
"cancel_url":"https://wooshpay.com"、
"mode":「支払い」、
"success_url":"https://wooshpay.com"、
"payment_method_types":[
"wechat_pay"
],
"line_items":[
{
"price_data":{
"currency":"CNY"、
"unit_amount":100,
"product_data":{
"name":"fengli"、
"url":"www.baidu.com"
}
},
数量1
}
]
}
応答
{
"id":"cs_1666627733867724800",
"オブジェクト":"checkout.session"、
"created":1686189991000,
"livemode": false、
「通貨":「CNY"、
「顧客":"",
「mode":「支払い
「ステータス":「オープン
"url":"https://checkouttest.wooshpay.com/pay/cs_test_1666627733867724800?key=pk_test_NTE1OTU5NzQ3NTQ2MTM5ODkzNzcxOktFZ0xlam1KbUxUb2gyUUNqWVVoaGpDSjE2NjkzNDUwMDgxMTE="、
"cancel_url":"https://wooshpay.com"、
「line_items":{
"object":"リスト"、
"data":[
{
"id":"li_1666627733993553920",
"object":"item": "アイテム"、
「通貨":通貨": "CNY
"説明":"fengli"、
「価格":{
"id":"price_1666627734022914048",
"object":"price": "価格"、
"created":1686189991000,
"livemode": false、
「active": true、
「通貨":「CNY"、
「商品":{
"id":"prod_1666627734064857088",
"object":"product"、
"created":1686189991000,
"livemode": false、
「active": true、
"name":"fengli"、
「url":"www.baidu.com"、
"更新":1686189991000
},
"type":「one_time」、
"unit_amount":100,
「課金方式":"単位あたり"
},
"quantity":1,
"amount_subtotal": 100、
「金額_合計": 100
}
]
},
"payment_intent":"pi_1666627734450733056",
"payment_method_types":[
"wechat_pay"
],
"payment_status":「未払い
"success_url":"https://wooshpay.com"、
"amount_subtotal": 100、
「金額_合計": 100、
"billing_address_collection":"自動"、
"expires_at":1686276390865,
"payment_link":"",
"client_secret": "pi_1666627734450733056_secret_jajX5Fe4Qlp6VGEm0ftP1wcZ"
}
URLからチェックアウトカウンターにアクセスし、WeChat決済を選択します。クライアントがウェブページの場合、QRコードが生成され、そのコードをスキャンして決済することができます。クライアントがモバイル端末の場合は、直接WeChat APPにジャンプして決済を行います。
次のステップ #
必要に応じて、統合にさらに機能を追加することができます。
ウェブフックの作成 #
統合が自動的にリアクションをトリガーできるように、WooshPayアカウントのイベントをリッスンします。enabled_eventsとurlにフォーカスしたWebhookを作成します。
払い戻しの作成 #
顧客に資金を返済するために返金を作成します。部分払い戻しを行うこともできますが、すべての支払い方法が対応しているわけではありません。部分払い戻しとは、元の取引金額の一部のみを払い戻すことです。