都度決済について

【都度決済機能】

消費者の購入した商品などについて、1回だけ決済を行います。
都度決済機能には以下の特徴があります。

1. 都度決済の申込は「課金種別」を未指定、あるいは都度決済を指定して行います。
2. 都度決済の申込は、消費者の端末から行います。
3. 与信取消、売上、売上後の返金はMDKまたは管理画面（MAP）から可能です。

決済の画面遷移のイメージを以下に示します。

PCで決済

スマートフォンで決済

スマートフォンでの決済では、加盟店サイトからPayPayアプリが起動し、PayPayアプリの操作により決済が完了します。
PayPayアプリの起動はSBペイメントサービス様（以下、SBPS）の制御により自動で行われますが、何らかの理由でPayPayアプリが起動しなかった場合は、PCと同様にブラウザ上での遷移となります。

PC＋スマートフォンで決済

随時決済について

【随時決済機能】

店舗様と利用者の継続的な利用の承諾に基づき、商品などの提供状況に応じて加盟店の処理要求単位に課金することができます。
解約手続き（利用承諾の終了）が行われるまで、店舗様からの要求の都度、課金が発生します。
随時決済は定期購入商品/サービスの提供にのみご利用いただけます。

1. 随時決済の申込（利用承諾）は「課金種別」に随時決済を指定し、都度決済と同様のフローで行います。
   

   ※申込フローでは利用承諾のみを行うため金額指定はできません。

2. 随時決済の申込は、消費者の端末から行います。
3. 課金の実行は店舗様のシステムから行います。
   1.の取引IDを元取引IDに指定し、新しい取引IDと金額を指定して再与信を行います。与信に問題がなければ、同時に売上が確定します。（随時決済の再与信は「与信同時売上」となります。）
4. 再与信時に残高が不足していた場合に、消費者に支払い要求（支払いを促すプッシュ通知）を送ることができます。
5. 4.の支払い要求を取消（キャンセル）することもできます。
6. 返金が必要になった場合は、3.の再与信時の取引IDに対して返金を実行します。
   返金はMDKまたは管理画面（MAP）から実行可能です。
7. 随時決済の解約が行われるまで3.4.5.6.を何度でも実施できます。
   ただし、消費者によるPayPayアプリからの解約により利用承諾終了となる場合があり、抹消通知が店舗様に通知されます。
8. 随時決済の解約はMDKまたは管理画面（MAP）から可能です。
   MDKの場合、消費者端末からの解約処理(3者間)もしくは消費者を介さず加盟店での強制解約処理(2者間)のいずれかで行うことができます。

申込の画面遷移イメージを以下に示します。

※随時決済の場合、PayPayアプリがインストールされたスマートフォンから申込する場合でもPayPayアプリとは連動されずWebサイト上での申込となります。

申込

再与信

取消

売上

返金

解約

消費者ブラウザから店舗側の完了画面へリダイレクトする時のクエリパラメータ

検索

• 「設定」欄の内容は以下の通りとなります。

  要求電文 ...

  必須項目：○　　任意項目：△　　設定不可：×　　その他条件付：※（条件は説明欄に記入）

  応答電文 ...

  必ず返戻：○　　該当取引存在時に返戻：△　　返戻なし：×　　その他条件付：※

• 複数指定は0～の添字を指定します。

  例）exparam.serviceTypeCd[0]=card&exparam.serviceTypeCd[1]=paypay）

• ワイルドカードは値の一部と"*"を組み合わせて検索します。"*"のみの指定はできません。

  例）exparam.searchParameters.common.orderId=123*

結果通知電文の概要

実装方法の詳細につきましては、弊社より提供しているサンプルプログラムをご参照ください。

機能概要

決済サーバーから店舗システムへ決済の結果通知を行います。
通知は、HTTPのPOSTを利用します。

※プロトコルはHTTP（Port：80）、HTTPS（Port：443）に対応しています。
処理の概要については「結果通知受信処理」をご参照ください。

HMACについて

POSTにてデータを通知するとき、リクエストヘッダーにHMACを設定します。 また、HMAC値は、リクエストボディから算出します。 アルゴリズムは「HmacSHA256」が設定されます。

結果通知受信処理結果について

決済サーバーからの通知に対して店舗側システムがHTTPステータスコード"200"を返戻した場合、受信処理が正常に
終了したものと判断します。"200"以外のコードを返した場合は、受信失敗と判断し、一定期間、通知を繰り返します。

※規定の回数失敗した場合は、通知処理が停止しますのでご注意ください。

結果通知のタイミング

PayPay（オンライン決済）における結果通知電文の通知タイミングは、下記となります。

