Personalization requests allow the creator of an order to request their friends to personalize tickets. The creator of an order can create a personalization request by specifying a ticket and the email address of their friend. The Paylogic system will send an email to this email address. The email contains a link to a page where the friend can enter their details.
This page is about the creation and management of a personalization request. The process of a friend personalizing their tickets is documented in Personalization.
The first step in asking friend to personalize is creating a personalization request. This requires access to an order with tickets requiring personalization, within the personalization period of the event.
Authenticate the creation of a personalization request using a Cognito token or Order token.
Field name | Type | Description |
---|---|---|
String | Email address of the person who will be requested by email to personalize. | |
order | Orders reference | A reference to the order of the tickets. All tickets must belong to the same order. |
tickets | Ticket references | A list of references to tickets requested to be personalized. |
[POST] https://shopping-api.paylogic.com/personalization-request
{
"email": "john.doe@example.org",
"order": "https://shopping-api.paylogic.com/orders/efccc5a465194fe38df0848f5288e886",
"tickets": [
"https://shopping-api.paylogic.com/tickets/922831e1d3914370b820488ce21649ef",
"https://shopping-api.paylogic.com/tickets/da14e70160f24af49fc6f7f88b25ad51",
]
}
Field name | Type | Description |
---|---|---|
String | The email address of the person who was asked to personalize. | |
state | String | The status of the order. See the table below for the values. |
created_at | Datetime | The date and time the personalization request was created. |
tickets | Tickets list | Tickets in the personalization request that are requested to be personalized. |
products | Product list | Products in the personalization request. |
State | Description |
---|---|
Pending | The personalization request has been created. |
Completed | The tickets in the personalization request have been personalized. |
Canceled | The personalization request is canceled and no longer valid. |
{
"_links": {
"event": {
"href": "https://shopping-api.paylogic.com/events/e60762ab985e423587ae290d0f64566d"
},
"self": {
"href": "https://shopping-api.paylogic.com/personalization-requests/c999f7100be74433ba18489606a093d7"
},
"tickets": [
{
"href": "https://shopping-api.paylogic.com/tickets/922831e1d3914370b820488ce21649ef"
},
{
"href": "https://shopping-api.paylogic.com/tickets/da14e70160f24af49fc6f7f88b25ad51"
}
]
},
"created_at": "2020-07-21T12:42:37Z",
"email": "john.doe@example.org",
"state": "pending",
"_embedded": {
"products": [
{
"_links": {
"event": {
"href": "https://shopping-api.paylogic.com/events/e60762ab985e423587ae290d0f64566d"
},
"self": {
"href": "https://shopping-api.paylogic.com/products/e3239997301e4abd88e1d8a524d21ca4"
}
},
"name": {
"de": "",
"en": "Saturday Ticket",
"es": "",
"fr": "",
"nl": "",
"pt": "",
"tr": ""
},
"subtitle": {
"de": "",
"en": "All Access",
"es": "",
"fr": "",
"nl": "",
"pt": "",
"tr": ""
}
},
// ...
],
"event": {
"_links": {
"self": {
"href": "https://shopping-api.paylogic.com/events/e60762ab985e423587ae290d0f64566d"
}
},
"title": {
"en": "Event 1",
"nl": "Evenement 1",
"de": "",
"es": "",
"fr": "",
"pt": ""
},
"subtitle": {
"en": "A subtitle",
"nl": "",
"de": "",
"es": "",
"fr": "",
"pt": ""
},
"event_start": "2021-05-11T14:19:30Z",
"event_end": "2021-05-31T14:19:30Z",
"personalization_start": "2020-07-21T11:42:35Z",
"personalization_end": "2020-07-21T13:42:35Z"
},
"tickets": [
{
"_links": {
"curies": [
{
"href": "https://shopping-api-docs.paylogic.com/documentation/{rel}.html",
"name": "shop",
"templated": true,
"type": "text/html"
}
],
"product": {
"href": "https://shopping-api.paylogic.com/products/e3239997301e4abd88e1d8a524d21ca4"
},
"self": {
"href": "https://shopping-api.paylogic.com/tickets/85c0c1a554d54e6792b74134906be379"
},
"shop:order": {
"href": "https://shopping-api.paylogic.com/orders/efccc5a465194fe38df0848f5288e886"
}
},
"needs_personalization": true,
"personalization_start": "2020-07-21T11:42:35Z",
"personalization_end": "2020-07-21T13:42:35Z",
"personalization_form": {
"date_of_birth": {
"required": true
},
"email": {
"required": true,
"unique_per_product": false
},
"first_name": {
"required": true
},
"gender": {
"required": true
},
"last_name": {
"required": true
},
"phone_number": {
"required": true
}
},
"seating": {
// ...
},
"status": "valid"
},
// ...
]
}
}
If you want to display or check on the progress of a personalization request, you can retrieve its details. Get the reference from the response when you created the personalization request.
Authenticate the retrieval of a personalization request using a Cognito token, Personalization request token or Order token.
[GET] https://shopping-api.paylogic.com/personalization-requests/c999f7100be74433ba18489606a093d7
The server will respond with the same fields as when creating a personalization request.
The creator of a personalization request may cancel the request. This will block a friend from completing a personalization request for tickets that have not been personalized yet. Cancelling a personalization request will not remove existing personalization, it will only block further/future personalization.
Authenticate the cancellation of a personalization request using a Cognito token, Personalization request token or Order token.
[DELETE] https://shopping-api.paylogic.com/personalization-request/c999f7100be74433ba18489606a093d7
The server will respond with 204 NO CONTENT
if the personalization request was successfully canceled.