Overview

PayShare is an API-driven split-payment platform. One person (the host) starts a session; others join via link or QR and each pays their share. No one is charged until everyone has paid (all-or-nothing). Funds go to your connected payout account.

Use cases

Restaurant bills, group tickets, shared rides, event bookings, any checkout where multiple people split a total.

Integration model

Your backend creates a session via API and redirects the host to PayShare's hosted flow. The host configures the split and shares one link/QR. Participants open that link and pay. Handle completion only via webhook—the webhook is the only source of truth for marking orders paid. Success and cancel URLs are for user experience only.

Flow in short

1. Backend: POST /api/v1/payments/sessions with integrationId, amount, currency, unconfigured: true.
2. Redirect host to /pay/{sessionId}?host=1&hostToken={hostToken} (from response).
3. Host sets participant count and split, then shares the link from the hub.
4. Participants pay at /pay/{sessionId}?participant=...&token=....
5. When all have paid, PayShare sends a webhook (POST to your Webhook URL). Use the webhook as the only source of truth to mark the order paid and trigger fulfilment. The redirect to your successUrl is for the thank-you page only.

Docs nav: Quickstart → API Reference → SDK → Webhooks → Error Codes → Rate Limits → Testing → Recipes → For AI Assistants → Integration reference (booking systems).