No.1、2はPayPay側で申込みが成立し、決済サーバーがPayPayからの通知を受信したタイミングとなります。
この時点では、店舗側の完了画面URLへの遷移はまだ行われていません。
消費者が画面遷移の途中で離脱した場合や、通信環境の問題で画面遷移時にタイムアウトが発生した場合には、最終遷移先の完了画面URLまで到達しない場合がありますので、このような場合にも、決済サーバーからの通知を店舗側システムで受信して頂くことで、処理が成立したことを検知することができます。

結果通知項目

以下に、PayPay（オンライン決済）の結果通知項目を示します。

決済金額について

お支払い方法によって上限金額が設定されています。詳しくはPayPayのサイトをご参照ください。

《PayPayよくあるご質問》

売上方式について（都度決済）

申込時の売上処理が「与信後売上方式」となるか「与信売上方式」となるかは、加盟店様の決済事業者との契約内容によってあらかじめ決定します。

※いずれかの方式となり併用はできません。

加盟店様の売上方式はMAP（Merchant Administration Portal）で確認することができます。
ダッシュボード > サービス利用情報 > PayPay > ご利用の決済処理方式

• 与信後売上方式（Authorize）
• 与信売上方式（Authorize with Capture）

※共用のテストアカウントをご利用される場合は、売上方式によってテストアカウントを使い分けてください。

• 与信後売上方式（Authorize）
  　⇒マーチャントID：A100000000000001069713　をご利用ください。
• 与信売上方式（Authorize with Capture）
  　⇒マーチャントID：A100000000000001069951をご利用ください。

以下、与信後売上方式での設定および注意事項を記します。

与信有効期限について

取引の与信有効期限は「決済申込時点から指定の与信有効期限日数後の同時刻まで」です。
決済申込時点の取引は与信のみを取得した状態です。
売上処理は与信取得後から与信有効期限を超過するまでに行ってください。

加盟店様にて与信有効期限日数を設定する方法を以下に示します。
設定変更はMAP（Merchant Administration Portal）の各種設定変更画面から行うことができます。

1. 与信有効期限日数を指定する
   「与信有効期限日数」欄に1～30日で任意の日数を設定してください。
   ＜注意事項＞

   決済事業者のデフォルトの有効期限上限日数は30日ですが、
   事業者との調整で上限日数を30日より短くしている場合にそれを超える値を設定すると申込処理でエラーが発生します。
   例） 加盟店様の上限日数が20日に設定されている場合にMAPで30日を設定して申込する。
2. PayPayに直接申し込んだ有効期限日数を使用する
   MAPで設定可能な有効期限日数の上限は30日です。
   この上限値制約を超える日数を適用したい場合には決済事業者に申し込みし上限値を調整いただく必要がございます。
   申し込み等詳細につきましては弊社までご連絡ください。
   申し込んだ値を使用する場合、
   「PayPayに申し込んだ値を適用する」のチェックボックスにチェックを入れて設定を保存してください。

各種設定変更 > 各種決済設定変更 > PayPay > 与信有効期限日数

取消について

売上について

返金について

与信売上方式では申込後、与信後売上方式では売上後の取引について返金を行うことができます。

返金結果が消費者に反映されるタイミングについて

返金結果は、残高へ即時に反映されます。

部分返金

部分返金については、決済金額を超えない範囲で、返金金額を指定できます。

処理要求可能期間について

PayPay（オンライン決済）サービスにおける各処理の要求可能期間を下表に示します。

※1：詳細は「与信有効期限について」をご参照ください。

消費者における支払い／申込時間制限

消費者が加盟店様サイトからPayPayサイトへ画面遷移してから手続き完了するまでには時間制限があります。
時間制限を超えた場合、消費者による申込処理（都度決済の場合は支払い、随時決済の場合は利用承諾申込）が完了できません。
このような場合には申込処理を最初からやり直していただくようごご案内ください。

随時決済の解約単位について

随時決済取引の解約は加盟店単位となります。
決済サーバーの仕様上、申込取引に対して個別の解約処理となっておりますが、
解約単位は加盟店単位となる為、解約要求を行った取引に紐づく消費者が利用しているすべての取引が解約されます。

例えば、ある消費者が〇〇加盟店で随時決済取引A, B, Cを申し込んでいます。

そのうちの【取引A】に対して解約処理を行った場合を以下に示します。

※消費者を介する解約（3者間）もしくは加盟店による強制解約(2者間)のいずれでも同様となります。

解約処理後の各取引の承諾状態と抹消通知の有無は以下の通りです。

決済サーバーにおいて解約申込が行われなかった【取引B】【取引C】は承諾状態のままとなります。
これらの取引に対して再与信を行おうとすると、結果応答の「vResultCode(詳細結果コード)」で「1G19(既に解約済みの取引のため、処理を中止しました。)」を返戻します。

尚、取引における消費者固有の決済情報として「顧客決済情報」を申込完了時、解約完了時および検索結果で連携致します。
加盟店様サイトではこの情報により消費者に紐づく取引情報を管理いただき、上記のようなケースへの対応をご検討ください。

