TicketUserServices

OwnerCardsUpgradeRequest

**Requires Authentication**
Requires any of the roles:	Admin, TeamAdmin	Requires the permission:	ReadData

The following routes are available for this service:
POST	/OrderOwnerCards/upgrade	Charge the delta, issue the target card (PricePaid = delta), revoke the source card, re-link future tickets — one transaction, idempotent

**OwnerCardsUpgradeRequest** Parameters:
Name	Parameter	Data Type	Required
BuyerPhone	body	string	No
SourceOwnerCardId	body	int	No
TargetOwnerCardTypeId	body	int	No
IdempotencyKey	body	string	No
PaymentMethodId	body	string	No
Borgun3DFinalInfo	body	Borgun3DFinalRequest	No
Tenders	body	List<OrderTender>	No
HolderName	body	string	No
HolderEmail	body	string	No
DeviceId	body	string	No
ReturnCards	body	bool	No

**Borgun3DFinalRequest** Parameters:
Name	Parameter	Data Type	Required
TransactionType	form	string	No
Amount	form	int	No
Currency	form	string	No
TransactionDate	form	DateTime?	No
OrderId	form	string	No
PaymentMethod	form	Borgun3DFinalPaymentMethodInfo	No
ThreeDSecure	form	Borgun3DFinal3DSecureInfo	No

**Borgun3DFinalPaymentMethodInfo** Parameters:
Name	Parameter	Data Type	Required
PaymentType	form	string	No
Token	form	string	No
VirtualNumber	form	string	No
ExpYear	form	string	No
ExpMonth	form	string	No
PanLastFour	form	string	No

**Borgun3DFinal3DSecureInfo** Parameters:
Name	Parameter	Data Type	Required	Description
DataType	form	string	No
MpiToken	form	string	No

**OrderTender** Parameters:
Name	Parameter	Data Type	Required
Kind	form	string	No
Code	form	string	No
AmountMinor	form	int?	No
IdempotencyKey	form	string	No
HoldId	form	int?	No
AppliedMinor	form	int?	No

**OwnerCardsUpgradeResult** Parameters:
Name	Parameter	Data Type	Required
SourceOwnerCardId	form	int	No
SourceOwnerCardTypeId	form	int	No
SourceTypeName	form	string	No
NewOwnerCardId	form	int	No
TargetOwnerCardTypeId	form	int	No
TargetTypeName	form	string	No
RelinkedTickets	form	int	No
PaymentReference	form	string	No
RefundPending	form	bool	No

**OwnerCardsOrderResult** Parameters:
Name	Parameter	Data Type	Required
Cards	form	List<OwnerCards>	No
OrderReference	form	string	No
IsSubscription	form	bool	No
MonthlyPrice	form	decimal?	No
TransactionFee	form	decimal?	No
Months	form	int?	No
PaymentTokenId	form	string	No
SubscriptionTokenMissing	form	bool	No
PriceTotal	form	int	No
DiscountAmount	form	int	No
GiftCardAmount	form	int	No
DonationAmount	form	int	No
ChargedAmount	form	int	No
Reason	form	string	No

**GeneralOrderResponse** Parameters:
Name	Parameter	Data Type	Required
StatusCode	form	int	No
Message	form	string	No
Success	form	bool	No
PaymentIsPending	form	bool	No
OrderTokenId	form	string	No

