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. |
| sale | Sale | Optional. A sale reference to which to offer these tickets. You can get this reference from transfer_sale of a ticket. |
| asking_price | Amount | Optional. Asking price for the transfer. |
[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. Note that only a small subset of the ticket is exposed. |
| asking_price | Amount | Asking price for the transfer. |
| type | String | The type of the transfer. (waiting_list/resale/name_change) |
| 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",
"asking_price": "",
"_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": [
{
"_links": {
"self": {
"href": "https://shopping-api-docs.paylogic.com/tickets/a2e37ee17474417a87259b02b674da9a"
}
},
"complete_ticket_transfer_url": "",
"target_order_status": 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.