/
Order Notifications (Webhooks)

Order Notifications (Webhooks)

Owned by J Cobb
Last updated: Jan 15, 2025 by Cole Gettis
23 min read





Description

Notifications System can be used to update you about new orders as well as changes to an order.



Webhooks are sent as an application/x-www-form-urlencoded POST to a URL which you provide to TEvo. All webhooks will include an order_group_id, recipient, event_type, and body.

 

We have notifications that apply to both Sellers and Buyers and the recipient parameter indicates whether you are the buyer or the seller for the given order.

 

If you wish to use webhooks in Sandbox or Production contact our support team to provide us the URL.

 

 

 

 

You will only receive Buyer Notifications if you are creating Buy Orders, which most groups should not be doing.

Seller Notifications

New Order/Fraud Response Received

As soon as a new order for your tickets is received we will send these notifications. This should reduce your reliance on checking Orders / Index for new orders, and once you have confirmed this notification is working for you we suggest that only check Orders / Index every 5 minutes or so as a fallback.

recipient

event_type

body

recipient

event_type

body

seller

order_created

fraud_response_received

{ "id": 147277, "created_by": { "type": "UserCredential", "label": "Token 1372882898", "office_id": 1752, "brokerage_id": 1756 }, "updated_at": "2016-06-01T14:40:04Z", "partner": false, "seller_rejection_reason": null, "service_fee": "0.0", "patron_type": "Office", "was_auto_pended": null, "seller_cancellation_notes": null, "seller_is_pos": false, "url": "/orders/147277", "created_at": "2016-06-01T14:40:01Z", "discount": "0.0", "was_auto_accepted": null, "spec": false, "refunded": "0.0", "pending_non_refund_payments_total": 0, "buyer_rejection_reason": null, "seller_state": "pending", "substitutions": [ ], "was_auto_canceled": null, "oth_created": false, "created_by_ip_address": null, "billing_address": { "region": "NY", "street_address": "110 W 30th Street", "country_code": "US", "extended_address": "Seventh Floor", "label": null, "longitude": null, "locality": "New York", "po_box": false, "primary": false, "latitude": null, "postal_code": "10001", "id": 8506 }, "buyer_cancellation_notes": null, "kount_score": null, "completed_non_refund_payments_total": 0, "penalties_total": 0.0, "order_type": "direct", "payments": [ ], "kount_notifications": null, "subtotal": "0.0", "balance": "0.0", "oid": "44442-147277", "buyer_state": "pending", "shipment_snapshot": [ { "region": null, "street_address": null, "type": "Eticket", "country_code": null, "extended_address": null, "label": null, "available": null, "carrier": null, "locality": null, "po_box": null, "email_address": "dgainor@ticketevolution.com", "company": null, "name": null, "postal_code": null, "id": 61621, "phone_number": null } ], "kount_status": null, "seller": { "pcc_code": null, "type": "Office", "address": { "region": "OH", "street_address": "6555 Wilson Mills Road", "country_code": "US", "extended_address": "Suite 101", "label": null, "longitude": null, "locality": "Mayfield Village", "po_box": false, "primary": false, "latitude": null, "postal_code": "44143", "id": 7509 }, "url": "/offices/618", "brokerage": { "created_at": "2010-08-06T19:28:41Z", "abbreviation": "Amazing", "url": "/brokerages/117", "updated_at": "2016-06-01T14:38:08Z", "master": false, "natb_member": true, "email": "sales@amazingtickets.com", "name": "Amazing Tickets", "id": 117 }, "name": "Main Office", "email_address": "sales@amazingtickets.com", "evopay": true, "phone": "216-591-1800", "id": 618 }, "items": [ { "ticket_group": { "external_notes": "First row.", "tickets": [ { "purchase_order_id": null, "seat": null }, { "purchase_order_id": null, "seat": null } ], "remote_id": "58222", "wholesale_price": "27.0", "seats": [ ], "event": { "occurs_at": "2016-06-01T18:10:00Z", "url": "/events/915177", "name": "Texas Rangers at Cleveland Indians", "id": "915177", "venue": { "address": { "region": "OH", "locality": "Cleveland" }, "name": "Progressive Field", "id": "738" } }, "in_hand": "true", "url": "/ticket_groups/277917904", "format": "Eticket", "quantity": 2, "in_hand_on": "2016-06-01", "office_name": "Main Office", "retail_price": "27.0", "instant_delivery": true, "section": "113", "row": "A", "id": "277917904", "brokerage_name": "Amazing Tickets", "brokerage_id": "117", "office_id": "618" }, "eticket_updated_at": null, "needs_sub": false, "eticket_finalized": null, "eticket_available": false, "price": "27.0", "order_item_link_id": 124012, "seats": [ ], "eticket_pdf_pages": null, "created_at": "2016-06-01T14:40:01Z", "order_id": 147277, "cost": "", "eticket_file_size": null, "eticket_finalized_at": null, "quantity": 2, "needs_eticket": true, "eticket_downloaded_at": null, "updated_at": "2016-06-01T14:40:01Z", "eticket_thumbnails": [ ], "eticket_delivery": true, "has_spec_tickets": false, "id": 124012, "eticket_downloaded_by": null, "order_item_id": 120145 } ], "seller_cancellation_reason": null, "state": "pending", "kount_transactions": null, "tax": "0.0", "shipping_address": null, "buyer": { "pcc_code": null, "type": "Office", "address": { "region": "NY", "street_address": "110 W 30th Street", "country_code": "US", "extended_address": "Seventh Floor", "label": null, "longitude": null, "locality": "New York", "po_box": false, "primary": false, "latitude": null, "postal_code": "10001", "id": 8506 }, "url": "/offices/6", "brokerage": { "created_at": "2010-07-28T12:02:16Z", "abbreviation": "Ticket Evolution", "url": "/brokerages/61", "updated_at": "2016-05-17T16:12:09Z", "master": true, "natb_member": true, "email": "billing@ticketevolution.com", "name": "Ticket Evolution", "id": 61 }, "name": "Main Office", "email_address": "orders@ticketevolution.com", "evopay": true, "phone": "201-499-0833", "id": 6 }, "returns_total": 0.0, "substitute_order_link_id": null, "notes": [ ], "pending_balance": "54.0", "is_new_inventory": false, "minfraud_response": null, "child_orders": [ ], "seller_rejection_notes": null, "spec_fulfilled": false, "buyer_cancellation_reason": null, "shipping": "0.0", "fee": "1.62", "additional_expense": "0.0", "placer": { "created_at": "2013-07-03T20:21:38Z", "url": "/users/2335", "updated_at": "2016-06-01T14:33:49Z", "office": { "pcc_code": null, "type": "Office", "address": { "region": "New Jersey", "street_address": "333 Washington Street", "country_code": "US", "extended_address": "Suite 302", "label": null, "longitude": null, "locality": "Jersey City", "po_box": false, "primary": false, "latitude": null, "postal_code": "07302", "id": 495479 }, "url": "/offices/1752", "brokerage": { "created_at": "2013-07-03T20:20:53Z", "abbreviation": "Core", "url": "/brokerages/1756", "updated_at": "2016-06-01T14:33:49Z", "master": false, "natb_member": false, "email": "dgainor@ticketevolution.com", "name": "Core Tickets", "id": 1756 }, "name": "Core", "email_address": "test@coretickets.com", "evopay": true, "phone": "201-499-0833", "id": 1752 }, "brokerage": { "created_at": "2013-07-03T20:20:53Z", "abbreviation": "Core", "url": "/brokerages/1756", "updated_at": "2016-06-01T14:33:49Z", "master": false, "natb_member": false, "email": "dgainor@ticketevolution.com", "name": "Core Tickets", "id": 1756 }, "email": "Brendan@core.com", "name": "BDawg", "phone": { "extension": null, "number": "111-222-3333" }, "id": 2335 }, "shipments": [ { "airbill": "/airbills/original/missing.png", "ship_to_company_name": null, "type": "Eticket", "shipment_snapshot": { "region": null, "street_address": null, "type": "Eticket", "country_code": null, "extended_address": null, "label": null, "available": null, "carrier": null, "locality": null, "po_box": null, "email_address": "dgainor@ticketevolution.com", "company": null, "name": null, "postal_code": null, "id": 61621, "phone_number": null }, "ship_to_name": null, "service_type_display": null, "tracking_number": null, "available": false, "cost": "0.0", "state": "pending", "url": "/shipments/61621", "signature_type": "", "carrier": null, "updated_at": "2016-06-01T14:40:01Z", "items": [ { "ticket_group": { "external_notes": "First row.", "remote_id": "58222", "wholesale_price": "27.0", "seats": [ null, null ], "event": { "occurs_at": "2016-06-01T18:10:00Z", "name": "Texas Rangers at Cleveland Indians", "id": "915177", "venue": { "address": { "region": "OH", "locality": "Cleveland" }, "name": "Progressive Field", "id": "738" } }, "quantity": 2, "retail_price": "27.0", "section": "113", "row": "A", "id": "277917904", "office_id": "618" }, "price": "27.0", "eticket_available": false, "quantity": 2, "updated_at": "2016-06-01T14:40:01Z", "eticket_downloaded_at": "", "eticket_delivery": true, "id": 120145, "eticket_downloaded_by": null } ], "service_type": "LEAST_EXPENSIVE", "name": null, "tracking_url": null, "id": 61621, "phone_number": null, "courier_company": null } ], "consignment": false, "client": null, "isPO": false, "instructions": null, "reference": null, "buyer_rejection_notes": null, "total": "0.0" }

