トークン化

どのように動作するか

トークン化とは、決済UIを開くことなく、またユーザーが関与することなく、安全に決済処理を行うことができるAPIエンドポイントのセットのことを指します。主な特徴:

  • 保存されている決済アカウントのリストを取得する
  • 保存した決済アカウントを使用して決済を行う
  • 決済アカウントを削除する

決済アカウントは以下の場合に保存されます:

  • 決済はペイステーションのUIを介して行われます。ユーザーが入力時に決済データを保存することに同意すると、新たに保存されたアカウントが追加されます。
  • ペイステーションは、決済アカウントの保存モードで開きます。有効するには、トークンを取得する時はsettings.ui.modeパラメーターを取得します。

決済アカウントが保存されると、IDが付与されます。APIリクエストでこのIDを指定することで、ユーザーの操作や決済UIを開かずに決済を行うことができます。

トークン化に対応した決済手段:

  • 銀行カード
  • Amazon Pay
  • Skrill Digital Wallet
  • PayPal
  • Alipay
  • GCash
  • DANA
  • Rabbit LINE pay
  • Touch ’n Go
  • Boost
  • Toss

入手方法

トークン化を使用する場合は、保存された決済アカウントで作業するためのエンドポイントを実装してください。

保存済みの決済アカウントで決済する

決済UIを開かずに保存された決済アカウントで決済を行うには、以下の方法でアプリに実装します:
  1. ユーザーの保存された決済アカウントのリストを取得します
  2. いずれかの決済アカウントを経由して、ユーザーに請求します。
  3. 決済ウェブフックで受信したデータを処理し、購入した仮想商品をユーザーに計上します。
注意
購入した仮想商品は、決済ウェブフックからのデータに基づいてのみ発生しなければなりません。

保存した決済アカウントで表示する

保存されたアカウントを取得するリクエストを使用すると、ユーザーの保存された決済アカウントのマスキングされたデータを注文ページで取得することができます。

保存されている決済アカウントのマスキングデータを側で保存し、最新の状態に保つには:

  1. 決済アカウントを追加するウェブフックをセットアップします。ユーザーが新しい決済アカウントを追加した場合、そのアカウントを保存し、その後、決済UIを開くことなく、そのアカウントでの決済をユーザーに提案することができます。
  2. 決済アカウントを削除するウェブフックをセットアップします。

お知らせ
決済アカウントの追加と削除のためのウェブフックを設定するには、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。

保存された決済アカウントの管理ページでUIイベントを処理する

保存された決済アカウントの管理ページにリアルタイムで情報を表示するには、次の決済UIイベントを処理します:

  • add_saved_account — 決済アカウントの保存に成功しました。

フォーマット:

Copy
Full screen
Small screen
    command: "add_saved_account"
    data:
    id: 12345678
    name: "1111111111111111"
    payment_method: 0001
    type: "card"
    

    • add_saved_account_error — 決済アカウントの保存中にエラーが発生しました。
    • cancel_save_account — ユーザーによる決済アカウントの保存のキャンセル。

    決済UIをiframeで開くか、ペイステーション埋め込みスクリプトを使用して開くと、postMessageを介して決済UIからイベントを取得します。

    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    このページを評価する
    このページを評価する
    改善できることはありますか?

    答えたくない

    ご意見ありがとうございました!
    最終更新日: 2023年10月10日

    誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

    問題を報告する
    当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
    フォローアップ用のメールをご提供してください
    ご意見ありがとうございました!