**OwnerCards** Parameters:
Name	Parameter	Data Type	Required
ID	form	int	No
OwnerId	form	int	No
OwnerCardTypeId	form	int?	No
PhoneVerificationId	form	int?	No
InitialMaxTickets	form	int?	No
CurrentAvailableTickets	form	int?	No
TimeStampCreatedUTC	form	DateTime?	No
TimeStampLastChangedUTC	form	DateTime?	No
TimeStampBoughtUTC	form	DateTime?	No
TimeStampOrderedUTC	form	DateTime?	No
CardValidFromUTC	form	DateTime?	No
CardValidToUTC	form	DateTime?	No
HasStoreCredit	form	bool	No
CardPrice	form	decimal	No
PricePaid	form	decimal	No
InitialStoreCredit	form	decimal?	No
CurrentStoreCredit	form	decimal?	No
PhoneFullVerificationNumber	form	string	No
HolderId	form	string	No
HolderName	form	string	No
HolderEmail	form	string	No
CardPriceCurrency	form	string	No
PricePaidCurrency	form	string	No
DeviceId	form	string	No
PaymentMethodId	form	string	No
PaymentReference	form	string	No
PhoneVerificationNumber	form	string	No
PaymentPhoneNumber	form	string	No
PaymentId	form	string	No
PaymentStatus	form	string	No
PaymentTokenId	form	string	No
MaxTicketsPerEvent	form	int?	No
MultiplePaymentsId	form	string	No
ImageUrl	form	string	No
BackgroundImageUrl	form	string	No
OrderReference	form	string	No
UpgradedFromOwnerCardId	form	int?	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /OrderOwnerCards/upgrade HTTP/1.1 
Host: stubbur-app.azurewebsites.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	buyerPhone: String,
	sourceOwnerCardId: 0,
	targetOwnerCardTypeId: 0,
	idempotencyKey: String,
	paymentMethodId: String,
	borgun3DFinalInfo: 
	{
		transactionType: String,
		amount: 0,
		currency: String,
		transactionDate: 0001-01-01,
		orderId: String,
		paymentMethod: 
		{
			paymentType: String,
			token: String,
			virtualNumber: String,
			expYear: String,
			expMonth: String,
			panLastFour: String
		},
		threeDSecure: 
		{
			dataType: String,
			mpiToken: String
		}
	},
	tenders: 
	[
		{
			kind: String,
			code: String,
			amountMinor: 0,
			idempotencyKey: String,
			holdId: 0,
			appliedMinor: 0
		}
	],
	holderName: String,
	holderEmail: String,
	deviceId: String,
	returnCards: False
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	sourceOwnerCardId: 0,
	sourceOwnerCardTypeId: 0,
	sourceTypeName: String,
	newOwnerCardId: 0,
	targetOwnerCardTypeId: 0,
	targetTypeName: String,
	relinkedTickets: 0,
	paymentReference: String,
	refundPending: False,
	cards: 
	[
		{
			id: 0,
			ownerId: 0,
			ownerCardTypeId: 0,
			phoneVerificationId: 0,
			initialMaxTickets: 0,
			currentAvailableTickets: 0,
			timeStampCreatedUTC: 0001-01-01,
			timeStampLastChangedUTC: 0001-01-01,
			timeStampBoughtUTC: 0001-01-01,
			timeStampOrderedUTC: 0001-01-01,
			cardValidFromUTC: 0001-01-01,
			cardValidToUTC: 0001-01-01,
			hasStoreCredit: False,
			cardPrice: 0,
			pricePaid: 0,
			initialStoreCredit: 0,
			currentStoreCredit: 0,
			phoneFullVerificationNumber: String,
			holderId: String,
			holderName: String,
			holderEmail: String,
			cardPriceCurrency: String,
			pricePaidCurrency: String,
			deviceId: String,
			paymentMethodId: String,
			paymentReference: String,
			phoneVerificationNumber: String,
			paymentPhoneNumber: String,
			paymentId: String,
			paymentStatus: String,
			paymentTokenId: String,
			maxTicketsPerEvent: 0,
			multiplePaymentsId: String,
			imageUrl: String,
			backgroundImageUrl: String,
			orderReference: String,
			upgradedFromOwnerCardId: 0
		}
	],
	orderReference: String,
	isSubscription: False,
	monthlyPrice: 0,
	transactionFee: 0,
	months: 0,
	paymentTokenId: String,
	subscriptionTokenMissing: False,
	priceTotal: 0,
	discountAmount: 0,
	giftCardAmount: 0,
	donationAmount: 0,
	chargedAmount: 0,
	reason: String,
	statusCode: 0,
	message: String,
	success: False,
	paymentIsPending: False,
	orderTokenId: String
}