curl --request POST \
--url https://channels-service-alpha.fourvenues.com/tickets/checkout \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"redirect_url": "https://app.yourwebpage.com/checkout/internal-id/success",
"error_url": "https://app.yourwebpage.com/checkout/internal-id/error",
"ticket_rate_id": "5f8d0f8b9d2b3b0017b6d8a0",
"tickets": [
{
"price_id": "1234567890",
"qr_code": "ABCDE12345",
"full_name": "John Doe",
"phone": "+34666666666",
"email": "john@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"
}
],
"warranty": true
}
],
"send_resources": true,
"metadata": {
"key": "value"
},
"discount_code": "DISCOUNT_CODE"
}
'{
"data": {
"payment_id": "1234567890",
"payment_url": "https://payment.yourwebpage.com/1234567890",
"total_amount": 10,
"tickets": [
{
"_id": "5f8d0f8b9d2b3b0017b6d8a0",
"event_id": "5f8d0f8b9d2b3b0017b6d8a0",
"ticket_rate_id": "5f8d0f8b9d2b3b0017b6d8a0",
"qr_code": "ABCDE12345",
"status": "active",
"price": {
"price": 12,
"valid_until": "2022-01-01T00:00:00.000Z",
"quantity": 0,
"includes": "1 Drink",
"additional_info": "Only valid before 2:00 am.",
"_id": "1643064796675",
"name": "Early Bird",
"fee_type": "percentage",
"fee_quantity": 10,
"used": "55"
},
"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
},
"discount_amount": 5
}
],
"conditions_changed": true
}
}Checkout tickets
curl --request POST \
--url https://channels-service-alpha.fourvenues.com/tickets/checkout \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"redirect_url": "https://app.yourwebpage.com/checkout/internal-id/success",
"error_url": "https://app.yourwebpage.com/checkout/internal-id/error",
"ticket_rate_id": "5f8d0f8b9d2b3b0017b6d8a0",
"tickets": [
{
"price_id": "1234567890",
"qr_code": "ABCDE12345",
"full_name": "John Doe",
"phone": "+34666666666",
"email": "john@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"
}
],
"warranty": true
}
],
"send_resources": true,
"metadata": {
"key": "value"
},
"discount_code": "DISCOUNT_CODE"
}
'{
"data": {
"payment_id": "1234567890",
"payment_url": "https://payment.yourwebpage.com/1234567890",
"total_amount": 10,
"tickets": [
{
"_id": "5f8d0f8b9d2b3b0017b6d8a0",
"event_id": "5f8d0f8b9d2b3b0017b6d8a0",
"ticket_rate_id": "5f8d0f8b9d2b3b0017b6d8a0",
"qr_code": "ABCDE12345",
"status": "active",
"price": {
"price": 12,
"valid_until": "2022-01-01T00:00:00.000Z",
"quantity": 0,
"includes": "1 Drink",
"additional_info": "Only valid before 2:00 am.",
"_id": "1643064796675",
"name": "Early Bird",
"fee_type": "percentage",
"fee_quantity": 10,
"used": "55"
},
"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
},
"discount_amount": 5
}
],
"conditions_changed": true
}
}Documentation Index
Fetch the complete documentation index at: https://docs.fourvenues.com/llms.txt
Use this file to discover all available pages before exploring further.
URL to redirect the user after the checkout.
"https://app.yourwebpage.com/checkout/internal-id/success"
URL to redirect the user if the checkout fails.
"https://app.yourwebpage.com/checkout/internal-id/error"
Ticket rate id of a ticket.
"5f8d0f8b9d2b3b0017b6d8a0"
Show child attributes
If the resources (tickets in that case) should be sent via email (and Whatsapp if is enabled) by Fourvenues.
true
Metadata to be stored in the ticket. Max 1kb.
{ "key": "value" }Discount code of a ticket.
"DISCOUNT_CODE"
OK
Show child attributes