Airbill Uploaded

When a buyer has purchased Physical tickets to be shipped and used the delivery type ProvidedAirbill to indicate they would upload an airbill we will send this notification when the airbill is uploaded and is ready for you to retrieve using Shipments / Get Airbill or manually via Core.

recipient

event_type

body

recipient

event_type

body

seller

airbill_uploaded

{ "order": { "url": "/orders/147294", "id": 147294 }, "phone_number": null, "type": "ProvidedAirbill", "tracking_number": "342352352523", "updated_at": "2016-06-01T15:53:50Z", "address": null, "service_type": "LEAST_EXPENSIVE", "courier_company": null, "signature_type": "", "created_at": "2016-06-01T15:50:02Z", "url": "/shipment/61627", "shipment_snapshot": { "phone_number": null, "type": "ProvidedAirbill", "region": null, "street_address": null, "extended_address": null, "po_box": null, "label": null, "available": null, "email_address": "dgainor@ticketevolution.com", "locality": null, "name": null, "country_code": null, "company": null, "id": 61627, "carrier": null, "postal_code": null }, "state": "pending", "airbill": "http://s3.amazonaws.com/media.sandbox.ticketevolution.com/deliveries/airbills/61627/original.pdf?1464796430", "ship_to_name": null, "available": true, "email_address": { "updated_at": "2016-06-01T15:50:02Z", "address": "dgainor@ticketevolution.com", "url": null, "label": null, "id": 194572 }, "notes": null, "ship_to_company_name": null, "name": null, "items": [ { "price": "30.0", "quantity": 4, "ticket_group": { "wholesale_price": "30.0", "retail_price": null, "url": "/ticket_groups/298706863", "event": { "url": "/events/1019897", "venue": { "address": { "region": "OH", "locality": "Cleveland" }, "url": "/venues/294", "name": "FirstEnergy Stadium - Cleveland", "id": "294" }, "event_tbd": null, "occurs_at": "2016-06-05T12:30:00Z", "name": "Japan at USA Women's National Soccer Team", "id": "1019897" }, "office_id": "618", "remote_id": "63407", "quantity": null, "id": "298706863" }, "id": 120151, "order_item_link_id": 124029 } ], "residential": null, "service_type_display": "", "cost": "0.0", "id": 61627, "carrier": "fedex", "broker_phone_number": null }



