モバイルウェブ決済
商人のアプリケーションがモバイルウェブであり、携帯電話やタブレットなどの端末で決済を完了する必要がある場合、このセクションで提供されるソリューションを参照してPayCloud決済を利用できます。
統合説明
モバイルウェブ決済とは、商人がモバイルウェブで商品やサービスを表示し（通常、Chrome、Safariなどのモバイルブラウザや、モバイルデバイスのシステムデフォルトブラウザ内で開かれ、一部のモバイルアプリ内蔵ブラウザでも表示可能）、ユーザーが商人ページで支払い方法を選択すると、ブラウザが自動的にPayCloudモバイルウェブ決済ページにリダイレクトされ、決済を完了し、再度商人ページにリダイレクトされる決済製品です。
PayCloudモバイルウェブ決済ページは、多数の銀行、決済機関、サードパーティ決済サービスプロバイダーの決済サービスを統合しています。これには、クレジットカードオンライン決済、モバイルウォレットアカウント決済、モバイルウォレットアプリ決済などが含まれます。
ユーザーが支払いを完了すると、商人はPayCloudからの支払い通知を受け取り、商人はまた、注文結果を取得するために注文確認APIを手動で呼び出すこともできます。支払い結果を取得後、注文を同期して更新し、残りの商品やサービスを完了します。
注文時に支払い方法（pay_method_id）が渡されない場合、ユーザーはPayCloud決済ページの支払い方法選択ページにリダイレクトされます。この方法は商人の開発負担を軽減できますが、決済ページを自分で開発してホスティングすることをお勧めします。これにより、ユーザーに一貫した支払い体験を提供でき、当社のドメインがブロックされて決済ページにアクセスできないリスクを低減できます。
WeChatPayやAlipay+を利用する商人は、このAPIを呼び出す前にオンライン決済権限が有効であることを確認してください。また、支払いリクエストはモバイルのデフォルトブラウザまたはサードパーティブラウザから（WeChatやAlipay内蔵ブラウザからではなく）開始する必要があります。そうしないと、ユーザーは正常に支払いを完了できません。これが所謂「H5決済」のシーンです。
使用例
開発ガイド
当社は一連のREST APIを提供しています。以下の表を参照してください。また、いくつかの言語用のSDKも提供していますので、SDKセクションを参照してください。
| API名 | 説明 |
|---|---|
| モバイルウェブ決済注文 | このAPIを通じて支払い注文を提出する |
| 注文のキャンセル | このAPIを通じて未払いの注文を閉じる、すでに支払い済みの場合はユーザーに返金する |
| 返金申請の提出 | このAPIを通じて返金リクエストを提出できますが、返金が即座に完了しない場合は、返金進捗を確認するために返金確認APIを呼び出すことができます。 |
| 支払い注文の確認 | このAPIを使用して正規取引注文の取引結果（消費/事前承認/事前承認完了）を確認する |
| 返金注文の確認 | このAPIを使用して返金取引注文（消費キャンセル/事前承認キャンセル/消費返金/事前承認完了返金）の取引結果を確認する |
| 取引結果通知 | 取引完了後に商人に通知し、取引結果を知らせる |
注意事項
Alipay決済の注意事項
pay_method_idにはAlipay+のみを指定し、Alipayを指定することはできません。Alipayのみを表示し、他のA+ウォレット（Gcash、TNG、AlipayHKなど）を必要としない場合は、sub_pay_method_id= Alipayを設定できます。
WeChat H5決済の注意事項
-
WeChat H5決済はデフォルトでは有効になっていません。必要な場合は、事前に当社の担当者にお知らせください。H5決済を申請するには、WeChatからの追加の認証資料が必要です。Newageの指示に従って申請資料を提出してください。
-
WeChatは支払い開始ドメインを検証します。つまり、WeChatにリダイレクトされる前のウェブページのドメインです。このドメインはWeChatのバックエンドで設定する必要があります。設定画面は以下の通りですので、申請したいドメインをNewageに提出してください。
pay_method_idとwechatpay_product_typeパラメータの値を設定しないと、WeChatはNewageのドメインを取得し、H5決済は失敗します。
-
pay_method_idはWeChatPayに設定し、wechatpay_product_typeパラメータはH5に設定してください。 -
上記のパラメータと設定を渡した後、当社のAPIを呼び出し、返されたパラメータ
pay_urlにリダイレクトしてください。このページは自動的にH5決済を開始します。 -
以下のエラーが表示される場合は、上記の手順に従って設定されているか確認してください。
