メインコンテンツまでスキップ

ミニプログラム決済

商店がすでにWeChatまたはAlipayのミニプログラムを持っている場合、ユーザーは友達からのシェアやQRコードをスキャンして、WeChatまたはAlipay内でミニプログラムを開くと、決済の流れを呼び出して購入を完了できます。

統合説明​

商店はまずミニプログラムを所有している必要があり、WeChatやAlipayの規定に従ってミニプログラムを開発する必要があります。商店はWeChatやAlipayでミニプログラム決済機能を開通する必要はなく、PayCloudのAPIに接続し、決済パラメーターを取得して、ミニプログラム決済コントロールを呼び出すだけで決済が完了します。

ユーザーが決済を完了すると、商店はPayCloudから決済通知を受け取ることができます。また、商店は注文結果を確認するために注文照会APIを呼び出すこともできます。決済結果を取得した後、PayCloudは商店に注文情報を同期し、商品やサービスの残りの処理を完了します。

注意事項

このAPIを呼び出す前に、オンライン決済権限を開通していることを確認してください。 WeChatミニプログラム内でAlipayなど他の決済方法を表示しないでください。そうしないと、ユーザーが決済できなくなる場合があります。

ユーザーの決済フロー​

ステップ1：ユーザーはシェアまたはQRコードをスキャンして商店のミニプログラムに入り、購入を選択し、選択プロセスを完了します。

ステップ2：WeChatまたはAlipay決済コントロールを呼び出し、ユーザーは決済パスワードを入力します。

ステップ3：パスワード認証が完了し、決済成功。商店のバックエンドが決済成功の通知を受け取ります。

ステップ4：商店のミニプログラムに戻り、購入成功を表示します。

WeChatミニプログラム決済のイメージ図：

WeChatミニプログラム決済のイメージ図

開発ガイド​

API一覧​

以下のREST APIを提供します。これらのAPIにはいくつかの言語のSDKが提供されています。詳細はSDK章を参照してください。

API名 説明
ミニプログラム決済注文このAPIを使用して決済注文を提出します。
注文キャンセルこのAPIを使用して未決済の注文をキャンセルします。決済済みの場合は、ユーザーに返金します。
返金申請の提出このAPIで返金リクエストを提出した場合、返金が即時に処理されない場合は、返金の進行状況を確認するために返金照会APIを使用できます。
決済注文の照会このAPIで正規取引注文の取引結果を照会できます（消費/事前承認/事前承認完了）。
返金注文の照会このAPIで返金取引注文（消費キャンセル/事前承認キャンセル/消費返金/事前承認完了返金）の取引結果を照会できます。
取引結果通知取引完了後に商店に通知を送り、取引結果を知らせます。

WeChatミニプログラム決済の呼び出し​

商店が提出した資料に基づき、WeChatに商店情報を報告し、決済機能を開通します。WeChat決済商店番号とミニプログラムAppIDを紐付ける必要がありますので、Newageサポート担当者にミニプログラムAppIDをお知らせください。

WeChat決済AppID設定

WeChat決済公式は、ミニプログラム決済コントロールの呼び出し方法とサンプルコードを提供しています。詳細は開発ガイドおよびミニプログラム決済の呼び出しを参照してください。

WeChatの公式文書に記載されている【統一注文】APIは、PayCloudが提供する【ミニプログラム決済注文】APIを使用してください。PayCloudは、WeChat決済の日本地区公式サービスプロバイダとして、WeChat決済機能を統合しており、WeChat決済の複雑なプロセスを非表示にしています。必要なのは、APIを通じて注文パラメーターを取得し、WeChat決済を呼び出すことだけです。

PayCloudのミニプログラム決済インターフェースが返すパラメーターpay_paramsは、次のようなJSONオブジェクトです：

{
    "timeStamp":"1414561699",
    "nonceStr":"5K8264ILTKch16CQ2502SI8ZNMTM67VS",
    "package":"prepay_id=123456789",
    "signType":"MD5",
    "paySign":"C380BEC2BFD727A4B6845133519F3AD6"
}

アリペイクライアントによる決済の呼び出し​

アリペイクライアントでのミニプログラム決済の呼び出しは比較的簡単で、当社の注文APIをリクエストして、返された決済パラメーターを取得します。返された決済パラメーターはhttpsリンクアドレスで、指定されたリンクに遷移するだけです。

PayCloudのミニプログラム決済インターフェースから返されるパラメーターpay_paramsは、次のようなJSONオブジェクトです：

{
    "paymentUrl":"https://pay.alipay.com/minipay/129010778.html?tradeno=20210926001099101518"
}

paymentUrlはアリペイの決済ページのURLです。このURLを自分のミニプログラム内で表示するだけで、決済ページを表示できます。