Exchange Ticket Type

We have a single API endpoint that handles all types of ticket exchange
Get the API endpoint: Exchange Ticket Type :

Basic details of the Exchange ticket type API endpoint.

PUT : /rest/host/event/{eventUrl}/order/{orderId}/transfer-event-ticket

Payload : { "eventTicketId": 0, "newTicketTypeId": 0, "sentMailToAttendee": true, "orderId": 0, "paymentDetails": { "paymentType": "string", "amount": 0, "note": "string", "transactionId": "string", "tokenOrIntentId": "string", "paymentDate": "string", "createdBy": 0, "documentLink": "string", "refundWithCancel": true, "internationalPayment": true } }

Response: { "type": "Success", "message": "Success" }

Ticket Exchange Scenarios
There are four major scenarios in ticket exchanges:

1. Free to Free Ticket Exchange
   Description: If the originally purchased ticket is a free type and the admin exchanges it for another free ticket type, only the ticket type is updated.

     Payment: No payment adjustments are needed.

2. Free to Paid Ticket Exchange
   Description: If the originally purchased ticket is free and the admin exchanges it for a paid ticket type, the ticket type and price will be updated to the new paid ticket type.

    Payment: An email with a payment link is sent to the buyer to complete the payment for the new ticket. The admin has the option to settle payment using the "Adjust/Apply" and "Mark as Paid" options on the host side.

3. Paid to Free Ticket Exchange
   Description: If the originally purchased ticket is paid and the admin exchanges it for a free ticket type, the ticket type and price will be updated (with the new price being $0 for the free ticket).

     Refund: If the original ticket was paid, the payment will be refunded, and the buyer will receive a refund notification email. If the ticket was unpaid, no refund will be processed; instead, the ticket type is simply changed, marked as Paid, and the order status is updated.

4. Paid to Paid Ticket Exchange
   There are three sub-scenarios for exchanging a paid ticket with another paid ticket type:

Same Ticket Price Exchange

If the original ticket price matches the new ticket price, only the ticket type and related fields are updated.
Payment: No payment adjustments are needed.

Lower to Higher Price Ticket Exchange

If the new ticket price is higher than the original, the ticket type and price will be updated. An email will be sent to the buyer to complete the outstanding balance. The admin can also use the "Adjust/Apply" and "Mark as Paid" options to settle the remaining payment.

Higher to Lower Price Ticket Exchange

If the new ticket price is lower than the original, the ticket type and price will be updated accordingly. The difference will be refunded to the buyer, who will receive an email notification. If the original ticket was unpaid, no refund will be processed; instead, the ticket type is changed, marked as Paid, and the order status is updated.

Additional Information about Ticket Exchange

1. Complimentary Orders

For orders marked as complimentary (ticket price and paid amount are $0), the admin can exchange tickets without needing to settle any payment.

2. Refund Restrictions

If an order status is "Refunded" or "Partially Refunded," ticket exchanges are not permitted.

3. Multiple Exchanges

The admin can exchange tickets an unlimited number of times for individual tickets.

4. Bundle Tickets

Ticket exchange options are not available for bundle ticket types.

5. Flat and Percentage Fees

A flat fee is charged once per ticket, while percentage fees are applied every time based on the ticket price.

6. Refund Priority

For ticket refunds, the latest transactions are refunded first, with the oldest transactions being refunded last.

7. Processing Fee Refunds

For ticket exchanges requiring a refund, payment processing fees (e.g., credit card fees) are also refunded.

8. Order Confirmation Emails

An order confirmation email is sent with every ticket exchange.

9. Ticket Status

On every ticket exchange, we set the event ticket status to REGISTERED. (If the user has used a ticket for the checked-in)

Here are the fee calculation document link
Ticket Exchange Fees Calculation (1).xlsx

https://docs.google.com/spreadsheets/d/1RLkXPBq-4LZXi7cMkcKfIM0M5Hrxf0WhUTdY9tu-m4s/edit?gid=1531283341#gid=1531283341Connect your Google account

For the ticket and order status related doc: https://docs.google.com/document/d/1QHwG27wc2tMAh0QiO_-fImPRP3v5NYEMVLNNV8yvyUA/edit?usp=sharing