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

APP決済

これは商人がモバイルアプリに第三者のモバイル決済ウォレット（例：WeChat、Alipay、UnionPayなど）を統合するための決済機能です。

統合説明​

商人のアプリは、第三者のモバイル決済ウォレットが提供するSDKを呼び出してその決済モジュールを利用します。商人アプリは、第三者のモバイル決済ウォレットアプリに遷移して決済を完了し、決済後は商人アプリに戻り、最終的に決済結果が表示されます。

現在サポートされているモバイルシステムは、iOS（Apple）とAndroid（アンドロイド）です。

PayCloudは、現在WeChat PayとAlipay+（中国本土のAlipayのみならず、AlipayHK、Gcash、KakaoPay、TNGなど）を統合したAPP決済機能をサポートしています。

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

注意事項

このAPIを呼び出す前にオンライン決済権限が有効であることを確認してください。

インタラクションの詳細​

ステップ1：ユーザーは商人のアプリにアクセスし、商品を選択して注文を確認し、決済プロセスに進みます。商人のサービスバックエンドは、当社のAPP決済APIを呼び出して決済注文を生成し、データをアプリに送信します。

ステップ2：ユーザーは決済操作を開始し、第三者のモバイル決済ウォレットアプリに遷移し、支払いを実行します。支払い確認画面が表示されます。

ステップ3：ユーザーは受取人と金額を確認し、支払いボタンをクリックすると、パスワード入力画面が表示され、残高や銀行カードで支払いを選択できます。

ステップ4：正しいパスワードを入力後、支払いが完了し、ユーザーのアプリには決済詳細ページが表示されます。

ステップ5：商人のアプリに戻り、商人のアプリは決済結果を基に注文処理結果を個別に表示します。

App決済使用例イメージ

開発ガイド​

API一覧​

当社は一連のREST APIを提供しています。以下の表を参照してください。また、いくつかの言語用のSDKも提供していますので、SDKセクションを参照してください。

API名 説明
APP決済注文このAPIを通じて支払い注文を提出する
注文のキャンセルこのAPIを通じて未払いの注文を閉じる、すでに支払い済みの場合はユーザーに返金する
返金申請の提出このAPIを通じて返金リクエストを提出できますが、返金が即座に完了しない場合は、返金進捗を確認するために返金確認APIを呼び出すことができます。
支払い注文の確認このAPIを使用して正規取引注文の取引結果（消費/事前承認/事前承認完了）を確認する
返金注文の確認このAPIを使用して返金取引注文（消費キャンセル/事前承認キャンセル/消費返金/事前承認完了返金）の取引結果を確認する
取引結果通知取引完了後に商人に通知し、取引結果を知らせる

WeChat SDK使用説明​

WeChat Payの公式ドキュメントは、AndroidおよびiOSクライアントSDKを使用して決済コンポーネントを呼び出す手順とサンプルコードを提供しています。詳細は開発ガイドとAPPでの決済起動を参照してください。

WeChatのドキュメントに記載されている【統一注文】APIは、PayCloudが提供する【APP決済注文】APIを使用してください。日本地域におけるWeChat Payの公式サービスプロバイダーとして、WeChat Payの機能はすでに統合されており、WeChat Payの接続手続きを簡略化しています。APIを使用して注文パラメータを取得し、WeChat Payを呼び出すだけです。

PayCloudのAPP決済APIはpay_paramsというJSONオブジェクトを返します。例として、以下の構造が示されています：

{
    "appid":"wx8888888888888888",
    "partnerid":"1900000109",
    "prepayid":"WX1217752501201407033233368018",
    "package":"Sign=WXPay",`
    "noncestr":"5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
    "timestamp":"5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
    "sign":"5K8264ILTKCH16CQ2502SI8ZNMTM67VS"
}

Alipay+クライアント決済起動​

Alipay+は、数十のモバイル決済ウォレットの決済機能を集約したゲートウェイ製品で、商人は一度の開発で複数のウォレット機能を統合することができ、これらのウォレットサービスは現在も拡大中です。これにより、日本の商人は世界中からの支払いを受け入れることができ、ユーザーは自分の習慣にあった支払い方法を利用できます。

商人の開発者にとってより便利にするために、Alipay+は中間のH5ウェブページを提供しています。このページはユーザーの携帯電話にインストールされているアプリを自動的に検出し、サポートされているアプリを選択して、支払いリクエストをそのアプリに自動的に遷移させます。これにより、商人の開発者はウォレットSDKを複数の方法で統合する手間を省くことができます。

PayCloudのAPP決済APIはpay_paramsというJSONオブジェクトを返します。例として、以下の構造が示されています：

{
    "paymentUrl":"https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040098XYLX6JEL8817jb48uYF304Ww"
}

paymentUrlはAlipay+の決済ページのURLで、商人は自分のAPP内でこのウェブページを表示するだけで済みます。以下の例は、AndroidとiOSのAPP内でウェブページを表示する方法を示しています：

// WebViewはAndroidが提供するコンポーネントで、アプリケーション内でウェブコンテンツを読み込み、表示することができます。以下の手順でアプリにWebViewを埋め込むことができます：
<WebView
    android:id="@+id/webview"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

// ActivityまたはFragmentへのURLのロード
WebView webView = findViewById(R.id.webview);
WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true); // WebページでJavaScriptを有効にする必要がある場合
webView.loadUrl("https://example.com");

Alipay+ APPから商店のAPPに戻る方法​

PayCloudでの注文時に、return_url を渡すことができます。このURLは商店のAPPに登録されたカスタムURLスキーム（例：mymerchantapp://payment/success?order_id=123456789）であり、Alipay+ APPは支払いが完了した後、このスキームを使って商店のAPPを起動します。

Alipayオフラインモバイルウェブ支払いによるAPP支払い実現​

オンラインAlipay支払いサービスを申請していない商店は、商店のAPPからAlipay APPに遷移し、オフラインのモバイルウェブ支払いインターフェースを利用して支払いを行うことができます。

オフライン支払いをオンライン支払いに切り替える重要な手順は以下の通りです：

  • 商店のAPPからAlipay APPに遷移し、Alipay APP内であなたのウェブページを開きます。遷移方法については、Alipay公式文書の携帯サイト支払いをalipaysプロトコルで呼び出すをご覧ください。
  • Alipay APPに遷移した後、あなたのバックエンドサーバーからPayCloudのオフラインモバイルウェブ支払いインターフェースを呼び出し、対応するAlipay決済ページのHTTPSリンクを取得して、そのリンクを開くだけで支払いコントロールを呼び出すことができます。
  • 支払いを開始するには、必ずAlipay APP内でPayCloudインターフェースを呼び出してください。さもなければ、オンライン支払いとして認識され、支払いを呼び出すことができません。
注意事項

この方法でオフライン業務をオンラインシーンに拡張することは可能ですが、一定のリスクも伴います。銀行や決済機関はこの操作を不正行為と見なす可能性があり、制限や罰則を受けるリスクがあります。慎重に使用し、制限や罰則を避けるようにしてください。