申込

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

取消

売上

返金

再与信

解約

検索

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

  要求電文 ...

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

  応答電文 ...

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

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

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

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

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

結果通知電文の概要

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

• 機能概要

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

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

• HMACについて

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

  フィールド名	設定値
  content-hmac	h={アルゴリズム名};s={CCID};v={HMAC値}

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

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

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

  ※ 決済サーバー側で"200"のコードを受信できなかった場合には、通知を繰り返すことがあります。
  同じ通知が複数回届いた場合でも受信処理が正常に行われるように実装してください。

結果通知のタイミングと項目について

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

• メルペイ側で決済申込みが成立し、決済サーバーがメルペイからの通知を受信したタイミングとなります。
• メルペイ側で取引の抹消が行われ、日次バッチにより「抹消」のステータスを確認したタイミングとなります。

消費者が画面遷移の途中で離脱した場合や、通信環境の問題で画面遷移時にタイムアウトが発生した場合には、最終遷移先の完了画面URLまで到達しない場合がありますので、このような場合にも、決済サーバーからの通知を店舗側システムで受信して頂くことで、決済が成立したことを検知することができます。

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

※1 「MerpayAuthorizeRequestDto」の項目「useBuyerInfo」にtrueを設定した場合に通知します。

※2 「MerpayAuthorizeRequestDto」の項目「useDeliveryAddress」にtrueを設定した場合に通知します。

決済金額について

ユーザの決済可能な金額は、お支払用口座およびメルカリアプリの本人確認登録状態などにより異なります。 詳細はメルペイアプリのガイドをご確認ください。

返金について

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

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

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

• 部分返金

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

  ※部分返金は複数回の実施が可能となっております。
  なお、残高を超えた返金を実施した際には詳細結果コード「KC02」が返却されます。

売上について

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

• 部分売上

  部分売上については、与信金額を超えない範囲で、売上金額を指定できます。

  ※部分売上は1回のみ実施可能となっておりますので、ご利用の際はご注意ください。
  なお、本番決済で2回目以降実施した際には詳細結果コード「KC01」が返却されます。

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

メルペイサービスにおける、各処理の要求可能期間を下表に示します。

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

決済申込応答受領後「20分以内」に、消費者をメルペイの決済画面に遷移させて支払い手続きを完了させる必要があります。
時間制限を超えた場合、消費者による支払い手続きは完了できませんので、決済申込処理を最初からやり直していただくようご案内ください。

個人情報（配送先情報・購入者情報）の要求について

メルペイより個人情報の提供を受けることができます。
取得できる個人情報は申込み時の審査で承認された項目のみとなります。
また、加盟店様が個人情報を受け取るには、ユーザがメルカリアプリで個人情報を提供することに同意する必要があり、 個人情報の提供の同意が行われない場合は、メルカリアプリよりキャンセル処理が行われ、MerpayAuthorizeRequestDtoで指定されたcancelUrlへリダイレクトされます。

※個人情報は決済申込の結果通知電文でのみ通知いたします。
結果通知受信に失敗した場合は、個人情報を取得できませんので、ご注意ください。
（結果通知電文は「5-3結果通知電文」を参照）

• 配送先情報

  配送先情報フラグ(useDeliveryAddress)を設定することにより、決済処理時にメルペイより配送先情報の提供を受けることができます。これによってユーザはシームレスに商品の注文を行うことができます。

• 購入者情報

  購入者情報フラグ(useBuyerInfo)を設定することにより、決済処理時にメルペイより購入者情報の提供を受けることができます。

商品カテゴリID一覧

カテゴリIDへ入力する一覧となります。
カテゴリIDは決済手段のメルペイスマート払いを利用するために必要な情報となる為、適切に設定してください。
金融庁のガイドラインでは、メルペイスマート払いを利用する場合は、その商品がどういった商品カテゴリ（衣類、コスメ、食品等々）であるかを、明示することを求めています。
なお、メルペイスマート払いは消費者が選択可能な決済手段で、利用不可とすることはできません。

【スマートフォンブラウザ】決済処理開始時と完了時でのブラウザの違いによる問題

