VCNキャンセル
当該機能は、VCN(Virtual Card Number)キャンセル機能です。
指定したリクエストの値に基づいてVCNキャンセルが可能です。
指定したリクエストの値に基づいてVCNキャンセルが可能です。
API情報
Service Action Code | :CancelPrepayVirtualCard |
最新バージョン | :1.0.0 |
ご利用上の注意
SESSION=STARTで接続を確認後、VCN取得を行ってください。
SESSION=START-ENDは利用不可です。またSESSION=START時にVCN取得コマンドを
同時送信することは出来ません。
オプション項目を利用しない場合は、タグ自体を削除してください。
VCNキャンセル時に、引き落としていた与信金額が指定口座に戻ります。
Travelfusion社のレポートサイトにて、取得データについての確認・およびVCNキャンセルが可能です。
詳細はこちら
SESSION=START-ENDは利用不可です。またSESSION=START時にVCN取得コマンドを
同時送信することは出来ません。
オプション項目を利用しない場合は、タグ自体を削除してください。
VCNキャンセル時に、引き落としていた与信金額が指定口座に戻ります。
Travelfusion社のレポートサイトにて、取得データについての確認・およびVCNキャンセルが可能です。
詳細はこちら
更新履歴
CancelPrepayVirtualCard v1.0.0 on September 16, 2017
- 新規リリースしました。
※詳細についてはXMLタグ定義書をご参照ください。
XMLタグ定義書
-
- リクエスト (2017/10/16更新)
-
- レスポンス (2017/10/16更新)
リクエストサンプル
選択<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リファレンスで送信してください。 |