次に消費者がPayPayアプリから〇〇加盟店との連携を解除した場合を以下に示します。
消費者がPayPayアプリで可能な操作はこの「加盟店との連携解除」のみで、個別の申込取引に対する解約操作はできません。

加盟店との連携解除後の承諾状態と抹消通知の有無は以下の通りです。

PayPayアプリから加盟店との連携解除が操作されると決済サーバーから抹消通知を送信します。
通知は各取引に対して送信されます。加盟店様サイトでは抹消通知を受信し取引情報を更新してください。

使用可能文字一覧

PayPay（オンライン決済）の下記項目にて、使用可能な文字の範囲を以下に表します。
使用可能文字の範囲外の文字を使用した場合、文字化けが発生し処理エラーとなる可能性があります。

※半角カナは全角カナに置換されます。この置換によって上限を超過した場合、超過分の文字は切り捨てられますので、ご注意ください。

機種依存文字

決済サーバーに送信する電文の文字エンコーディングはUTF-8 ですが、PayPay側のインターフェイスではShift-JIS が利用されます。したがって、一部のShift-JIS（MS932 含む）などの機種依存文字は利用できません。
利用できない文字を設定した場合は、消費者の画面での文字化けや、PayPay側での決済処理が失敗する場合がありますので、決済サーバーでは、以下の検証により許可する全角文字列の判定を行っています。
・UTF-8 からShift-JIS に変換後、再度UTF-8 に変換した文字が、元の文字と同一であること。

この判定によって、以下のような文字を含む場合はエラーとなりますので、ご注意ください。

スマートフォンアプリ（加盟店アプリ）のアプリ内ブラウザを利用する場合

スマートフォンアプリ（以後、加盟店アプリと呼びます）のアプリ内ブラウザを利用する場合も、通常のブラウザ（ChromeやSafari）を利用した場合と同様の制御がSBPSシステムの仕様により行われます。ただし、通常のブラウザとアプリ内ブラウザでは完全に同じ動作とはならない場合があり、加盟店アプリの実装において、アプリ内ブラウザをどのように制御しているかにより、挙動は変わってきます。例えば、アプリ内ブラウザから別のWindowや別のアプリが起動できないような制御を行っていたり、何らかの理由によりPayPayアプリが起動しないことは起こり得ることです。PayPayアプリが起動しない場合にも、PCと同様にアプリ内ブラウザにログイン画面が表示されるため、決済を正常に完了させることは可能です。

一方で、アプリ内ブラウザからの遷移によりPayPaｙアプリが起動する場合には、通常のブラウザからの遷移と同様に「標準ブラウザ」が起動されて加盟店様のURLが呼び出されることになるため、何もしなければ加盟店アプリには戻ることができません。

決済完了後に加盟店アプリに戻すためには、加盟店アプリを起動するためのランディングページを作成する必要があります。
申込要求電文(PaypayAuthorizeRequestDto)の決済完了時URL(successUrl)には、作成したランディングページのURLを指定してください。

ランディングページ作成の例）

以下の設定を持つ店舗アプリに遷移したい場合のHTMLページのサンプルを示します。

• 起動時のURLスキーム：paypaysample
• 起動時のURLホスト：www.example.com
• 起動時のURLパス：result

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>アプリ起動</TITLE>
</HEAD>
<SCRIPT language="javascript" type="text/javascript">
window.location.href = "paypaysample://www.example.com/result";
</SCRIPT>
<BODY>
○○アプリを起動します。
</BODY>
</HTML>

加盟店アプリ利用時の遷移種別(transitionType)の指定について

スマートフォンアプリ（加盟店アプリ）からの遷移でPayPayアプリが起動するとき、SBPSシステムの制御によりPayPayアプリ起動前後で標準ブラウザが起動しますが、都度決済時の申込要求電文(PaypayAuthorizeRequestDto)で遷移種別(transitionType)を指定することで、標準ブラウザが起動する事象を回避することが可能です。

【transitionType未指定の場合（例）】

加盟店アプリとPayPayアプリ連携間でスマートフォンの標準ブラウザ起動が発生します。

【transitionTypeを指定する場合】

遷移種別(transitionType)の指定により、加盟店アプリとPayPayアプリ連携間のブラウザ起動を回避することができます。

• 現在の仕様では、"1"：アプリから遷移（WebLink） を指定してください。

加盟店アプリ利用時のPayPay起動に問題が発生する場合の対処について

上で説明したtransitionTypeの指定等の対処を行ってもPayPay起動に関連する問題が発生する場合は、アプリ内ブラウザを利用せずに、標準ブラウザを起動して遷移させること（responseContentsを標準ブラウザを起動して送信し、SBPSシステムに遷移させること）をお勧めします。標準ブラウザから遷移を開始することで、アプリ内ブラウザの実装により発生する問題は回避できます。

