A transfer approval is a collection of tickets that are allowed to be transferred.
The channel connected to the application defines how and to whom tickets can be transferred. For example, when creating a Transfer Approval for a Waiting List, the tickets will be matched with Order Requests for the same channel.
When a ticket is transferred, a new ticket will be created with a new barcode and the original ticket will be invalidated.
Authenticate this request using Basic access authorization. Only valid tickets can be transferred.
| Field name | Type | Description |
|---|---|---|
| tickets | Tickets (list) | One or more ticket references to be transferred. |
| channel | Channel | Optional. A channel reference to which to offer these tickets. You can get this reference from transfer_channel of a ticket. |
[POST] https://shopping-api.paylogic.com/ticket-transfer-approvals
{
"channel": "https://shopping-api.paylogic.com/channels/b0f98cd6aef34487b941fae77a2ac760",
"tickets": [
"https://shopping-api.paylogic.com/tickets/a2e37ee17474417a87259b02b674da9a",
"https://shopping-api.paylogic.com/tickets/5959f610ba0f4b61b30750d5382f228c"
]
}
| Field name | Type | Description |
|---|---|---|
| uid | String | A unique identifier for this approval. |
| created_date | Datetime | Date and time the approval was created. |
| modified_date | Datetime | Date and time the approval was modified. |
| transfer_actor_email | String | The email address of the actor who was requested to complete a ticket transfer. (optional) |
| status | String | The status of the approval. See the table below. |
| tickets | Tickets (list) | Embedded list of tickets in the transfer approval. |
| Status | Description |
|---|---|
| approved | This ticket is approved for transfer and a new order can be created using it. |
| rejected | The consumer has retracted his or her approval for the transfer of this ticket. |
{
"uid": "23c4aa75abfe41c2bf2049f189ec9db7",
"status": "approved",
"transfer_actor_email": "",
"created_date": "2020-07-27T11:33:11Z"
"modified_date": "2020-07-27T11:33:11Z",
"_links": {
"profile": {
"href": "https://shopping-api-docs.paylogic.com/documentation/transfer_approvals.html",
"type": "text/html"
},
"curies": [
{
"href": "https://shopping-api-docs.paylogic.com/documentation/{rel}.html",
"type": "text/html",
"name": "shop",
"templated": true
}
],
"self": {
"href": "https://shopping-api-docs.paylogic.com/ticket-transfer-approvals/23c4aa75abfe41c2bf2049f189ec9db7"
}
}
"_embedded": {
"shop:ticket": [
{
"status": "valid",
"seating": {
// omitted: seating data
},
"code": "4479066162131",
"uid": "f399f6186fa54fe6ab3add06bdb0e117",
"needs_personalization": false,
"is_scanned": false,
"personalization_start": null,
"ticket_transfer_deadline": null,
"has_valid_subscription": false,
"_links": {
"shop:event": {
"href": "https://shopping-api-docs.paylogic.com/events/a0809162d683436f8449e1b3057d4d44"
},
"profile": {
"href": "https://shopping-api-docs.paylogic.com/documentation/tickets.html",
"type": "text/html"
},
"shop:ticket_transfer_approvals": {
"href": "https://shopping-api-docs.paylogic.com/ticket-transfer-approvals"
},
"shop:order": {
"href": "https://shopping-api-docs.paylogic.com/orders/f8c91697d72f44b18566731d81eb57e8"
},
"shop:product": {
"href": "https://shopping-api-docs.paylogic.com/products/40f0d66f2094408f8156ace2c505d4d9"
},
"curies": [
{
"href": "https://shopping-api-docs.paylogic.com/documentation/{rel}.html",
"type": "text/html",
"name": "shop",
"templated": true
}
],
"self": {
"href": "https://shopping-api-docs.paylogic.com/tickets/a2e37ee17474417a87259b02b674da9a"
},
"shop:ticket_transfer_approval": {
"href": "https://shopping-api-docs.paylogic.com/ticket-transfer-approvals/23c4aa75abfe41c2bf2049f189ec9db7"
},
"shop:eticket": {
"href": "https://download.paylogic.nl/download/eticket/Hj786GAGSHkWmRDu58uoGZpMmEJhj6r0BpmfmdEx_Ps"
},
"shop:personalization_request": []
},
"subproduct": {
"fr": "",
"en": "",
"nl": "",
"pt": "",
"de": "",
"tr": "",
"es": ""
},
"personalization_form": null,
"consumer": {
"phone_number": "(641)056-7761",
"city": "Howeborough",
"first_name": "Brenda",
"last_name": "Mann",
"realm": "bc3ec5dc97f0437f81b1f944e9274f2e",
"language": "en",
"gender": 2,
"state": "CT",
"date_of_birth": "1995-02-04",
"postal_code": "60807",
"address": "221 White Pine",
"country": "NL",
"email": "michaelconnerVVwcgyxHO@king.com"
},
"personalization_end": null
},
{
// omitted: second ticket data
}
]
}
}
A ticket transfer approval can be created so a consumer can cancel the sale of his ticket. If a consumer cancels his or her approval then the ticket can no longer be transferred to a new consumer.
[GET] https://shopping-api.paylogic.com/ticket-transfer-approvals/b3689a893a164abaaf93407bca5ef278
The server will respond with the same fields as when creating a transfer approval.
Cancelling a ticket transfer is currently not possible using the Shopping Service API. When a ticket transfer is created, our system will send the owners of the original tickets an email with a link where they can cancel the transfer. It’s not possible to cancel a transfer approval for tickets that have completed the transfer.