| Requires any of the roles: | Admin, TeamAdmin | Requires the permission: | ReadData |
| POST | /OrderOwnerCards/upgrade | Charge the delta, issue the target card (PricePaid = delta), revoke the source card, re-link future tickets — one transaction, idempotent |
|---|
export class GeneralOrderResponse
{
public statusCode?: number;
public message?: string;
public success?: boolean;
public paymentIsPending?: boolean;
public orderTokenId?: string;
public constructor(init?: Partial<GeneralOrderResponse>) { (Object as any).assign(this, init); }
}
export class OwnerCards
{
public id?: number;
public ownerId?: number;
public ownerCardTypeId?: number;
public phoneVerificationId?: number;
public initialMaxTickets?: number;
public currentAvailableTickets?: number;
public timeStampCreatedUTC?: string;
public timeStampLastChangedUTC?: string;
public timeStampBoughtUTC?: string;
public timeStampOrderedUTC?: string;
public cardValidFromUTC?: string;
public cardValidToUTC?: string;
public hasStoreCredit?: boolean;
public cardPrice?: number;
public pricePaid?: number;
public initialStoreCredit?: number;
public currentStoreCredit?: number;
public phoneFullVerificationNumber?: string;
public holderId?: string;
public holderName?: string;
public holderEmail?: string;
public cardPriceCurrency?: string;
public pricePaidCurrency?: string;
public deviceId?: string;
public paymentMethodId?: string;
public paymentReference?: string;
public phoneVerificationNumber?: string;
public paymentPhoneNumber?: string;
public paymentId?: string;
public paymentStatus?: string;
public paymentTokenId?: string;
public maxTicketsPerEvent?: number;
public multiplePaymentsId?: string;
public imageUrl?: string;
public backgroundImageUrl?: string;
public orderReference?: string;
public upgradedFromOwnerCardId?: number;
public constructor(init?: Partial<OwnerCards>) { (Object as any).assign(this, init); }
}
export class OwnerCardsOrderResult extends GeneralOrderResponse
{
public cards?: OwnerCards[];
public orderReference?: string;
public isSubscription?: boolean;
public monthlyPrice?: number;
public transactionFee?: number;
public months?: number;
public paymentTokenId?: string;
public subscriptionTokenMissing?: boolean;
public priceTotal?: number;
public discountAmount?: number;
public giftCardAmount?: number;
public donationAmount?: number;
public chargedAmount?: number;
public reason?: string;
public constructor(init?: Partial<OwnerCardsOrderResult>) { super(init); (Object as any).assign(this, init); }
}
export class OwnerCardsUpgradeResult extends OwnerCardsOrderResult
{
public sourceOwnerCardId?: number;
public sourceOwnerCardTypeId?: number;
public sourceTypeName?: string;
public newOwnerCardId?: number;
public targetOwnerCardTypeId?: number;
public targetTypeName?: string;
public relinkedTickets?: number;
public paymentReference?: string;
public refundPending?: boolean;
public constructor(init?: Partial<OwnerCardsUpgradeResult>) { super(init); (Object as any).assign(this, init); }
}
export class Borgun3DFinalPaymentMethodInfo
{
public paymentType?: string;
public token?: string;
public virtualNumber?: string;
public expYear?: string;
public expMonth?: string;
public panLastFour?: string;
public constructor(init?: Partial<Borgun3DFinalPaymentMethodInfo>) { (Object as any).assign(this, init); }
}
export class Borgun3DFinal3DSecureInfo
{
public dataType?: string;
public mpiToken?: string;
public constructor(init?: Partial<Borgun3DFinal3DSecureInfo>) { (Object as any).assign(this, init); }
}
export class Borgun3DFinalRequest
{
public transactionType?: string;
public amount?: number;
public currency?: string;
public transactionDate?: string;
public orderId?: string;
public paymentMethod?: Borgun3DFinalPaymentMethodInfo;
public threeDSecure?: Borgun3DFinal3DSecureInfo;
public constructor(init?: Partial<Borgun3DFinalRequest>) { (Object as any).assign(this, init); }
}
export class OrderTender
{
public kind?: string;
public code?: string;
public amountMinor?: number;
public idempotencyKey?: string;
public holdId?: number;
public appliedMinor?: number;
public constructor(init?: Partial<OrderTender>) { (Object as any).assign(this, init); }
}
export class OwnerCardsUpgradeRequest
{
public buyerPhone?: string;
public sourceOwnerCardId?: number;
public targetOwnerCardTypeId?: number;
public idempotencyKey?: string;
public paymentMethodId?: string;
public borgun3DFinalInfo?: Borgun3DFinalRequest;
public tenders?: OrderTender[];
public holderName?: string;
public holderEmail?: string;
public deviceId?: string;
public returnCards?: boolean;
public constructor(init?: Partial<OwnerCardsUpgradeRequest>) { (Object as any).assign(this, init); }
}
TypeScript OwnerCardsUpgradeRequest DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
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: application/xml
Content-Type: application/xml
Content-Length: length
<OwnerCardsUpgradeRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TicketUserServices.ServiceModel">
<Borgun3DFinalInfo xmlns:d2p1="http://schemas.datacontract.org/2004/07/BorgunRPGData">
<d2p1:Amount>0</d2p1:Amount>
<d2p1:Currency>String</d2p1:Currency>
<d2p1:OrderId>String</d2p1:OrderId>
<d2p1:PaymentMethod>
<d2p1:ExpMonth>String</d2p1:ExpMonth>
<d2p1:ExpYear>String</d2p1:ExpYear>
<d2p1:PanLastFour>String</d2p1:PanLastFour>
<d2p1:PaymentType>String</d2p1:PaymentType>
<d2p1:Token>String</d2p1:Token>
<d2p1:VirtualNumber>String</d2p1:VirtualNumber>
</d2p1:PaymentMethod>
<d2p1:ThreeDSecure>
<d2p1:DataType>String</d2p1:DataType>
<d2p1:MpiToken>String</d2p1:MpiToken>
</d2p1:ThreeDSecure>
<d2p1:TransactionDate>0001-01-01T00:00:00</d2p1:TransactionDate>
<d2p1:TransactionType>String</d2p1:TransactionType>
</Borgun3DFinalInfo>
<BuyerPhone>String</BuyerPhone>
<DeviceId>String</DeviceId>
<HolderEmail>String</HolderEmail>
<HolderName>String</HolderName>
<IdempotencyKey>String</IdempotencyKey>
<PaymentMethodId>String</PaymentMethodId>
<ReturnCards>false</ReturnCards>
<SourceOwnerCardId>0</SourceOwnerCardId>
<TargetOwnerCardTypeId>0</TargetOwnerCardTypeId>
<Tenders>
<OrderTender>
<AmountMinor>0</AmountMinor>
<AppliedMinor>0</AppliedMinor>
<Code>String</Code>
<HoldId>0</HoldId>
<IdempotencyKey>String</IdempotencyKey>
<Kind>String</Kind>
</OrderTender>
</Tenders>
</OwnerCardsUpgradeRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<OwnerCardsUpgradeResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TicketUserServices.ServiceModel">
<Message>String</Message>
<OrderTokenId>String</OrderTokenId>
<PaymentIsPending>false</PaymentIsPending>
<StatusCode>0</StatusCode>
<Success>false</Success>
<Cards xmlns:d2p1="http://schemas.datacontract.org/2004/07/TicketUserServices.ServiceModel.Types">
<d2p1:OwnerCards>
<d2p1:BackgroundImageUrl>String</d2p1:BackgroundImageUrl>
<d2p1:CardPrice>0</d2p1:CardPrice>
<d2p1:CardPriceCurrency>String</d2p1:CardPriceCurrency>
<d2p1:CardValidFromUTC>0001-01-01T00:00:00</d2p1:CardValidFromUTC>
<d2p1:CardValidToUTC>0001-01-01T00:00:00</d2p1:CardValidToUTC>
<d2p1:CurrentAvailableTickets>0</d2p1:CurrentAvailableTickets>
<d2p1:CurrentStoreCredit>0</d2p1:CurrentStoreCredit>
<d2p1:DeviceId>String</d2p1:DeviceId>
<d2p1:HasStoreCredit>false</d2p1:HasStoreCredit>
<d2p1:HolderEmail>String</d2p1:HolderEmail>
<d2p1:HolderId>String</d2p1:HolderId>
<d2p1:HolderName>String</d2p1:HolderName>
<d2p1:ID>0</d2p1:ID>
<d2p1:ImageUrl>String</d2p1:ImageUrl>
<d2p1:InitialMaxTickets>0</d2p1:InitialMaxTickets>
<d2p1:InitialStoreCredit>0</d2p1:InitialStoreCredit>
<d2p1:MaxTicketsPerEvent>0</d2p1:MaxTicketsPerEvent>
<d2p1:MultiplePaymentsId>String</d2p1:MultiplePaymentsId>
<d2p1:OrderReference>String</d2p1:OrderReference>
<d2p1:OwnerCardTypeId>0</d2p1:OwnerCardTypeId>
<d2p1:OwnerId>0</d2p1:OwnerId>
<d2p1:PaymentId>String</d2p1:PaymentId>
<d2p1:PaymentMethodId>String</d2p1:PaymentMethodId>
<d2p1:PaymentPhoneNumber>String</d2p1:PaymentPhoneNumber>
<d2p1:PaymentReference>String</d2p1:PaymentReference>
<d2p1:PaymentStatus>String</d2p1:PaymentStatus>
<d2p1:PaymentTokenId>String</d2p1:PaymentTokenId>
<d2p1:PhoneFullVerificationNumber>String</d2p1:PhoneFullVerificationNumber>
<d2p1:PhoneVerificationId>0</d2p1:PhoneVerificationId>
<d2p1:PhoneVerificationNumber>String</d2p1:PhoneVerificationNumber>
<d2p1:PricePaid>0</d2p1:PricePaid>
<d2p1:PricePaidCurrency>String</d2p1:PricePaidCurrency>
<d2p1:TimeStampBoughtUTC>0001-01-01T00:00:00</d2p1:TimeStampBoughtUTC>
<d2p1:TimeStampCreatedUTC>0001-01-01T00:00:00</d2p1:TimeStampCreatedUTC>
<d2p1:TimeStampLastChangedUTC>0001-01-01T00:00:00</d2p1:TimeStampLastChangedUTC>
<d2p1:TimeStampOrderedUTC>0001-01-01T00:00:00</d2p1:TimeStampOrderedUTC>
<d2p1:UpgradedFromOwnerCardId>0</d2p1:UpgradedFromOwnerCardId>
</d2p1:OwnerCards>
</Cards>
<ChargedAmount>0</ChargedAmount>
<DiscountAmount>0</DiscountAmount>
<DonationAmount>0</DonationAmount>
<GiftCardAmount>0</GiftCardAmount>
<IsSubscription>false</IsSubscription>
<MonthlyPrice>0</MonthlyPrice>
<Months>0</Months>
<OrderReference>String</OrderReference>
<PaymentTokenId>String</PaymentTokenId>
<PriceTotal>0</PriceTotal>
<Reason>String</Reason>
<SubscriptionTokenMissing>false</SubscriptionTokenMissing>
<TransactionFee>0</TransactionFee>
<NewOwnerCardId>0</NewOwnerCardId>
<PaymentReference>String</PaymentReference>
<RefundPending>false</RefundPending>
<RelinkedTickets>0</RelinkedTickets>
<SourceOwnerCardId>0</SourceOwnerCardId>
<SourceOwnerCardTypeId>0</SourceOwnerCardTypeId>
<SourceTypeName>String</SourceTypeName>
<TargetOwnerCardTypeId>0</TargetOwnerCardTypeId>
<TargetTypeName>String</TargetTypeName>
</OwnerCardsUpgradeResult>