Introduction
API Reference
- Auth
- Events
- ListRates
- Lists
- Locations
- Organizations
- Payments
- TicketRates
- Tickets
- Webhook Endpoints
Webhooks
- Introduction
- Events
Tickets
Refund Ticket
Void ticket and mark the amount of money refunded. It can be partial or total and it can be done multiple times until the ticket is fully refunded. However, the first time it is done, the ticket is marked as voided.
PUT
/
tickets
/
{id}
/
refund
Copy
curl --request PUT \
--url https://channels-service-alpha.fourvenues.com/tickets/{id}/refund \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '{
"amount": 10
}'
Copy
{
"data": {
"_id": "5f8d0f8b9d2b3b0017b6d8a0",
"event_id": "5f8d0f8b9d2b3b0017b6d8a0",
"ticket_rate_id": "5f8d0f8b9d2b3b0017b6d8a0",
"qr_code": "ABCDE12345",
"status": "active",
"price": {
"_id": "1643064796675",
"name": "Early Bird",
"price": 12,
"valid_until": "2022-01-01T00:00:00.000Z",
"quantity": 0,
"fee_type": "percentage",
"fee_quantity": 10,
"includes": "1 Drink",
"additional_info": "Only valid before 2:00 am."
},
"payment_currency": "EUR",
"channel_id": "5f8d0f8b9d2b3b0017b6d8a0",
"fees": {
"organization": 1.1,
"discocil": 0.7
},
"full_name": "John Doe",
"phone": "1234567890",
"email": "john.appleseed@fourvenues.com",
"gender": 0,
"birthday": "1990-01-01",
"address": "123 Main St, New York, NY 10001",
"postal_code": "10001",
"country_code": "ES",
"personal_document_type": "dni",
"personal_document_number": "1234567890",
"answers": [
{
"question_id": "1234567890",
"answer": "Answer"
}
],
"supplements": [
{
"supplement_id": "1234567890",
"price": 1
}
],
"refunded": 10,
"refunded_at": "2020-10-19T07:00:00.000Z",
"refunds": [
{
"channel_id": "5f8d0f8b9d2b3b0017b6d8a0",
"amount": 10,
"at": "2020-10-19T07:00:00.000Z"
}
],
"for": 1,
"enter": 1,
"entry_time": "2022-07-19T07:00:00.000Z",
"total_supplements": 2,
"total_fees": 1.1,
"total_price": 16.1,
"warranty": {
"total": 1,
"hours": 12
}
},
"success": true
}
Authorizations
Path Parameters
Ticket id
Body
application/json
Response
200
application/json
OK
The response is of type object
.
Copy
curl --request PUT \
--url https://channels-service-alpha.fourvenues.com/tickets/{id}/refund \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '{
"amount": 10
}'
Copy
{
"data": {
"_id": "5f8d0f8b9d2b3b0017b6d8a0",
"event_id": "5f8d0f8b9d2b3b0017b6d8a0",
"ticket_rate_id": "5f8d0f8b9d2b3b0017b6d8a0",
"qr_code": "ABCDE12345",
"status": "active",
"price": {
"_id": "1643064796675",
"name": "Early Bird",
"price": 12,
"valid_until": "2022-01-01T00:00:00.000Z",
"quantity": 0,
"fee_type": "percentage",
"fee_quantity": 10,
"includes": "1 Drink",
"additional_info": "Only valid before 2:00 am."
},
"payment_currency": "EUR",
"channel_id": "5f8d0f8b9d2b3b0017b6d8a0",
"fees": {
"organization": 1.1,
"discocil": 0.7
},
"full_name": "John Doe",
"phone": "1234567890",
"email": "john.appleseed@fourvenues.com",
"gender": 0,
"birthday": "1990-01-01",
"address": "123 Main St, New York, NY 10001",
"postal_code": "10001",
"country_code": "ES",
"personal_document_type": "dni",
"personal_document_number": "1234567890",
"answers": [
{
"question_id": "1234567890",
"answer": "Answer"
}
],
"supplements": [
{
"supplement_id": "1234567890",
"price": 1
}
],
"refunded": 10,
"refunded_at": "2020-10-19T07:00:00.000Z",
"refunds": [
{
"channel_id": "5f8d0f8b9d2b3b0017b6d8a0",
"amount": 10,
"at": "2020-10-19T07:00:00.000Z"
}
],
"for": 1,
"enter": 1,
"entry_time": "2022-07-19T07:00:00.000Z",
"total_supplements": 2,
"total_fees": 1.1,
"total_price": 16.1,
"warranty": {
"total": 1,
"hours": 12
}
},
"success": true
}
Assistant
Responses are generated using AI and may contain mistakes.