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タグ定義書

リクエストサンプル

 選択<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"/> 上限額を超えています。
利用可能な範囲の金額でリクエストしてください。