VCN取得

当該機能は、VCN（Virtual Card Number）取得機能です。
指定したリクエストの値に基づいてVCNが返却されます。

API情報

Service Action Code	：CreatePrepayVirtualCard
最新バージョン	：1.0.0

ご利用上の注意

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

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

VCN取得時に、即座に指定口座から与信金額を引き落とします。
VCN取得機能は本番環境でのみのご用意となるため、以下ご注意ください。
・検証の場合でも、VCN取得時に、即時に指定口座から与信金額が引き落とされますので、
　必要に応じて検証後にキャンセルしてください。また、1円等少ない金額での検証を推奨いたします。
・VCN取得後に決算処理しないVCNは、都度キャンセルを行うようにしてください。
　詳細はVCNキャンセル機能（Cancel Prepay Virtual Card）をご覧ください。
・取得したVCNの有効期限は21日間です。
　有効期限を過ぎると自動的にキャンセルされ、口座に与信額が戻されます。
・<PseudoCityCode>には自社PCC、<PseudoAccountCode>には自社で必要な情報を登録してください。
　※上記2項目は、Travelfusionレポートサイトでデータ確認時に利用します。

FPライン生成時に利用VCNと有効期限を利用します。
なお、このとき、カードホルダー名は「LTD/TRAVELFUSION」としてください。

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

更新履歴

CreatePrepayVirtualCard v1.0.0 on September 16, 2017

新規リリースしました。
※詳細についてはXMLタグ定義書をご参照ください。

XMLタグ定義書

リクエスト　　(2017/10/16更新)

ダウンロード
レスポンス　　(2017/10/16更新)

ダウンロード

リクエストサンプル

 選択<CommandList>
	<CreatePrepayVirtualCard> 
		<XmlLoginId>1234567890G0S143</XmlLoginId>
		<LoginId>1234567890G0S143</LoginId>
		<PseudoCityCode>AAA6</PseudoCityCode>
		<PseudoAccountCode>TEST-DATA</PseudoAccountCode>
		<NumberOfTaxableTravellers>1</NumberOfTaxableTravellers>
		<Locator>ABCDEF</Locator>
		<ExpirationTime>26/12/2017</ExpirationTime>
		<Currency>JPY</Currency>
		<Amount>1</Amount>
	</CreatePrepayVirtualCard>
</CommandList>

レスポンスサンプル

 選択<CommandList>
	<CreatePrepayVirtualCard millis="2468">
		<LoginId>1234567890G0S143</LoginId>
		<PseudoCityCode>AAA6</PseudoCityCode>
		<PseudoAccountCode>TEST-DATA</PseudoAccountCode>
		<NumberOfTaxableTravellers>1</NumberOfTaxableTravellers>
		<Reference>V12345ZYX0</Reference>

		<Locator>ABCDEF</Locator>
		<Credit>
			<Amount>1.00</Amount>
			<Currency>JPY</Currency>
		</Credit>
		<Debit>
			<Amount>1.00</Amount>
			<Currency>JPY</Currency>
		</Debit>
		<Card>
			<Company>Travelfusion</Company>
			<NameOnCard>
				<Title>Mr</Title>
				<NamePartList>
					<NamePart>John</NamePart>
					<NamePart>Doe</NamePart>
				</NamePartList>
			</NameOnCard>
			<Number>5300000000000000</Number>
			<SecurityCode>111</SecurityCode>
			<ExpiryDate>10/20</ExpiryDate>
			<CardType>MasterCard</CardType>
		</Card>
		<Address>
			<Company>TravelFusion</Company>
			<Flat>22A</Flat>
			<BuildingName>Dean's Court</BuildingName>
			<BuildingNumber>3</BuildingNumber>
			<Street>St. Georges Road</Street>
			<Locality>Clifton</Locality>
			<City>Bristol</City>
			<Province>Avon</Province>
			<Postcode>BS1 5UL</Postcode>
			<CountryCode>GB</CountryCode>
		</Address>
		<Accounts>
			<Account Currency="JPY" Amount="819021.00" Flags="@None"/>
		</Accounts>
	</CreatePrepayVirtualCard>
	<GeneralInfoItemList>
		<GeneralInfoItem>
			<Name>ClientAddress</Name>
			<Value>118.152.227.94</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>StartTime</Name>
			<Value>11/10/17-02:28:34</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>EndTime</Name>
			<Value>11/10/17-02:28:37</Value>
		</GeneralInfoItem>
	</GeneralInfoItemList>
</CommandList>

エラー集

　VCN取得時に返却されるエラーレスポンスを例示します。
　※エラー発生時は<CommandList>の下階層に<DataValidationFailure>が返却されます。
　※下記以外のエラーについてはINFINIまでお問い合わせください。

#	エラーメッセージ	エラー内容
1	<CreatePrepayVirtualCard ecode="4-3432" etext="Invalid login id" edetail="xxxxxxxxxxxxxxx" edate="13/08/2017-23:26"/>	XMLログインIDまたはログインIDに誤りがあります。正しいXMLログインIDまたはログインIDで送信してください。
2	<PseudoCityCode ecode="3-115-10852" etext="Invalid agent pseudo city code">xxxxxxxxxxxxxxx</PseudoCityCode>	PCCに誤りがあります。正しいPCCで送信してください。 ※PCCの整合性チェックは行いません。
3	<ExpirationTime ecode="12-1607" etext="Invalid date">Expiration time is in the past</ExpirationTime>	有効期限に誤りがあります。正しい有効期限を送信してください。
4	<PseudoAccountCode ecode="3-115-10863" etext="Invalid agent pseudo account code">xxxxxxxxxxxxx</PseudoAccountCode>	アカウントコードに誤りがあります。正しいアカウントコードで送信してください。 ※PNR中のアカウントコードとの整合性のチェックは行いません。
5	<NumberOfTaxableTravellers ecode="1-1033" etext="Invalid unsigned whole number">	旅客人数が未入力です。正しい旅客人数を指定してください。
6	<Locator ecode="3-115-10834" etext="Invalid record locator">	PNRリファレンスが不正です。正しいPNRリファレンスを指定してください。 ※未入力時は、PNRとは無関係の番号が自動採番されます。
7	<Currency ecode="3-115-10802" etext="Invalid currency">	通貨コードが未入力です。 JPYを指定してください。
8	<Amount ecode="3-115-10814" etext="Invalid amount">	与信額が未入力です。与信額を入力してください。
9	<Amount ecode="1-1017" etext="Compulsory XML tag missing"/>	必須項目が未入力です。（左記事例は、Amountデータが存在しなかった場合）正しい情報で送信してください。
10	<CreatePrepayVirtualCard ecode="3-115-10855" etext="Insufficient funds to issue a virtual card through the TF.Payment Service" edate="21/08/2017-02:29"/>	上限額を超えています。利用可能な範囲の金額でリクエストしてください。