再与信で消費者への「支払い要求通知」が送信された場合

再与信の要求時に消費者への「支払い要求通知」が送信された場合、決済サーバーからは以下のレスポンスを返戻し、MAP管理画面上の取引履歴にはステータス【売上要求】（成功）が記録されます。

ステータス【売上要求】（成功）となった取引は、その後、消費者が支払い操作を行うとステータス【売上】（成功）が記録されます。

消費者が支払い操作を行わなかった場合等、売上が成立しなかった場合にはステータス【売上】（失敗）が記録されます。

「支払い要求」の取消を行った場合

消費者への「支払い要求通知」が送信された後、支払い操作が行われる前であれば、支払い要求の取消を行うことができます。
支払い要求の「取消」を行った場合、MAP管理画面上の取引履歴には、ステータス【キャンセル（売上要求）】が記録されます。

取消が成功した場合は、ステータス【キャンセル（売上要求）】（成功）が記録されます。

取消が失敗した場合は、ステータス【キャンセル（売上要求）】（失敗）が記録されます。

また、支払い有効期限が超過したタイミングでステータス【売上】（失敗）が記録されます。

再与信および取消、返金に対する「保留」が発生した場合の対処について

随時決済の再与信（売上／売上要求）、取消（支払い要求の取消）、返金の要求において、弊社とPayPay（SBPS）の通信異常等により処理の状態が不明となった場合は、以下のレスポンスを返し、MAP管理画面上の取引履歴にはそれぞれの要求が保留として記録されます。

保留（pending）となった取引については、弊社システム側で定期的にSBPSシステムへの状態確認を行い、ステータスの更新を行います。
保留後のステータス更新時には、一部のステータス（ 【売上要求】（保留）⇒【売上】（成功） ）を除き、システムによる結果通知は送信されませんので、保留が発生した際には、しばらく待ってから MAP管理画面にて状態のご確認をお願いします。通常は、およそ20分程度でステータスの更新が行われ、MAP管理画面上に取引履歴として記録されます。

• 【売上】（保留）の場合

  • ①-1 【売上】（保留）⇒（成功）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	売上	1000	保留	1E50000000000000
    2024/01/17 13:15:00	売上	1000	成功	1001000000000000

  • ①-2 【売上】（保留）⇒（失敗）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	売上	1000	保留	1E50000000000000
    2024/01/17 13:15:00	売上	1000	失敗	1G17000000000000

• 【返金】（保留）の場合

  • ②-1 【返金】（保留）⇒（成功）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	返金	1000	保留	1E50000000000000
    2024/01/17 13:15:00	返金	1000	成功	1001000000000000

  • ②-2 【返金】（保留）⇒（失敗）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	返金	1000	保留	1E50000000000000
    2024/01/17 13:15:00	返金	1000	失敗	1G13000000000000

• 【売上要求】（保留）の場合

  • ③-1 【売上要求】（保留）⇒【売上要求】（成功）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	売上要求	1000	保留	1E52000000000000
    2024/01/17 13:15:00	売上要求	1000	成功	1G21000000000000

  • ③-2 【売上要求】（保留）⇒【売上要求】（失敗）

    このケースは存在しません。
    売上要求に失敗した場合には、③-4のケースとなります。

  • ③-3 【売上要求】（保留）⇒【売上】（成功）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	売上要求	1000	保留	1E52000000000000
    2024/01/17 13:15:00	売上	1000	成功	1001000000000000

  • ③-4 【売上要求】（保留）⇒【売上】（失敗）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	売上要求	1000	保留	1E52000000000000
    2024/01/17 13:15:00	売上	1000	失敗	1G34000000000000

• 【キャンセル（売上要求）】（保留）の場合

  • ④-1 【キャンセル（売上要求）】（保留）⇒（成功）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	キャンセル（売上要求）	1000	保留	1E50000000000000
    2024/01/17 13:15:00	キャンセル（売上要求）	1000	成功	1001000000000000

  • ④-2 【キャンセル（売上要求）】（保留）⇒（失敗）

    このケースは存在しません。
    キャンセル（売上要求）に失敗した場合には、④-3 または ④-4のケースになります。

  • ④-3 【キャンセル（売上要求）】（保留）⇒【売上】（成功）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	キャンセル（売上要求）	1000	保留	1E50000000000000
    2024/01/17 13:15:00	売上	1000	成功	1001000000000000

  • ④-4 【キャンセル（売上要求）】（保留）⇒【売上】（失敗）

    取引日時	ステータス	金額	取引結果	結果コード
    2024/01/17 13:00:00	キャンセル（売上要求）	1000	保留	1E50000000000000
    2024/01/17 13:15:00	売上	1000	失敗	1G34000000000000