申込

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

取消

売上

返金

再与信

解約

検索

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

  要求電文 ...

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

  応答電文 ...

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

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

  例）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」が返却されます。

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

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

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

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

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

• 配送先情報

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

• 購入者情報

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

商品カテゴリID一覧

カテゴリIDへ入力する一覧となります。

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

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

• 成功

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

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

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

  ※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）につきましては、今後、予告なしに変更させて頂く場合がございます。