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