PayPay 都度決済
概要
PayPay（都度決済）は、お客様がPayPayアカウントを利用してオンライン決済を行えるサービスです。
お客様はPayPayアプリまたはブラウザからログインし、簡単かつ安全に決済できます。
多くのユーザーに利用されているPayPayの決済基盤を活用した、利便性の高い決済手段です。
PayPay都度決済を始めるには
-
契約の確認・申込
ご利用にはPayPay（都度決済）の契約が必要です。未契約の場合は営業担当へご連絡ください。
仮売上/実売上運用・即時売上運用は、契約時に1ショップにつきいずれか一つを選択します。
仮売上/実売上運用・即時売上運用を同時に利用する場合は、2つのショップ契約が必要です。 -
テスト環境での動作確認
テスト環境に関する情報はこちらを確認してください。 -
本番稼働開始
動作確認完了後、本番運用を開始します。
接続方式のサポート
| 接続方式 | サポート状況 | 関連リンク |
|---|---|---|
| OpenAPIタイプ | ✔ 対応 | API仕様 |
| プロトコルタイプ | ✔ 対応 | API仕様（idPass） API仕様（json） |
| リンクタイプ Plus | ✔ 対応 | API仕様／決済識別子 |
取引状態
PayPay都度決済で取り得る取引状態は以下の通りです。
| 取引状態 | コード | 説明 |
|---|---|---|
| 未決済 | UNPROCESSED | 決済が完了していない状態（お客様がご注文途中に離脱が主な原因） |
| 要求成功 | REQSUCCESS | 決済準備が整った状態（まだお客様は支払っていません） |
| 認証処理中 | AUTHPROCESS | お客様がPayPayで支払い操作中の状態 |
| 仮売上 | AUTH | 決済が正常に完了し、ご利用枠を確保した状態 （PayPay残高から指定した金額を確保します） |
| 実売上 | SALES | 売上が確定した状態 |
| 実売上受付 | REQSALES | PayPay増額売上を受付けた状態 |
| 即時売上 | CAPTURE | 仮売上を行わず、売上を確定した状態 |
| キャンセル | CANCEL | 仮売上の取引がキャンセルされた状態 （仮売上で確保した金額をPayPay残高に戻します） |
| 返金 | RETURN | 売上を確定した取引がキャンセルされた状態 （確定した売上金をPayPay残高に戻します） |
| 決済失敗 | PAYFAIL | お客様による支払い中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態 |
| 期限切れ | EXPIRED | 認証処理中の状態を一定時間経過した状態 |
運用例
仮売上/実売上運用
仮売上でお客様の入金額のうち商品の代金分を確保しておき、売上が確定したタイミングで実売上に変更してお客様への請求を行います。
即時売上運用
受注と同時に売上を確定し、お客様への請求を行います。
実売上
- 実売上可能期間：仮売上後30日以内
例：10月1日 13:00 に決済（仮売上）を行った場合
10月31日 12:59:59 まで実売上が可能 - 実売上は1回のみ可能です。
- 実売上の金額が仮売上の金額未満の場合、差額はキャンセルとして扱われます。
- 期限を超過した場合はエラーとなり、売上確定できません。
- 実売上期限内に売上を確定しない場合、確保していた金額はお客様のPayPay残高へ戻り、カード払いの場合は与信枠が解放されます。
増額売上について
仮売上した金額より増額して実売上することが可能です。
増額売上は非同期処理で、以下の流れで処理されます。
- 加盟店側で増額分の実売上を実行するリクエストを送信
- 当サービスがPayPayへ増額売上要求を送信し、取引状態が「実売上受付」(
REQSALES)に変更される - PayPayがユーザーに増額売上の同意を求めるプッシュ通知を送信
- ユーザーが同意すると、PayPayが当サービスへ結果を通知し、取引状態が「実売上」(
SALES)に変更される
OpenAPIタイプでは増額売上ができません。
- 増額売上は非同期処理です。実売上APIの応答時点では「実売上受付」状態となります。
- プッシュ通知送信後、ユーザーが6時間以内に同意しない場合は不成立となり、取引状態は自動的に仮売上に戻ります。
- 不成立でも与信有効期間内であれば再度増額売上を実行できます。
- 増額売上は実売上可能期間の6時間前までしか処理できません。
プッシュ通知の内容はプッシュ通知を参照してください。
返金
取引状態により処理内容およびキャンセル/返金可能期間が異なります。
請求確定前の取り消し
キャンセル（仮売上の取り消し）は、全額キャンセルのみ可能です。
キャンセルを実行すると、確保していた金額がお客様のPayPay残高に戻ります。
| 取引状態 | キャンセル可能期間 |
|---|---|
| 仮売上 | 仮売上後30日以内 |
請求確定後の取り消し
返金（実売上・即時売上の取り消し）は、全額返金と一部返金が可能です。
| 取引状態 | 処理内容 | 返金可能期間 |
|---|---|---|
| 実売上／即時売上 | 全額返金 | 実売上、即時売上後180日以内 |
| 実売上／即時売上 | 一部返金 | 実売上、即時売上後180日以内 |
- 一部返金は20回まで可能です。
- 誤操作による再返金はお受けできませんので操作には十分ご注意ください。
金額変更
金額変更はできません。
ただし、仮売上から実売上へ変更する際に、仮売上時の金額より増額・減額して実売上することが可能です。
詳細は実売上を参照してください。
期限切れ
決済有効期限
お客様がPayPayの画面に遷移してから5分以内に購入を完了する必要があります。
5分を超えた場合、取引状態は「認証処理中」のままになります。
当サービスはPayPayから非同期で購入完了通知を受信するため、
「認証処理中」の状態から「仮売上/即時売上」の状態になるまでの処理時間は5分を超える可能性があります。
期限切れになるタイミング
当サービスにて毎時0分に取引状態を確認し、「認証処理中」のまま10分を経過した取引については
お客様が途中で決済を中断したと判断し、取引状態を「期限切れ」(EXPIRED)に更新します。
画面遷移
PayPayが必要と判断した場合のみ、
PayPayアカウントに登録した携帯電話番号宛てに送信されるワンタイムパスワードの入力も求められる場合があります。
PCブラウザ
PCブラウザで購入する場合、PayPayログイン画面でPayPayに登録した携帯電話番号とパスワードを入力してログインします。
PCブラウザ→PayPayアプリ
ログイン画面に表示されたQRコードをスマートフォンのPayPayアプリで読み取ると、スマホ側で決済処理が行われます。決済完了後、PCブラウザも購入完了画面に遷移します。
スマートフォンブラウザ
スマートフォンで購入する場合、PayPayアプリがインストールされていればアプリが自動で起動するため、ログイン操作は不要です。
アプリで決済が完了すると、お客様には購入結果がプッシュ通知で届きます。
- ブラウザがSafariやChrome以外の場合はアプリ連携が正しく動作しないことがあります。
- PayPayアプリがインストールされていない場合は、PayPayのログイン画面が表示され、Web上で決済が完了します。
PayPayアプリから加盟店様スマホアプリへの遷移
- OpenAPIタイプ
- プロトコルタイプ
- リンクタイプ Plus
PayPayアプリから加盟店様スマホアプリに戻るために、
都度支払い（wallet/charge）APIのリクエストパラメータ「コールバックURLmerchant.callbackUrl」には、
Universal Links / App Linksリダイレクト用POST受け取りページを指定してください。
PayPayアプリから加盟店様スマホアプリに戻るために、
決済実行（ExecTranPaypay）APIのリクエストパラメータ「決済結果戻しURLRetURL」には、
Universal Links / App Linksリダイレクト用POST受け取りページを指定してください。
PayPayアプリから加盟店様スマホアプリに戻るために、
共通パラメータ「戻り先URLRetUrl」「完了時戻り先URLCompleteUrl」「キャンセル時戻り先URLCancelUrl」には、
Universal Links / App Linksリダイレクト用POST受け取りページを指定してください。
Universal Links / App Linksで起動したアプリではPOSTパラメータを受け取れないため、
加盟店様サーバに用意したPOST受け取り用ページを経由する必要があります。
テスト環境
仮売上/実売上運用・即時売上運用の切り替えができます
テスト環境のみ、ショップ管理画面から仮売上/実売上運用・即時売上運用の切り替えが可能です。
設定の変更方法はPayPay管理画面を使った運用を参照してください。
初期状態では、「仮売上/実売上」を設定しています。
PayPayアプリを利用した決済はできません
当サービスが提供しているテスト環境は動作確認のための簡易的な機能のみです。
PayPayアプリを利用した決済は行えません。
当サービスが提供するテスト用Webページにて決済を行ってください。
その他の留意事項
PayPayで利用できる支払い方法
PayPayでは主に以下の4種類の支払い方法が利用できます。
加盟店様側で利用可能な支払い方法は契約内容によって異なります。詳細は営業担当へご確認ください。
- PayPay残高：
チャージしたPayPay残高を使って支払います。PayPayポイントも併用できます。 - PayPay残高カード（バーチャルカード）：
PayPay残高にチャージして支払うカード方式です。 - PayPayクレジット / クレジットカード：
PayPayに登録したクレジットカードまたはPayPayクレジットを利用して支払います。
3Dセキュア（本人認証）設定により利用上限が変わる場合があります。 - PayPayデビット（旧：PayPay銀行残高）：
PayPay銀行口座を利用したデビット決済です。利用には本人確認が必要です。
海外からのアクセス
PayPayは国内での決済を目的としたサービスであるため、海外からのアクセスはエラーになる場合があります。
プッシュ通知
決済完了、実売上、キャンセル、返金、プッシュ課金購入要求のタイミングで
PayPayアプリからお客様宛にプッシュ通知が送信されます。
プッシュ通知の内容についてはプッシュ通知 を参照してください。
ロゴ画像
必ずロゴマーク利用ガイドラインを確認の上ご利用ください。
下記のウェブサイトからダウンロードしてください。