circle-exclamation
This documentation is currently under development. Certain sections are not yet complete and will be added shortly.

Yurplan

Process Yurplan order confirmation

post
/api/{tenantId}/webhooks/listeners/yurplan/{eventId}/order/confirmed

Webhook called when an event ticket order is confirmed and payment processed in Yurplan. Creates wallet passes for each ticket in the order.

Order Processing

  1. Yurplan confirms payment and finalizes order

  2. Webhook sends customer identifier and ticket list

  3. System emits order validated event (for CRM sync if needed)

  4. Creates wallet pass for each ticket with unique token

Pass Identification

Tickets are identified by: yurplan.ticketId = {eventId}|{ticketToken} This composite key ensures uniqueness across events and platforms.

Use Cases

  • Generate event tickets as digital wallet passes

  • Automatic mobile ticket delivery

  • QR code for gate entry

  • Event updates and reminders via pass

Path parameters
eventIdstringRequired

Yurplan event identifier.

tenantIdstringRequired
Body
Responses
chevron-right
200

Order processed and passes created.

No content

post
/api/{tenantId}/webhooks/listeners/yurplan/{eventId}/order/confirmed

No content

Handle Yurplan ticket cancellation

post
/api/{tenantId}/webhooks/listeners/yurplan/{eventId}/ticket/canceled

Called when a ticket is cancelled (refund or customer request). Updates pass status and removes from customer wallet if needed.

Cancellation Handling

  • Marks pass as cancelled/expired

  • Triggers push notification for app users

  • Updates customer transaction history

  • May trigger refund workflows

Path parameters
eventIdstringRequired

Yurplan event identifier.

tenantIdstringRequired
Body
Responses
chevron-right
200

Cancellation processed.

No content

post
/api/{tenantId}/webhooks/listeners/yurplan/{eventId}/ticket/canceled

No content

Handle Yurplan ticket check-in

post
/api/{tenantId}/webhooks/listeners/yurplan/{eventId}/ticket/checked

Called when ticket is scanned/checked in at event entry point. Updates pass status to indicate event attendance.

Check-in Processing

  • Marks pass as used/redeemed

  • Updates audit trail with entry timestamp

  • Triggers post-event marketing workflows

  • May enable post-event upsell or feedback requests

Analytics

Check-in data contributes to:

  • Event attendance metrics

  • Customer journey tracking

  • Pass engagement measurement

Path parameters
eventIdstringRequired

Yurplan event identifier.

tenantIdstringRequired
Body
Responses
chevron-right
200

Check-in processed.

No content

post
/api/{tenantId}/webhooks/listeners/yurplan/{eventId}/ticket/checked

No content

Last updated