OricoPayment Plus

OricoPayment Plus 決済結果通知仕様書（Simple Web）
OricoPayment Plus
決済結果通知仕様書（Simple Web）
OricoPayment Plus 決済結果通知仕様書
目次
1. 結果通知受信処理
1-1 結果通知について
1-2 結果通知電文仕様
・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・3
・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・3
・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・3
・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・4
1-3 結果通知受信後の応答仕様・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・5
1-4 結果通知速報と確報
・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・5
1-5 結果通知受信後の応答仕様・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・8
-2-
OricoPayment Plus 決済結果通知仕様書
1.結果通知受信処理
1.結果通知受信処理
1-1 結果通知について
結果通知について
下記一覧サービスにおいて、OricoPayment Plus から貴社へ決済結果、または OricoPayment Plus における取引のステータスの
変化を送信（PUSH）することが可能です。結果通知には、以下の種類があります。
・入金通知：消費者の支払完了通知（消費者が支払ったことを通知するものとなります）
・返金通知：消費者への返金完了通知（消費者が返金されたものを受け取ったことを通知するものとなります）
・決済結果通知：各種決済の成功・失敗の結果通知（消費者が決済に成功または失敗したことを通知するものとなります）
結果通知の送信は HTTP の POST メソッドを使用して行います。結果通知を受信するには、事前に弊社に店舗指定 URL（通知
情報受付 URL）を登録する必要があります。また、受信部分は貴社側にて開発・組み込んでいただく必要があります（受信機能は
MDK 内に用意しておりません）。
※プロトコルは
プロトコルは HTTP（
HTTP（Port：
Port：80）、
80）、HTTPS
）、HTTPS（
HTTPS（Port：
Port：443）
443）に対応しております
対応しております。
しております。これ以外
これ以外の
以外のプロトコル・
プロトコル・ポートの
ポートの組み合わせには
対応しておりません
対応しておりません
結果通知対象サービス一覧
決済サービス
決済サービス名
サービス名
与信
売上・
売上・入金
キャンセル
返金
継続課金終了
クレジットカード決済
－
－
－
－
－
MPI ホスティング
－
－
－
－
－
－
－
－
コンビニ決済
電子マネー決済
銀行決済
銀聯ネット決済（UPOP）
PayPal 決済
Alipay 決済
キャリア決済
ショッピング（Web）クレジット
決済
－
－
－
○
入金通知
○
入金通知
○
入金通知
－
－
○
返金通知
－
○
○
○
○
決済結果通知
決済結果通知
決済結果通知
決済結果通知
－
○
決済結果通知
○ ※1
○ ※2
○
入金通知
－
○
返金通知
－
－
－
－
○
－
－
（返金申込）
－
決済結果通知
－
－
－
－
－
－
○ ※1
（3 者間のみ）
－
■入金通知、返金通知については、入金/返金のあったデータのみが送信されます。支払/受取期限切れのものは対象外となります。
■銀聯ネット決済（UPOP）の決済結果通知は、成功(success)、失敗（failure）取引が全て結果通知対象となります。
■Alipay 決済においては、与信時の決済結果（成功・失敗）を結果通知データとして OricoPayment Plus から貴社へ送信します。
また、返金申込が失敗となった場合の決済結果、および返金自体の処理結果（成功・失敗）についても結果通知データとして
OricoPayment Plus から貴社へ送信します。
※
1：キャリア決済の結果通知の種類については、【キャリア決済サービス補足資料】を参照してください。
また、
また、キャリア決済
キャリア決済における
決済における結果通知受信処理
における結果通知受信処理については
結果通知受信処理については、
については、他の決済サービス
決済サービスと
サービスと一部考え
一部考え方が異なりますので、
なりますので、必ずしも消費者
ずしも消費者の
消費者の
入金を
入金を示す通知電文ではないことを
通知電文ではないことをご
ではないことをご注意ください
注意ください。
ください。
-3-
OricoPayment Plus 決済結果通知仕様書
※2：ショッピングクレジット決済においては、ショッピングクレジット申込の審査結果を結果通知電文として PUSH 送信します。
OricoPayment Plus は、Orico Web クレジットから審査結果電文を受信後、貴社へ PUSH 送信します。
ショッピングクレジット決済
ショッピングクレジット決済における
決済における結果通知受信処理
における結果通知受信処理については
結果通知受信処理については、
については、他の決済サービス
決済サービスと
サービスと一部考え
一部考え方が異なります。
なります。消費者の
消費者の入金を
入金を
示す通知電文ではなく
通知電文ではなく、
ではなく、ショッピングクレジット申込
ショッピングクレジット申込の
申込の審査結果通知であることにご
審査結果通知であることにご注意
であることにご注意ください
注意ください。
ください。
結果通知を HTTPS での受信を希望される場合は、店舗側設置サーバにて SSL 通信環境をご用意ください。SSL 証明書は認証局
発行のもの、または自己署名（Self-Sign）されたものをご使用ください。
※自己署名の
自己署名の場合、
場合、証明書内の
証明書内の Common Name（
Name（FQDN）
FQDN）はインターネットから
インターネットから検索可能
から検索可能な
検索可能な DNS 上に存在するものにしてください
存在するものにしてください。
するものにしてください。
弊社からの
弊社からの接続時
からの接続時、
接続時、証明書チェック
証明書チェックで
チェックでエラー扱
エラー扱いとなり結果
いとなり結果通知
結果通知データ
通知データの
データの送信が
送信が中止されます
中止されます。
されます。
1-2 結果通知電文仕様
下記が POST 時の HTTP ヘッダーになります。
Message = POST PATH HTTP/1.0 <CRLF>
contentの値 <CRLF>
content-hmac:HMAC
hmac
contentcontent-length:
length digits <CRLF>
user-agent:
host:
accept:
connection:
content-type: application/x-www-form-urlencoded <CRLF>
<CRLF>
MessageBody
HTTP Protocol の POST メソッドを使用します。
本ドキュメントで規定しない部分については RFC1945, RFC2616 に準ずるものとします。
結果通知電文は下記の通りです。
構成要素
説明
PATH
接続先を示す文字列
content-hmac
改竄チェック用情報
content-length
BODY 長
MessageBody
結果通知データ部分
表 0-1 結果通知構成一覧
MessageBody 部は下記の書式になります。
電文構成要素 1=[値 1]&電文構成要素 2=[値 2]&電文構成要素 3=[値 3]&･･･
各項目の詳細は「1-5 結果通知電文」を参照ください。
以下 MessageBody 部の例になります。
-4-
OricoPayment Plus 決済結果通知仕様書
numberOfNotify=2&pushTime=20100630172650&pushId=00000237&fixed=1&orderId0000=cup_2010063016475
8303&txnType0000=capture&amount0000=100&issBin0000=&settleDate0000=0630&settleRate0000=&traceN
um0000=001403&systemDatetimeCn0000=20100630+15%3A49%3A17&dummy0000=1&orderId0001=cup_20100
630164758303&txnType0001=refund&amount0001=100&issBin0001=&settleDate0001=0630&settleRate0001=
&traceNum0001=001404&systemDatetimeCn0001=20100630+15%3A49%3A53&dummy0001=1
1-3 結果通知受信後
結果通知受信後の
通知受信後の応答仕様
HTTP プロトコルのレスポンスメッセージの書式に準じて応答してください。200 OK を応答してください。
※200 OK 以外の
以外のステータス、
ステータス、またはサーバ
またはサーバから
サーバから応答
から応答がない
応答がない場合
がない場合は
場合は、通知エラー
通知エラーとして
エラーとして処理
として処理され
処理され、
され、一定の
一定の間隔（
間隔（1～10 分間隔、
分間隔、
最長 8 時間）
時間）で再送され
再送され続
され続けます。
けます。受信できなかった
受信できなかった取引
できなかった取引の
取引のステータス確認
ステータス確認には
確認には、
には、MAP または Search 機能をご
機能をご利用
をご利用ください
利用ください。
ください。
1-4 結果通知速報と
結果通知速報と確報
一部のサービスの結果通知においては、「速報」と「確報」の概念があります。
速報：OricoPayment
Plus は、決済要求電文を決済センターに送信し、決済センターから成功応答電文を受信した後に、店舗側
速報
へ決済成功の速報を通知します。（ただし、インターネット通信障害による保留取引や、決済センター側の事情により取引の
ステータスがコミットできないケースがありますので、このタイミングの結果通知は、あくまでも速報連絡となります）
また、OricoPayment Plus は、各決済センターより消費者の入金完了情報、消費者への返金完了情報を受信したのちに、
店舗側へ入金完了／返金完了を通知します。
確報：OricoPayment
Plus は、決済センター側から取引の最終ステータスを受信し、OricoPayment Plus のデータベース上で取引の
確報
最終ステータスを作成した後に、店舗側へ決済の確報を通知します。（この時点で取引のステータスが確定されているため、
商品の配送処理も開始できます）
サービス毎の速報・確報一覧は次の表をご参考ください。
結果通知構成一覧
決済サービス
決済サービス名
サービス名
速報通
知機能
確報通
通知タイミング
通知タイミング
知機能
通知タイミング
通知タイミング
通知情報
受付 URL (*1)
クレジットカード決済
－
－
－
－
－
MPI ホスティング
－
－
－
－
－
－
－
－
－
コンビニ決済センターから入金完
コンビニ決済
○
了情報（消費者の支払完了情
報）を受信した後 (*2)
電子マネー決済センターから入金
電子マネー決済
○
／返金完了情報（消費者の支
払完了情報／消費者への返金
知します
銀行決済センターから入金完了
銀行決済
○
情報（消費者の支払完了情報）
結果情報は店舗
側受付 URL へ通
完了情報）を受信した後 (*2)
－
－
を受信した後 (*2)
銀聯ネット決済
（UPOP）
銀聯決済センター側の決済の成
○
功・失敗のステータスが判明した
△
時点 (*3)
PayPal 決済センターから入金／
PayPal 決済
○
返金完了情報（消費者の支払
完了情報／消費者への返金完
-5-
○
銀聯決済センターとステータスがこ
となる際のみ訂正報を通知 (*4)
PayPal 決済センターから売上明
速報情報と確報
細ファイルを受信し、弊社側で取
情報は別々の受
引ステータスをマージした後 (基
付 URL へ通知する
OricoPayment Plus 決済結果通知仕様書
本的に速報の翌日となります
了情報）を受信した後
事が可能です
(*5)
(*5) )
Alipay 決済センター側の決済の
Alipay 決済
○
成功・失敗ステータスが判明した
Alipay 決済センターとステータスが
－
時点で行います。(*6)
(*6) (*7)
キャリア決済
ショッピングクレジット
決済
ことなる際のみ訂正報を通知致
します。(*8)
(*8)
(*9)
(*9)
(*10)
(*10)
決済結果は店舗
側受付 URL へ通
知します
(*1) 通知情報受付 URL は、貴社側にて用意した、OricoPayment Plus からの結果通知情報を受け取るための URL となります。
(*2) コンビニ決済、電子マネー決済、銀行決済の場合は、速報を確定情報と見なすため、結果通知を一回のみ送信します。
この時点の通知情報を、売上の確定情報とし、配送処理などもこのタイミングで行ってください。
(*3) 通常ケースでは、OricoPayment Plus は決済ステータス判明後の 5 分以内に、加盟店様へ速報を通知します。一部の特殊
取引（ネットワーク通信問題などによって、銀聯側のステータスが判断できないもの等）は、翌日に行われる銀聯センターと Orico
Payment Plus とのマッチング処理にてステータスが判明します。ステータス判明後 OricoPayment Plus より貴社へ決済結果を
通知します。この場合の決済結果通知の送信は翌日中に行われます。
消費者側の都合で UPOP のブラウザ画面を閉じるケースもあるため、一部の決済結果は加盟店まで遷移しない事も想定されま
す。そのようなケースでは、加盟店様は最後の決済結果が分からないため、確報通知機能を利用して OricoPayment Plus からの
結果通知を受け取る事を強く推奨します。
(*4) 取引の翌日に銀聯から届く精算データと OricoPayment Plus の取引データを比較し、差異が発生した場合のみ通知します。
(*5) 消費者から異議申立てを受けた取引等については、数日後～数十日後に確報を通知する場合があります。
(*6) 与信時の決済結果（成功・失敗）、および返金申込みが失敗となっ場合の決済結果については、決済ステータス判明後の 5 分
以内に、貴社へ速報を通知します。
(*7) Alipay 決済センターでの返金自体の処理は、返金申込みを行った翌日以降となります。返金自体の処理結果（成功・失敗）が
判明した後に、結果通知データを店舗へ通知します。
(*8) 取引の翌日に Alipay から届く精算データと弊社の取引データを比較し、差異が発生した場合のみ通知します。
(*9) キャリア決済における結果通知受信処理については、速報・確報の概念はありません。ただし、一部のキャリアについては、障害
時に取消電文が送信されるケースがあります。キャリア決済の結果通知電文の通知タイミングについては、【キャリア決済サービス
補足資料】を参照してください。
(*10) ショッピングクレジット決済における結果通知受信処理については、速報・確報の概念はありません。審査結果通知は、1 件
ごとにリアルタイムで通知されます。
結果通知電文の項目の詳細や、速報・確報フラグの説明は「1-5 結果通知電文」をご参照ください。
-6-
OricoPayment Plus 決済結果通知仕様書
電文サンプル
カード与信処理成功の応答電文サンプルです。
（以下の例では、レイアウトの都合上改行・インデントを入れ、一部省略しています。）
<?xml version="1.0" encoding="UTF-8"?>
<GWPaymentResponseDto>
<result>
<VResultCode>A001000000000000</VResultCode>
<custTxn>10492</custTxn>
<exresult>
<cardTransactiontype>a</cardTransactiontype>
<centerReferenceNumber/>
<centerRequestDate>20091112191705</centerRequestDate>
<centerRequestNumber/>
<centerResponseDate>20091112191706</centerResponseDate>
<connectedCenterId>sln</connectedCenterId>
<gatewayRequestDate>20091112191705</gatewayRequestDate>
<gatewayResponseDate>20091112191706</gatewayResponseDate>
～～～～～～～省略～～～～～～～
<loopback>0</loopback>
<pending>0</pending>
<reqAcquirerCode/>
<resCenterErrorCode>
</resCenterErrorCode>
<resItemCode/>
<resMerchantTransaction/>
<resResponseData>
</resResponseData>
<resReturnReferenceNumber/>
</exresult>
<marchTxn>10492</marchTxn>
<merrMsg>処理が成功しました。</merrMsg>
<mstatus>success</mstatus>
<optionResults/>
<orderId>1258021034451</orderId>
<serviceType>card</serviceType>
<txnVersion>5.0</txnVersion>
</result>
</GWPaymentResponseDto>
-7-
OricoPayment Plus 決済結果通知仕様書
1-5 結果通知電文
結果通知電文
■機能概要
特定のサービスにおいて、消費者が支払を完了させた、消費者への返金が完了した、または各種決済の成功・失敗の結果が
判明した場合等に、OricoPayment Plus から貴社へ結果通知を行います。通知は、HTTP の POST で実施します。
※プロトコルは
プロトコルは HTTP（
HTTP（Port：
Port：80）、
80）、HTTPS
）、HTTPS（
HTTPS（Port：
Port：443）
443）に対応しております
対応しております。
しております。
■HMAC について
POST にてデータを通知するとき、リクエストヘッダーに HMAC を設定します。また、HMAC 値は、リクエストボディから算出します。
アルゴリズムは「HmacSHA256」が設定されます。
フィールド名
設定値
content-hmac
h={アルゴリズム名};s={CCID};v={HMAC 値}
■結果通知受信処理の結果について
OricoPayment Plus からの結果通知に対して貴社側が HTTP ステータスコード"200"を返戻した場合、OricoPayment Plus は貴社
での受信処理が正常に終了したものと判断します。貴社側より HTTP ステータスコード"200"以外のコードが返戻された場合は、受
信失敗と判断し、一定期間通知を繰り返します。
※規定の
規定の回数失敗した
回数失敗した場合
した場合は
場合は、通知処理が
通知処理が停止しますのでご
停止しますのでご注意
しますのでご注意ください
注意ください。
ください。
-8-

Download Report