Delivery Updated

When the delivery has detail or attribute changes post-order (email address, name, etc…), we will send this notification.

recipient

event_types

body

recipient

event_types

body

seller

delivery_updated

{ "order": { "url": "/orders/147294", "id": 147294 }, "phone_number": null, "type": "ProvidedAirbill", "tracking_number": null, "updated_at": "2016-06-01T15:50:02Z", "address": null, "service_type": "LEAST_EXPENSIVE", "courier_company": null, "signature_type": "", "created_at": "2016-06-01T15:50:02Z", "url": "/shipment/61627", "shipment_snapshot": { "phone_number": null, "type": "ProvidedAirbill", "region": null, "street_address": null, "extended_address": null, "po_box": null, "label": null, "available": null, "email_address": "dgainor@ticketevolution.com", "locality": null, "name": null, "country_code": null, "company": null, "id": 61627, "carrier": null, "postal_code": null }, "state": "pending", "airbill": "", "ship_to_name": null, "available": false, "email_address": { "updated_at": "2016-06-01T15:50:02Z", "address": "dgainor@ticketevolution.com", "url": null, "label": null, "id": 194572 }, "notes": null, "ship_to_company_name": null, "name": null, "items": [ { "price": "30.0", "quantity": 4, "ticket_group": { "wholesale_price": "30.0", "retail_price": null, "url": "/ticket_groups/298706863", "event": { "event_tbd": null, "url": "/events/1019897", "venue": { "address": { "region": "OH", "locality": "Cleveland" }, "url": "/venues/294", "name": "FirstEnergy Stadium - Cleveland", "id": "294" }, "occurs_at": "2016-06-05T12:30:00Z", "name": "Japan at USA Women's National Soccer Team", "id": "1019897" }, "office_id": "618", "remote_id": "63407", "quantity": null, "id": "298706863" }, "id": 120151, "order_item_link_id": 124029 } ], "residential": null, "service_type_display": "", "cost": "0.0", "id": 61627, "carrier": null, "broker_phone_number": null }

 

