VCNキャンセル

当該機能は、VCN(Virtual Card Number)キャンセル機能です。
指定したリクエストの値に基づいてVCNキャンセルが可能です。

API情報

Service Action Code :CancelPrepayVirtualCard
最新バージョン :1.0.0

ご利用上の注意

SESSION=STARTで接続を確認後、VCN取得を行ってください。
SESSION=START-ENDは利用不可です。またSESSION=START時にVCN取得コマンドを
同時送信することは出来ません。

オプション項目を利用しない場合は、タグ自体を削除してください。

VCNキャンセル時に、引き落としていた与信金額が指定口座に戻ります。

Travelfusion社のレポートサイトにて、取得データについての確認・およびVCNキャンセルが可能です。
詳細はこちら

更新履歴

CancelPrepayVirtualCard v1.0.0 on September 16, 2017
  • 新規リリースしました。
    ※詳細についてはXMLタグ定義書をご参照ください。

XMLタグ定義書

リクエストサンプル

 選択<CommandList>
	<CancelPrepayVirtualCard>	
		<XmlLoginId>1234567890G0S143</XmlLoginId>
		<LoginId>1234567890G0S143</LoginId>
		<Reference>0ABCDEFGHI</Reference>
	</CancelPrepayVirtualCard>	
</CommandList>

レスポンスサンプル

 選択<CommandList>
	<CancelPrepayVirtualCard millis="3415">
		<LoginId>1234567890G0S143</LoginId>
	</CancelPrepayVirtualCard>
	<GeneralInfoItemList>
   <GeneralInfoItem>
    <Name>ClientAddress</Name>
    <Value>118.152.227.94</Value>
   </GeneralInfoItem>
		<GeneralInfoItem>
			<Name>StartTime</Name>
			<Value>16/08/17-01:38:06</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>EndTime</Name>
			<Value>16/08/17-01:38:09</Value>
		</GeneralInfoItem>
	</GeneralInfoItemList>
</CommandList>

レスポンスサンプル(エラー時①)

 選択<CommandList>
	<CommandExecutionFailure>
		<CancelPrepayVirtualCard ecode="4-3432" etext="Invalid login id" edetail="76KESZB7BKG0ST3" edate="16/08/2017-01:41"/>
	</CommandExecutionFailure>
	<GeneralInfoItemList>
		<GeneralInfoItem>
    <Name>ClientAddress</Name>
    <Value>118.152.227.94</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>StartTime</Name>
			<Value>16/08/17-01:41:30</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>EndTime</Name>
			<Value>16/08/17-01:41:30</Value>
		</GeneralInfoItem>
	</GeneralInfoItemList>
</CommandList>

レスポンスサンプル(エラー時②)

 選択<CommandList>
	<DataValidationFailure>
		<CancelPrepayVirtualCard millis="8">
			<XmlLoginId>1234567890G0S143</XmlLoginId>
			<LoginId>1234567890G0S143</LoginId>
			<Reference ecode="3-115-10816" etext="Invalid reference">123456</Reference>
		</CancelPrepayVirtualCard>
	</DataValidationFailure>
	<GeneralInfoItemList>
		<GeneralInfoItem>
			<Name>ClientAddress</Name>
			<Value>118.152.227.94</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>StartTime</Name>
			<Value>16/08/17-01:55:44</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>EndTime</Name>
			<Value>16/08/17-01:55:44</Value>
		</GeneralInfoItem>
	</GeneralInfoItemList>
</CommandList>

エラー集

 VCNキャンセル時に返却されるエラーレスポンスを例示します。
 ※エラー発生時は<CommandList>の下階層に<CommandExecutionFailure>または
  <DataValidationFailure>が返却されます。
 ※下記以外のエラーについてはINFINIまでお問い合わせください。
 
# エラーメッセージ エラー内容
1 <CancelPrepayVirtualCard ecode="4-3432" etext="Invalid login id" edetail="1234567890G0S143" edate="16/08/2017-01:41"/> XMLログインIDまたはログインIDに誤りがあります。
正しいXMLログインIDまたはログインIDで送信してください。
2 <CancelPrepayVirtualCard ecode="3-115-10816" etext="Invalid reference" edetail="No record was found with the specified reference." edate="16/08/2017-01:48"/> TFリファレンスに誤りがあります。
(存在しないTFリファレンスを指定している場合)
正しいTFリファレンスで送信してください。
3 <Reference ecode="1-1017" etext="Compulsory XML tag missing" edate="16/08/2017-01:49"/> 必須項目が不足しています。
全ての必須項目を設定して送信してください。
4 <CancelPrepayVirtualCard ecode="3-115-10853" etext="There has been an error in processing your request through the TF.Payment Service" edetail="Booking has been already cancelled, therefore no further attempts can be accepted." edate="16/08/2017-01:51"/> 該当のTFリファレンスは既にキャンセル済みです。
5 <Reference ecode="3-115-10816" etext="Invalid reference">123456</Reference> TFリファレンスに誤りがあります。
(TFリファレンスに不正な文字が含まれている場合)
正しいTFリファレンスで送信してください。