消費者様がスマートフォンブラウザからECサイトを利用する場合、決済処理でメルカリアプリを経由することで、処理開始と完了時でのブラウザが異なる可能性があります。
現在のメルペイの仕様上、Chromeで処理を開始した場合に限り、申込時にuserAgentを指定すれば完了時にもChromeに戻すことができますが、Chrome以外のブラウザの場合は、完了時に異なるブラウザに戻る可能性があります。
問題の詳細については以下のメルペイ仕様書の内容をご参照ください。

https://netpayment.merpay.com/partner/integration-guideline/#/partner_order_completion?id=決済開始時と完了時でのブラウザの違いによる問題

ID：mp6822263272
PASS：3R(qc&gFwNMp

このような問題に対しても弊社決済サーバーからブラウザを経由して連携する決済結果を受け取り、正常に処理できるように実装してください。

【スマートフォンアプリ(加盟店アプリ)】メルカリアプリ起動について

スマートフォンアプリ（以後、加盟店アプリと呼びます）を起点とした決済でメルカリアプリを起動するためには、各OS（iOS, Android）が提供するAPIを利用してpaymentUrlを開いてください。paymentUrlは、iOSの Universal Links、Androidの App Links として登録されています。
各OSの実装方法に応じた注意点がメルペイ仕様書に説明されていますので、内容をご参照ください。

https://netpayment.merpay.com/partner/integration-guideline/#/payment_on_smartphone_app

ID：mp6822263272 PASS：3R(qc&gFwNMp

【スマートフォンアプリ(加盟店アプリ)】決済後の加盟店アプリ起動について

メルカリアプリでの決済完了後、消費者導線を加盟店アプリに戻したい場合にディープリンク連携による遷移を行ってください。
ディープリンクとはHTTP/HTTPSのURLをアプリ側と紐付けることで、通常はブラウザでWebページが開かれる所をアプリ起動への置き換えが可能な機能です。

申込要求電文（MerpayAuthorizeRequestDto）の決済成功URL（successUrl）、決済キャンセルURL（cancelUrl）で指定可能なURLの接頭辞は"http(s)"となるため、"http(s)"以外のURLで加盟店アプリを起動する場合には、別途、加盟店アプリを起動するランディングページを作成して、この時の決済成功/決済キャンセルのURLに作成したランディングページのURLを指定してください。この時のランディングページは消費者環境の「標準ブラウザ」で表示されます。

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

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

• 起動時のURLスキーム　：　merpaysample
• 起動時の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 = "merpaysample://www.example.com/result";
</SCRIPT>
<BODY>
○○アプリを起動します。
</BODY>
</HTML>

決済内容確認画面の決済結果選択について

決済内容確認画面では、決済センターおよび決済サーバーの状態を疑似環境で再現させることができます。

• 成功

  決済が正常に終了するパターンとなります。

• みなし成功（メルカリからの結果通知を受信しない）

  メルカリからの決済結果通知を受信できていない場合に「みなし成功」として応答するパターンとなります。

  ※MAP（Merchant Administration Portal）もしくは検索コマンドにて決済状態をご確認ください。（このパターンは、最終ステータスが成功となるシミュレーションとなります。）

• みなし成功（決済確定処理でエラー）

  メルカリで決済処理が成功 かつ 決済サーバーの決済確定処理が失敗した場合に「みなし成功」として応答するパターンとなります。

  ※MAP（Merchant Administration Portal）もしくは検索コマンドにて決済状態をご確認ください。（このパターンは、最終ステータスが失敗となるシミュレーションとなります。）

• 失敗(リダイレクトでエラー※結果通知は成功)

  決済は正常に終了しているが、決済申込で指定したURLへの応答に失敗し、システムエラーを表示するパターンとなります。

決済申込・取消・売上・返金・再与信・解約のエラーをシミュレートする

Authorizeコマンドの要求金額（"amount"）、Captureコマンドの売上金額（"amount"）、Refundコマンドの返金金額（"amount"）、ReAuthorize("amount")の下一桁の値を調整することで、意図的にエラーを発生させることができます。（Captureコマンド、Refundコマンド、Terminateコマンドの金額未設定はAuthorizeコマンドリクエスト時の要求金額で判定されます。）

• Terminate（解約）のエラーにつきましては、Authorizeコマンドリクエスト時の要求金額を指定できる「承諾時同時決済(consentAuthTypeへ"1"を設定)」でリクエストした場合にシュミレート可能です。
• 返戻されるエラーコード（vResultCode）につきましては、今後、予告なしに変更させて頂く場合がございます。