PayPay スマートペイメント
概要
PayPay（スマートペイメント）は、都度決済とは異なり、PayPay画面へ遷移せずに、加盟店様の画面にて決済を行うことができる決済方式です。
PayPayスマートペイメントを始めるには
-
契約の確認・申込
ご利用にはPayPayスマートペイメントの契約が必要です。未契約の場合は営業担当へご連絡ください。
仮売上/実売上運用・即時売上運用は、契約時に1ショップにつきいずれか一つを選択します。
仮売上/実売上運用・即時売上運用を同時に利用する場合は、2つのショップ契約が必要です。 -
テスト環境での動作確認
テスト環境に関する情報はこちらを確認してください。 -
本番稼働開始
動作確認完了後、本番運用を開始します。
接続方式のサポート
| 接続方式 | サポート状況 | 関連リンク |
|---|---|---|
| OpenAPIタイプ | ✔ 対応 | API仕様 |
| プロトコルタイプ | ✔ 対応 | API仕様（idPass） API仕様（json） |
| リンクタイプ Plus | ✖ 非対応 |
取引状態
| 取引状態 | コード | 説明 |
|---|---|---|
| 未決済 | UNPROCESSED | 決済が完了していない状態（お客様がご注文途中に離脱が主な原因） |
| 要求成功 | REQSUCCESS | 決済準備が整った状態（まだお客様は支払っていません） |
| 仮売上 | AUTH | 決済が正常に完了し、ご利用枠を確保した状態 （PayPay残高から指定した金額を確保します） |
| 実売上 | SALES | 売上が確定した状態 |
| 実売上受付 | REQSALES | PayPay増額売上を受付けた状態 |
| 即時売上 | CAPTURE | 仮売上を行わず、売上を確定した状態 |
| キャンセル | CANCEL | 仮売上の取引がキャンセルされた状態 （仮売上で確保した金額をPayPay残高に戻します） |
| 返金 | RETURN | 売上を確定した取引がキャンセルされた状態 （確定した売上金をPayPay残高に戻します） |
運用例
仮売上/実売上運用
仮売上でお客様の入金額のうち商品の代金分を確保しておき、売上が確定したタイミングで実売上に変更してお客様への請求を行います。
即時売上運用
受注と同時に売上を確定し、お客様への請求を行います。
必須要件
スマートペイメントボタンの実装
PayPay提供のJS SDKを用いて加盟店様がスマートペイメントボタンの実装をする必要があります。
実装方法については、PayPayの開発者向け情報ページを参照ください。
orderInfo オブジェクト内のパラメータ設定
| パラメータ名 | 設定値 | 備考 |
|---|---|---|
isAuthorization | ・仮売上/実売上運用：true・即時売上運用： false | デフォルトではfalseになるため、仮売上/実売上運用の場合はtrueを設定してください。 |
merchantTimeoutAt | 1,800（秒）以内 | 指定しない場合、PayPay側取引と当社側取引の取引突合が行われず、不整合が発生する可能性があります。 |
expiresAt | 指定なし | 指定した場合、当社が返す実売上可能期間・キャンセル可能期間との不一致が生じ、エラーが発生する可能性があります。 |
amount | 取引登録リクエストの 利用金額+税送料 | 誤った値で連携した場合、入金差異が発生する可能性があります。 |
merchantPaymentId | 決済実行レスポンスの PayPayトラッキングID | 誤った値で連携した場合、PayPay側取引と当社側取引の整合性が取れず、入金差異が発生する可能性があります。 |
決済検証
PayPay SDKの応答のみで取引成否を判断すると改ざんのリスクがあるため、必ず以下のAPIを実行して決済結果を確認してください。
- プロトコルタイプ：決済検証API（JWSを連携して成功応答を確認）
- OpenAPIタイプ：支払い後検証（フロントエンド方式）API
（/wallet/front-end/verifyChargeを実行して取引状態を確認）
決済検証を省略すると、不正な改ざんを検知できずセキュリティリスクが生じます。
必ず決済検証処理を実装してください。
決済検証に関する留意事項
-
決済検証API・支払い後検証（フロントエンド方式）APIは既に決済が完了している取引に対して実行した場合も成功応答します。
例えば、決済検証に成功し取引状態が仮売上の取引に対し、再度実行した場合、Status=AUTHが返却されます。 -
PayPayハーフスクリーン上での決済時にFail callbackが返却された場合、
入金差異の発生を防ぐため決済検証API・支払い後検証（フロントエンド方式）APIを呼び出さないでください。
また、Fail callbackかつPayPay側で決済が成立している場合がありますが、その場合
PayPayからの購入結果通知の受信もしくは当社とPayPayとの同期処理で当社取引ステータスに反映されます。
推奨要件
結果通知の受信設定
加盟店様から決済検証が実行されない場合や決済検証に失敗した場合、加盟店様と当社間で不整合が生じる可能性があるため、結果通知の利用を推奨します。
設定方法は結果通知の設定を参照ください。
実売上
- 実売上可能期間：仮売上後30日以内
例：10月1日 13:00 に決済（仮売上）を行った場合
10月31日 12:59:59 まで実売上が可能 - 実売上は1回のみ可能です。
- 実売上の金額が仮売上の金額未満の場合、差額はキャンセルとして扱われます。
- 期限を超過した場合はエラーとなり、売上確定できません。
- 実売上期限内に売上を確定しない場合、取引は自動的にキャンセルされます。
増額売上について
仮売上した金額より増額して実売上することが可能です。
増額売上は非同期処理で、以下の流れで処理されます。
- 加盟店側で増額分の実売上を実行するリクエストを送信
- 当サービスがPayPayへ増額売上要求を送信し、取引状態が「実売上受付」(
REQSALES)に変更される - PayPayがユーザーに増額売上の同意を求めるプッシュ通知を送信
- ユーザーが同意すると、PayPayが当サービスへ結果を通知し、取引状態が「実売上」(
SALES)に変更される
OpenAPIタイプでは増額売上ができません。
- 増額売上は非同期処理です。実売上APIの応答時点では「実売上受付」状態となります。
- プッシュ通知送信後、ユーザーが6時間以内に同意しない場合は不成立となり、取引状態は自動的に仮売上に戻ります。
- 不成立でも与信有効期間内であれば再度増額売上を実行できます。
- 増額売上は実売上可能期間の6時間前までしか処理できません。
プッシュ通知の内容はプッシュ通知を参照してください。
返金
取引状態により処理内容およびキャンセル/返金可能期間が異なります。
また、募金・寄付の場合はキャンセル処理・返金処理はできません。
請求確定前の取り消し
キャンセル（仮売上の取り消し）は、全額キャンセルのみ可能です。
キャンセルを実行すると、確保していた金額がお客様のPayPay残高に戻ります。
| 取引状態 | キャンセル可能期間 |
|---|---|
| 仮売上 | 仮売上後30日以内 |
集金サービスを利用している場合は、キャンセル処理はできません。
請求確定後の取り消し
返金（実売上・即時売上の取り消し）は、全額返金と一部返金が可能です。
| 取引状態 | 処理内容 | 返金可能期間 |
|---|---|---|
| 実売上／即時売上 | 全額返金 | 実売上、即時売上後180日以内 |
| 実売上／即時売上 | 一部返金 | 実売上、即時売上後180日以内 |
- 一部返金は20回まで可能です。
- 誤操作による再返金はお受けできませんので操作には十分ご注意ください。
金額変更
金額変更はできません。
ただし、仮売上から実売上へ変更する際に、仮売上時の金額より増額・減額して実売上することが可能です。
詳細は実売上を参照してください。
テスト環境
仮売上/実売上運用・即時売上運用の切り替えができます
テスト環境のみ、ショップ管理画面から仮売上/実売上運用・即時売上運用の切り替えが可能です。
設定の変更方法はPayPay管理画面を使った運用を参照してください。
初期状態では、「仮売上/実売上」を設定しています。
PayPayアプリを利用した決済はできません
当サービスが提供しているテスト環境は動作確認のための簡易的な機能のみです。
PayPayアプリを利用した決済は行えません。
その他の留意事項
PayPayで利用できる支払い方法
PayPayでは主に以下の4種類の支払い方法が利用できます。
加盟店様側で利用可能な支払い方法は契約内容によって異なります。詳細は営業担当へご確認ください。
- PayPay残高：
チャージしたPayPay残高を使って支払います。PayPayポイントも併用できます。 - PayPay残高カード（バーチャルカード）：
PayPay残高にチャージして支払うカード方式です。 - PayPayクレジット / クレジットカード：
PayPayに登録したクレジットカードまたはPayPayクレジットを利用して支払います。
3Dセキュア（本人認証）設定により利用上限が変わる場合があります。 - PayPayデビット（旧：PayPay銀行残高）：
PayPay銀行口座を利用したデビット決済です。利用には本人確認が必要です。
海外からのアクセス
PayPayは国内での決済を目的としたサービスであるため、海外からのアクセスはエラーになる場合があります。
プッシュ通知
決済完了、実売上、キャンセル、返金、プッシュ課金購入要求のタイミングで
PayPayアプリからお客様宛にプッシュ通知が送信されます。
プッシュ通知の内容についてはプッシュ通知 を参照してください。
決済完了になるタイミング
PayPayハーフスクリーン上で決済成功したタイミングでお客様の残高から引き落とされます。
当サービスの取引状態への反映は以下のタイミングです。
①加盟店様からの決済検証の実行
②PayPayからの購入結果通知の受信（決済から即時～数秒後）
③当社とPayPayとの同期処理（決済から最大1時間以内）
①、②、③の順序性は保証しておりませんが、必須要件の通り①を実行ください。
ロゴ画像
必ずロゴマーク利用ガイドラインを確認の上ご利用ください。
下記のウェブサイトからダウンロードしてください。