WeChatペイ

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コード #

pic_QR Code.png

モバイルH5フロー #

pic_Mobile H5 Flows.png

モバイル - WeChatアプリ内 #

pic_Mobile - In WeChat app.png

統合方式 #

支払い方法の列挙値: ウィーチャットペイ

Wechatペイには2つの統合方法がある。

  1. ダイレクトAPI
  2. チェックアウト
統合方式Wechat Payサブプロダクションterminal_type列挙値
ダイレクトAPIウェブ決済ウェブ
ダイレクトAPIクイックペイSCAN_CODE
ダイレクトAPIH5支払いWAP
ダイレクトAPI公式アカウント支払い公式アカウント
ダイレクトAPIミニ・プログラムミニ・プログラム
統合方式Wechat Payサブプロダクションterminal_type列挙値
チェックアウトウェブ決済チェックアウト時に端末の種類を特定する必要はありません。チェックアウトの際、端末の種類を特定する必要はありません。チェックアウトの際、端末の種類に応じて自動的にQRコードが生成されるか、WeChatアプリにリダイレクトされます。
チェックアウトH5支払いチェックアウト時に端末の種類を特定する必要はありません。チェックアウトの際、端末の種類を特定する必要はありません。チェックアウトの際、端末の種類に応じて自動的にQRコードが生成されるか、WeChatアプリにリダイレクトされます。

ダイレクトAPI #

PaymentIntentは、顧客から支払いを収集する意図を表すオブジェクトで、支払いプロセスのライフサイクルを追跡します。サーバー上にPaymentIntentを作成し、収集する金額とサポートする通貨を指定します。

PaymentIntentの作成 #

APIを直接統合する場合、PaymentIntentを作成し、1ステップでURLを取得することができます。以下は、PaymentIntentを作成するデモです:

  1. ウェブ決済
  2. H5支払い
  3. クイックペイ
  4. 公式アカウント支払い

ウェブ決済 #

リクエスト

{
    "金額": 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を作成します。

払い戻しの作成 #

顧客に資金を返済するために返金を作成します。部分払い戻しを行うこともできますが、すべての支払い方法が対応しているわけではありません。部分払い戻しとは、元の取引金額の一部のみを払い戻すことです。

どのようなお気持ちですか?
2023年8月9日更新