Order Accepted

When you have Accepted an order we will send this notification.

recipient

event_type

body

recipient

event_type

body

seller

seller_accepted

{ "oid": "44442-147277", "id": 147277, "placer": { "office": { "type": "Office", "evopay": true, "pcc_code": null, "address": { "region": "New Jersey", "street_address": "333 Washington Street", "longitude": null, "extended_address": "Suite 302", "latitude": null, "po_box": false, "label": null, "locality": "Jersey City", "country_code": "US", "id": 495479, "primary": false, "postal_code": "07302" }, "url": "/offices/1752", "email_address": "test@coretickets.com", "name": "Core", "brokerage": { "updated_at": "2016-06-01T14:33:49Z", "created_at": "2013-07-03T20:20:53Z", "natb_member": false, "url": "/brokerages/1756", "master": false, "email": "dgainor@ticketevolution.com", "name": "Core Tickets", "id": 1756, "abbreviation": "Core" }, "id": 1752, "phone": "201-499-0833" }, "updated_at": "2016-06-01T14:33:49Z", "created_at": "2013-07-03T20:21:38Z", "url": "/users/2335", "email": "Brendan@core.com", "name": "BDawg", "brokerage": { "updated_at": "2016-06-01T14:33:49Z", "created_at": "2013-07-03T20:20:53Z", "natb_member": false, "url": "/brokerages/1756", "master": false, "email": "dgainor@ticketevolution.com", "name": "Core Tickets", "id": 1756, "abbreviation": "Core" }, "id": 2335, "phone": { "extension": null, "number": "111-222-3333" } }, "seller_state": "accepted", "shipping": "0.0", "pending_non_refund_payments_total": 0, "consignment": false, "penalties_total": 0.0, "kount_status": null, "order_type": "direct", "seller_rejection_notes": null, "buyer": { "type": "Office", "evopay": true, "pcc_code": null, "address": { "region": "NY", "street_address": "110 W 30th Street", "longitude": null, "extended_address": "Seventh Floor", "latitude": null, "po_box": false, "label": null, "locality": "New York", "country_code": "US", "id": 8506, "primary": false, "postal_code": "10001" }, "url": "/offices/6", "email_address": "orders@ticketevolution.com", "name": "Main Office", "brokerage": { "updated_at": "2016-05-17T16:12:09Z", "created_at": "2010-07-28T12:02:16Z", "natb_member": true, "url": "/brokerages/61", "master": true, "email": "billing@ticketevolution.com", "name": "Ticket Evolution", "id": 61, "abbreviation": "Ticket Evolution" }, "id": 6, "phone": "201-499-0833" }, "tax": "0.0", "url": "/orders/147277", "buyer_cancellation_reason": null, "created_by": { "type": "UserCredential", "office_id": 1752, "brokerage_id": 1756, "label": "Token 1372882898" }, "total": "54.0", "kount_transactions": null, "completed_non_refund_payments_total": "54.0", "instructions": null, "spec": false, "returns_total": 0.0, "pending_balance": "0.0", "buyer_rejection_notes": null, "service_fee": "0.0", "created_at": "2016-06-01T14:40:01Z", "discount": "0.0", "seller_rejection_reason": null, "reference": null, "was_auto_pended": null, "was_auto_accepted": null, "created_by_ip_address": null, "is_new_inventory": false, "seller_cancellation_notes": null, "refunded": "0.0", "buyer_rejection_reason": null, "payments": [ { "type": "evopay", "cvv_response_code": "", "avs_response_code": "", "is_refund": false, "updated_at": "2016-06-01T14:40:05Z", "amount": "54.0", "credit_card": null, "avs_street_address_response": "", "url": "/payments/68654", "created_at": "2016-06-01T14:40:05Z", "state": "completed", "avs_postal_code_response": "", "order_link_id": 147277, "cvv_response": "", "refunded_from_id": null, "performed_by": null, "avs_postal_code_response_code": "", "payment_for_credit_memo_id": null, "credit_memo_id": null, "id": 68654, "check_number": null, "avs_street_address_response_code": "", "avs_response": "" } ], "child_orders": [ ], "fee": "1.62", "updated_at": "2016-06-01T15:31:47Z", "shipments": [ { "phone_number": null, "type": "Eticket", "tracking_number": null, "updated_at": "2016-06-01T14:40:01Z", "service_type": "LEAST_EXPENSIVE", "courier_company": null, "signature_type": "", "url": "/shipments/61621", "shipment_snapshot": { "phone_number": null, "type": "Eticket", "region": null, "street_address": null, "extended_address": null, "po_box": null, "label": null, "available": null, "email_address": "dgainor@ticketevolution.com", "locality": null, "name": null, "country_code": null, "company": null, "id": 61621, "carrier": null, "postal_code": null }, "state": "pending", "airbill": "/airbills/original/missing.png", "ship_to_name": null, "available": false, "tracking_url": null, "ship_to_company_name": null, "name": null, "items": [ { "updated_at": "2016-06-01T14:40:01Z", "eticket_downloaded_at": "", "price": "27.0", "eticket_downloaded_by": null, "quantity": 2, "ticket_group": { "wholesale_price": "27.0", "retail_price": "27.0", "event": { "venue": { "address": { "region": "OH", "locality": "Cleveland" }, "name": "Progressive Field", "id": "738" }, "occurs_at": "2016-06-01T18:10:00Z", "name": "Texas Rangers at Cleveland Indians", "id": "915177" }, "office_id": "618", "seats": [ null, null ], "remote_id": "58222", "quantity": 2, "section": "113", "id": "277917904", "row": "A", "external_notes": "First row." }, "eticket_delivery": true, "eticket_available": false, "id": 120145 } ], "service_type_display": null, "cost": "0.0", "id": 61621, "carrier": null } ], "billing_address": { "region": "NY", "street_address": "110 W 30th Street", "longitude": null, "extended_address": "Seventh Floor", "latitude": null, "po_box": false, "label": null, "locality": "New York", "country_code": "US", "id": 8506, "primary": false, "postal_code": "10001" }, "isPO": false, "balance": "54.0", "patron_type": "Office", "buyer_cancellation_notes": null, "shipment_snapshot": [ { "phone_number": null, "type": "Eticket", "region": null, "street_address": null, "extended_address": null, "po_box": null, "label": null, "available": null, "email_address": "dgainor@ticketevolution.com", "locality": null, "name": null, "country_code": null, "company": null, "id": 61621, "carrier": null, "postal_code": null } ], "spec_fulfilled": false, "notes": [ ], "state": "accepted", "buyer_state": "accepted", "seller_is_pos": false, "minfraud_response": null, "shipping_address": null, "kount_score": null, "was_auto_canceled": null, "items": [ { "eticket_thumbnails": [ ], "needs_eticket": true, "eticket_finalized": null, "has_spec_tickets": false, "eticket_downloaded_at": null, "updated_at": "2016-06-01T14:40:01Z", "eticket_finalized_at": null, "price": "27.0", "needs_sub": false, "created_at": "2016-06-01T14:40:01Z", "order_id": 147277, "seats": [ ], "eticket_updated_at": null, "eticket_downloaded_by": null, "quantity": 2, "order_item_id": 120145, "ticket_group": { "wholesale_price": "27.0", "retail_price": "27.0", "url": "/ticket_groups/277917904", "event": { "url": "/events/915177",