メルペイ 随時決済
概要
メルペイ（随時決済）はお客様が初回に利用承諾を行うことで、その後は加盟店様の任意のタイミングで決済（随時決済）を行える仕組みです。
お客様の操作を都度必要としないため、サブスクリプション・従量課金・継続サービスなどの自動課金に適しています。
なお、利用承諾の取得方法には、請求が発生しない「利用承諾のみ」と、
都度決済と利用承諾を同時に実行する「都度決済＋利用承諾」の２つのパターンがあります。
メルペイ（随時決済）を始めるには
-
契約の確認・申込
ご利用にはメルペイの契約が必要です。未契約の場合は営業担当へご連絡ください。
※都度決済・随時決済で契約は共通です。 -
テスト環境での動作確認
テスト環境に関する情報はこちらを確認してください。 -
本番稼働開始
動作確認完了後、本番運用を開始します。 テスト環境⇒本番環境への切り替えチェックリストはこちら
接続方式のサポート
| 接続方式 | サポート状況 | |
|---|---|---|
| OpenAPIタイプ | ✔ 対応 | API仕様 |
| プロトコルタイプ | ✔ 対応 | API仕様（idPass） API仕様（json） |
| リンクタイプ Plus | ✖ 非対応 |
利用承諾状態
メルペイ（随時決済）で取り得る利用承諾状態は以下の通りです。
| 利用承諾状態 | コード | 説明 |
|---|---|---|
| 未決済 | UNPROCESSED | 利用承諾が完了していない状態（お客様のご注文途中の離脱が主な原因） |
| 要求成功 | REQSUCCESS | 利用承諾を行う準備が整った状態（まだ利用承諾は完了していません） |
| 利用承諾 | REGISTER | 利用承諾が正常に完了した状態 |
| 利用承諾終了 | END | 利用承諾を終了した状態 |
| 決済失敗 | PAYFAIL | お客様による利用承諾の中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態 |
| 期限切れ | EXPIRED | 要求成功の状態を一定時間経過した状態 |
取引状態
メルペイ（随時決済）で取り得る取引状態は以下の通りです。
| 取引状態 | コード | 説明 |
|---|---|---|
| 未決済 | UNPROCESSED | 決済が完了していない状態（お客様のご注文途中の離脱が主な原因） |
| 仮売上 | AUTH | 決済が正常に完了し、ご利用枠を確保した状態 （メルペイ残高から指定した金額を確保します） |
| 実売上 | SALES | 売上が確定した状態 |
| 即時売上 | CAPTURE | 仮売上を行わず、売上を確定した状態 |
| キャンセル | CANCEL | 仮売上の取引がキャンセルされた状態 （仮売上で確保した金額をメルペイ残高に戻します） |
| 返金 | RETURN | 売上を確定した取引がキャンセルされた状態 （確定した売上金をメルペイ残高に戻します） |
| 決済失敗 | PAYFAIL | お客様による支払い中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態 |
| 期限切れ | EXPIRED | 要求成功の状態を一定時間経過した状態 |
サブスクリプションID
メルペイ（随時決済）は、初回の「利用承諾」で取得した サブスクリプションID を用いて、
加盟店様が任意のタイミングで課金を実行できる仕組みです。
参照方法
発行済みのサブスクリプションIDは以下の方法で参照できます。
| 参照方法 | 対応環境 | 備考 |
|---|---|---|
プロトコルタイプ SearchTradeMulti | API | 取引情報を条件検索可能 |
| メルペイ結果通知プログラム | バッチ／Webhook | 取引完了後に通知 |
| 管理画面 → メルペイ → 利用承諾検索タブ | Web管理画面 | ID・状態を照会可能 |
有効期限
お客様の利用承諾により発行されたサブスクリプションIDは、無期限でご利用可能です。
実売上
- 実売上可能期間：仮売上後60日以内
- 実売上可能回数：1回のみ
- 金額チェック：実売上時の金額が仮売上額を超過するとエラーとなります。
- 減額対応：仮売上金額未満の場合、差額は自動的にキャンセル処理されます。
期限を過ぎた取引（仮売上60日超過）は自動的にキャンセルされ、確保していた金額が解放されてお客様のメルペイ残高に戻ります。
返金
キャンセル操作は取引状態により処理内容およびキャンセル可能期間が異なります。
| 取引状態 | 操作 | 処理内容 | キャンセル可能期間 |
|---|---|---|---|
| 仮売上 | キャンセル | 該当取引を取消します | 仮売上後60日以内 |
| 実売上／即時売上 | キャンセル | 指定金額分をお客様に返金します（一部返金※可能） | 即時売上後180日以内 |
※一部返金は請求金額が0円になるまで回数制限なく可能です。
金額変更
増額
増額はできません。
減額
- 取引状態が実売上または即時売上の場合は、一部返金をすることで減額が可能です。
期限切れ
お客様はメルカリアプリで決済を開始してから20分以内に決済を実行する必要があります。
20分を経過すると利用承諾を行えずに加盟店様の「決済完了後の戻り先URL」に遷移します。
決済直後にお客様がメルカリアプリを終了したり、電波状況が悪くなった場合など
いくつかの理由により「決済完了後の戻り先URL」へ遷移しないこともあります。
当サービスでは毎日AM0:30頃にバッチ処理を実施し、
前日分の取引のステータスを確認して、状態が「要求成功」の取引については「期限切れ」に更新します。
バッチ処理の時刻は予告なく変更する場合があります。
| 判定タイミング | 更新前状態 | 更新後状態 |
|---|---|---|
| 毎日AM0:30頃 | 要求成功 | 期限切れ |
お客様への通知
決済時のお客様への通知は、初回決済と2回目以降で異なります。
初回決済のタイミングはWEBやアプリ側でリアルタイムで結果を確認できるため、通知は行われません。
初回決済の通知については都度決済のお客様への通知をご確認ください。
2回目以降の決済では、残高増減のタイミングで通知されます。
| 2回目以降の決済結果 | メール通知 | プッシュ通知 | 備考 |
|---|---|---|---|
| 決済成功 | ✔ | ✔ | |
| 決済失敗（残高不足） | ✔ | ✔ | |
| 決済失敗（その他／制限） | ✔ | ✖ | 利用制限額オーバー、利用制限など |
その他留意事項
配送先情報の扱い
随時決済はお客様操作を伴わないため、メルペイ側からお客様の配送先情報は取得できません。
配送先情報が必要な場合は、利用承諾取得時または都度決済＋利用承諾時に取得してください。
利用承諾時の配送先情報は以下の方法で参照できます
- プロトコルタイプ：個人情報参照（
MerpaySearchPersonalData）API - 管理画面のサイドメニュー→メルペイ→利用承諾検索タブ
配送先情報の参照は、個人情報利用契約が締結済の加盟店様のみが利用可能です。 ※エンドお客様との？
支払い可否事前確認
支払い可否事前確認MerpayPrePaymentCheck）APIを利用して、
お客様のサブスクリプションIDと指定金額に対する支払い可否を事前判定できます。
- このAPIで取得できるのは「API実行時点での支払可否判定」です。
判定結果はリアルタイムに変動するため、API実行後は速やかに決済処理を行ってください。
支払い可否事前確認MerpayPrePaymentCheck）APIはプロトコルタイプのみ提供しています。
OpenAPIタイプは対応していません。
お客様のメルペイ解約時の挙動
お客様がメルペイ側で解約操作を行った場合でも、当サービス上の取引状態は「利用承諾」のままとなります。
商品カテゴリID
商品カテゴリIDはメルペイの決済手段のひとつであるメルペイスマート払いとメルペイかんたん出品連携機能を利用するための必須パラメータです。
詳細はこちらを参照してください。
ロゴ画像
必ずロゴマーク利用ガイドラインをご確認の上ご利用ください。
メルペイにて適宜更新されますのでご留意ください。