重要 こ れ ら のサ ンプルは、 開発のための参考用です。 リ ク エ ス ト やサン プルには、 必 須フ ィ ール ド を省略 し てい る 場合が ご ざい ます。 こ れ ら のサ ン プルをベー ス に開発を
し ない よ う に し て く だ さ い。
シ ン プル API
シ ン プルAPIを利用 し た本人認証サービ ス の リ ク エ ス ト と リ プ ラ イ の例です。
名前 / 値ペア
名前/値ペア を使っ た ト ラ ンザ ク シ ョ ンの リ ク エ ス ト と リ プ ラ イ の例です。
登録確認 リ ク エ ス ト
payerAuthEnrollService を リ ク エ ス ト し て、 ユーザが本人認証プ ロ グ ラ ム に登録 し てい
る か ど う か を確認 し ます。
登録確認 リ プ ラ イ （登録あ り ）
ユーザが本人認証プ ロ グ ラ ム に登録 し てい る 場合には、カー ド の種類にかかわ ら ず、同 様の リ プ ラ イ が返 り ます。
登録確認 リ プ ラ イ （登録な し ）
ユーザが本人認証プ ロ グ ラ ム に登録 し ていない場合や発行会社が本人認証プ ロ グ ラ ム に参加 し ていない場合には、 次の処理に進む こ と がで き る と い う リ プ ラ イ が返 り ます。
payerAuthEnrollService_run=true merchantID=infodev
merchantReferenceCode=23AEE8CB6B62EE2AF07 item_0_unitPrice=2100
purchaseTotals_currency=JPY card_expirationMonth=12 card_expirationYear=2015
card_accountNumber=4xxxxxxxxxxxxxxx card_cardType=001
payerAuthEnrollReply_acsURL=https://www.example.com
payerAuthEnrollReply_paReq=eJxVUctuwjAQ/BXEtVK8TmICaLEEQRUcQLS g9ohcY0po4wQnaeDvawdS6G1mX7M7i5uDUWq6VrIyiuNCFYX4VJ1kN+qe9ynbBlvw aAisz7ocV+NXdeL4o0yRZJpTDzwfSUtts5EHoUuOQp4m8yVnfjQAQHKjmCozn...
payerAuthEnrollReply_proofXML=ProofXMLのサン プルを参照 し て く だ さ い decision=REJECT
payerAuthEnrollReply_xid=fmICaHVHT5+Q/snWFkCyNwMBBAc=
reasonCode=475
payerAuthEnrollReply_reasonCode=475
payerAuthEnrollReply_proxyPAN=2794758864430691 requestID=1798874597540176177163
requestToken=AGYJYYRmY53f+agLBAIGALwe+Gy8YwAV merchantReferenceCode=23AEE8CB6B62EE2AF07
リ ク エ ス ト と リ プ ラ イのサン プル
（詳細についてはリ プ ラ イの解釈を参照 し て く だ さ い） こ の ま ま与信に進む こ と も で き ます。
Visa認証サービ ス
MasterCard SecureCode
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
J/Secure
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
検証 リ ク エ ス ト
payerAuthValidateService を リ ク エ ス ト し て、 本人認証が有効に行われた こ と を確認 し 、
与信に添付すべ き 情報を得ます。
検証 リ プ ラ イ （本人認証成功）
PARes の解析の結果、 本人認証に成功 し た場合には、 与信に添付すべ き 情報が返 さ れ
ます。 赤字部分は、 カー ド の種類に よ り 異な り ます。
payerAuthEnrollReply_proofXML=ProofXMLのサン プルを参照 し て く だ さ い decision=ACCEPT
reasonCode=100
payerAuthEnrollReply_reasonCode=100
payerAuthEnrollReply_commerceIndicator=vbv_attempted payerAuthEnrollReply_eci=06
requestID=1798830145930176174593
requestToken=AGYJYYPIdxzoOxoBBAEFMr/v7XgAPzwC merchantReferenceCode=23AEE8CB6B62EE2AF07
payerAuthEnrollReply_ucafCollectionIndicator=1 payerAuthEnrollReply_commerceIndicator=spa
payerAuthEnrollReply_commerceIndicator=js_attempted payerAuthEnrollReply_eci=06
payerAuthValidateService_run=true merchantID=infodev
merchantReferenceCode=23AEE8CB6B62EE2AF07 card_expirationMonth=12
card_expirationYear=2015
card_accountNumber=xxxxxxxxxxxxxxxx card_cardType=001
purchaseTotals_currency=JPY
payerAuthValidateService_signedPARes=AiK4fsDtvne0JNuv536ZFrTMQX9P DlNfk7fup6rx+6N+cEfXs6Bd44vglD3VtqcYgHgT0yV3llPKrNaQah4G2t7yanKHi +vRy9r+PAnlctc8+Kd7gD5ufwAl6hQK9VPtdN8quE3WRnMRV52X9M+r7+AkHTNH2e sM9VG0NbwDAEk9BmEG4F8efH6OikC8f1b81jPbKqnwGXv5...
Visa認証サービ ス
検証 リ プ ラ イ （本人認証失敗）
PARes の解析の結果、 本人認証が成功 し なか っ た場合には、 与信に進む こ と は認め ら
れてい ません。
MasterCard SecureCode
検証 リ プ ラ イ （Attempt）
PAResの解析の結果、Attemptの場合には、与信に添付すべ き 情報が返 さ れ ます。Attempt
についてはApppendix A チ ャ ージバ ッ ク 保護の概要を参照 し て く だ さ い。
requestID=0348277000000167904548
requestToken=AGYJYYYRgnP8JrgDBAIFfUEv+wEA0n3Y merchantReferenceCode=23AEE8CB6B62EE2AF07 decision=ACCEPT
reasonCode=100
purchaseTotals_currency=JPY
payerAuthValidateReply_reasonCode=100
payerAuthValidateReply_authenticationResult=0
payerAuthValidateReply_authenticationStatusMessage=Success payerAuthValidateReply_cavv=KuptWQm6guKE7DJNzDaBrlCD1B0=
payerAuthValidateReply_commerceIndicator=vbv payerAuthValidateReply_eci=05
payerAuthValidateReply_xid=dOaE6u0nNpCBQHzAebKyADw4aQE=
payerAuthValidateReply_authenticationResult=9 decision=REJECT
reasonCode=476
payerAuthValidateReply_reasonCode=476
payerAuthValidateReply_authenticationStatusMessage=User failed authentication
payerAuthValidateReply_eciRaw=
requestID=1798994821260176177155
requestToken=AGYJYYYRgnP8JrgDBAIFfUEv+wEA0n3Y merchantReferenceCode=23AEE8CB6B62EE2AF07
リ ク エ ス ト と リ プ ラ イのサン プル
J/Secure
ク レ ジ ッ ト カ ー ド 決済 与信 リ ク エ ス ト （認証成功）
チ ャ ージバ ッ ク 保護を受け る ためには、 本人認証の結果が与信に正 し く 追加 さ れ る こ と が必要です。
本人認証サービ ス 検証 と ク レ ジ ッ ト カー ド 決済与信を同時に リ ク エ ス ト し た場合、 本 人認証に成功 し てい る と 、 与信に必要な情報が自動で受け渡 さ れ ますが、 別々に呼び 出す場合には、 こ のサン プルの よ う に必要な情報を与信に追加す る 必要があ り ます。
与信に関す る 情報は、 「 ク レ ジ ッ ト カー ド 決済サービ ス導入ガ イ ド 」 を参照 し て く だ さ い。
Visa認証サービ ス
payerAuthValidateReply_authenticationResult=1
payerAuthValidateReply_xid=QKr35l+cQVqfEdxpvpH7iQcFAAA=
decision=ACCEPT
payerAuthValidateReply_commerceIndicator=js_attempted payerAuthValidateReply_eci=06
payerAuthValidateReply_reasonCode=100
payerAuthValidateReply_authenticationStatusMessage=Success payerAuthValidateReply_cavv=BwABBGh3YFNxKIMxMHdgAAAAAAA=
payerAuthValidateReply_eciRaw=06 reasonCode=100
requestID=1799002761540176177166
requestToken=AGYJYYYtuBh89+gOBAcGAMfCq6RM/SlB merchantReferenceCode=23AEE8CB6B62EE2AF07
ccAuthService_run=true billTo_firstName=ス テ フ ァ ニー billTo_lastName=南
[email protected] merchantID=infodev
merchantReferenceCode=482046C3A7E94F5 item_0_unitPrice=5100
purchaseTotals_currency=JPY card_expirationMonth=12 card_expirationYear=2015
card_accountNumber=4xxxxxxxxxxxxxxx card_cardType=001
ccAuthService_commerceIndicator=vbv ccAuthService_eciRaw=05
ccAuthService_xid=KuptWQm6guKE7DJNzDaBrlCD1B0=
ccAuthService_cavv=dOaE6u0nNpCBQHzAebKyADw4aQE=
MasterCard SecureCode
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
J/Secure
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
ク レ ジ ッ ト カ ー ド 決済 与信 リ ク エ ス ト （Attempt）
検証 と 与信を同時に リ ク エ ス ト し た場合、 結果が Attempt だ と 与信に必要な情報が自 動で受け渡 さ れ ますが、 別々に呼び出す場合には、 こ のサ ン プルの よ う に必要な情報 を与信に追加す る 必要があ り ます。
Visa認証サービ ス
ccAuthService_commerceIndicator=spa ccAuthService_eciRaw=02
ccAuthService_xid=rpkD6PozSzedXDLBQ1/csQMBBAc=
ucaf_authenticationData=jJjG+nSaD+tXARAAMIlLXt6IJ1c=
ucaf_collectionIndicator=2
ccAuthService_commerceIndicator=js ccAuthService_eciRaw=05
ccAuthService_xid=KuptWQm6guKE7DJNzDaBrlCD1B0=
ccAuthService_cavv=QKr35l+cQVqfEdxpvpH7iQcFAAA=
ccAuthService_run=true billTo_firstName=ス テ フ ァ ニー billTo_lastName=南
[email protected] merchantID=infodev
merchantReferenceCode=48205589A7E94F5 item_0_unitPrice=4500
purchaseTotals_currency=JPY card_expirationMonth=12 card_expirationYear=2015
card_accountNumber=4xxxxxxxxxxxxxxx card_cardType=001
ccAuthService_commerceIndicator=vbv_attempted ccAuthService_eciRaw=06
ccAuthService_xid=Jb646G+RKuhgHWGmK79VQkJAAI=
ccAuthService_cavv=BwABATQ2BGlEhzUIdTYEAAAAAAA=
リ ク エ ス ト と リ プ ラ イのサン プル
J/Secure
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
ク レ ジ ッ ト カ ー ド 決済 与信 リ ク エ ス ト （登録な し ）
加盟店契約の内容に よ っ ては、 ユーザ未登録の場合で も 、 本人認証の結果を与信に添 付す る こ と でチ ャ ージバ ッ ク 保護を受け る こ と が可能です。 詳細は登録な し の場合に チ ャ ージバ ッ ク 保護を受け るを参照 し て く だ さ い。
Visa認証サービ ス
MasterCard SecureCode
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
J/Secure
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
ccAuthService_commerceIndicator=js_attempted ccAuthService_eciRaw=06
ccAuthService_xid=4vlsiUylT3aJqmazzoRwGAcFAAA=
ccAuthService_cavv=BwABCXkUgUkoOWmUZBSBAAAAAAA=
ccAuthService_run=true billTo_firstName=ス テ フ ァ ニー billTo_lastName=南
[email protected] merchantID=infodev
merchantReferenceCode=482046C3A7E94F5 item_0_unitPrice=4995
purchaseTotals_currency=JPY card_expirationMonth=12 card_expirationYear=2015
card_accountNumber=4xxxxxxxxxxxxxxx card_cardType=001
ccAuthService_commerceIndicator=vbv_attempted ccAuthService_eciRaw=06
ccAuthService_commerceIndicator=spa ccAuthService_eciRaw=06
ucaf_collectionIndicator=1
ccAuthService_commerceIndicator=js_attempted ccAuthService_eciRaw=06
XML
XMLを使っ た ト ラ ンザ ク シ ョ ン の リ ク エ ス ト と リ プ ラ イ の例です。
登録確認 リ ク エ ス ト
payerAuthEnrollService を リ ク エ ス ト し て、 ユーザが本人認証プ ロ グ ラ ム に登録 し てい
る か ど う か を確認 し ます。
<?xml version="1.0" encoding="utf-8"?>
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.24">
<merchantID>infodev</merchantID>
<merchantReferenceCode>23AEE8CB62AF07</merchantReferenceCode>
<item id="0">
<unitPrice>1999</unitPrice>
</item>
<purchaseTotals>
<currency>JPY</currency>
</purchaseTotals>
<card>
<accountNumber>xxxxxxxxxxxxxxxx</accountNumber>
<expirationMonth>12</expirationMonth>
<expirationYear>2015</expirationYear>
<cardType>001</cardType>
</card>
<payerAuthEnrollService run="true">
</payerAuthEnrollService>
</requestMessage>
リ ク エ ス ト と リ プ ラ イのサン プル
登録確認 リ プ ラ イ （登録あ り ）
ユーザが本人認証プ ロ グ ラ ムに登録 し てい る 場合には、カー ド の種類にかかわ ら ず、同 様の リ プ ラ イ が返 り ます。
登録確認 リ プ ラ イ （登録な し ）
ユーザが本人認証プ ロ グ ラ ム に登録 し ていない場合や発行会社が本人認証プ ロ グ ラ ム に参加 し ていない場合には、 次の処理に進む こ と がで き る と い う リ プ ラ イ が返 り ます。
（詳細についてはリ プ ラ イの解釈を参照 し て く だ さ い） こ の ま ま与信に進む こ と も で き ます。
Visa認証サービ ス
<?xml version="1.0" encoding="utf-8" standalone="no" ?>
<c:replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.24">
<c:merchantReferenceCode>23AEE8CB62AF07</c:merchantReferenceCode>
<c:requestID>1798963891480176177155</c:requestID>
<c:decision>REJECT</c:decision>
<c:reasonCode>475</c:reasonCode>
<c:requestToken>AGYJYYWjn/tmRTADBAEFfUEv4WUA9H9u</c:requestToken>
<c:payerAuthEnrollReply>
<c:reasonCode>475</c:reasonCode>
<c:acsURL>>https://www.example.com</c:acsURL>
<c:paReq>eJxVUe1ugjAUfRXjA9AWisBybYIaM7NscW4m+2e6eqc4KVhg6tuvR Znu3zn369x7LrxvDeLkDVVjUMAzVpXcYC9bD/nrzxcBSvqMc4HjPUFzNMFHgT8 mUc8H0lHbbNRW6lqAVIfR7EXwMOCUArlSyNHMJmIyQBRGEWU...</c:paReq>
<c:proxyPAN>2791964898574199</c:proxyPAN>
<c:xid>kXlPFFBoRUy88P9eg6hUKQABAgU=</c:xid>
<c:proofXML>ProofXMLのサン プルを参照 し て く だ さ い</c:proofXML>
</c:payerAuthEnrollReply>
</c:replyMessage>
<?xml version="1.0" encoding="utf-8" standalone="no" ?>
<c:replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.24">
<c:merchantReferenceCode>23AEE8CB62AF07</c:merchantReferenceCode>
<c:requestID>1798924859850176174594</c:requestID>
<c:decision>ACCEPT</c:decision>
<c:reasonCode>100</c:reasonCode>
<c:requestToken>AGYJYYUY9OvdHZoCBAEFObwV2LoAPBdg</c:requestToken>
<c:payerAuthEnrollReply>
<c:reasonCode>100</c:reasonCode>
<c:commerceIndicator>vbv_attempted</c:commerceIndicator>
<c:eci>06</c:eci>
<c:proofXML>ProofXMLのサン プルを参照 し て く だ さ い</c:proofXML>
</c:payerAuthEnrollReply>
</c:replyMessage>
MasterCard SecureCode
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
J/Secure
Visa認証サービ ス の リ プ ラ イ の赤字部分が以下の通 り と な り ます。（それ以外の部分は 共通です）
検証 リ ク エ ス ト
payerAuthValidateService を リ ク エ ス ト し て、 本人認証が有効に行われた こ と を確認 し 、
与信に添付すべ き 情報を得ます。
<c:payerAuthEnrollReply>
<c:reasonCode>100</c:reasonCode>
<c:commerceIndicator>spa</c:commerceIndicator>
<c:proofXML>ProofXMLのサン プルを参照 し て く だ さ い</c:proofXML>
<c:ucafCollectionIndicator>1</c:ucafCollectionIndicator>
</c:payerAuthEnrollReply>
<c:payerAuthEnrollReply>
<c:reasonCode>100</c:reasonCode>
<c:commerceIndicator>internet</c:commerceIndicator>
<c:eci>06</c:eci>
<c:proofXML>ProofXMLのサン プルを参照 し て く だ さ い</c:proofXML>
</c:payerAuthEnrollReply>
<?xml version="1.0" encoding="utf-8"?>
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.18">
<merchantID>infodev</merchantID>
<merchantReferenceCode>23A6B62EE2AF07</merchantReferenceCode>
<card>
<accountNumber>xxxxxxxxxxxxxxxx</accountNumber>
<expirationMonth>12</expirationMonth>
<expirationYear>2015</expirationYear>
</card>
<c:purchaseTotals>
<c:currency>JPY</c:currency>
</c:purchaseTotals>
<payerAuthValidateService run="true">
<signedPARes>AiK4fsDtvne0JNuv536rTMQX9PDlNfk7fup6rx+6N+cEfXs6B d44vglD3VtqcYgHgT0yV3llPKrNaQah4G2t7yanKHi+vRy9r+PAnlctc8+Kd7g QK9VPtdN8quE3WRnMRV52X9M+r7+esM9VG0Nbk9Bm4F8e...</signedPARes>
</payerAuthValidateService>
</requestMessage>
リ ク エ ス ト と リ プ ラ イのサン プル
検証 リ プ ラ イ （本人認証成功）
PARes の解析の結果、 本人認証に成功 し た場合には、 与信に添付すべ き 情報が返 さ れ
ます。 赤字の部分はカー ド の種類に よ り 異な り ます。
MasterCard SecureCode
検証 リ プ ラ イ （本人認証失敗）
PARes の解析の結果、 本人認証が成功 し なか っ た場合には、 与信に進む こ と は認め ら
れてい ません。
<?xml version="1.0" encoding="utf-8"?>
<c:replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.24">
<c:requestID>0687802329870167904150</c:requestID>
<c:merchantReferenceCode>14344</c:merchantReferenceCode>
<c:decision>ACCEPT</c:decision>
<c:reasonCode>100</c:reasonCode>
<c:requestToken>AGYJYZFryAAA/BoBBHEFMr/wdKwAI7s8</c:requestToken>
<c:payerAuthValidateReply>
<c:reasonCode>100</c:reasonCode>
<c:authenticationResult>0</c:authenticationResult>
<c:authenticationStatusMessage>Success
</c:authenticationStatusMessage>
<c:commerceIndicator>spa</c:commerceIndicator>
<c:eciRaw>02</c:eciRaw>
<c:xid>rpkD6PozSzedXDLBQ1/csQMBBAc=</c:xid>
<c:ucafAuthenticationData>jGCgOLutbHbJABEAAAH0jwKFF6I=
</c:ucafAuthenticationData>
<c:ucafCollectionIndicator>2</c:ucafCollectionIndicator>
</c:payerAuthValidateReply>
<c:purchaseTotals>
<c:currency>JPY</c:currency>
</c:purchaseTotals>
</c:replyMessage>