Developer documentation
Integrate PayShare split-pay on your own payment rails (Stripe, Adyen, etc.). PayShare orchestrates the split; you capture funds and report outcomes.
PayShare is an API-driven split-payment platform. A host starts a session; guests join via link or QR and each pays their share. Funds stay on your PSP — PayShare never holds your Stripe keys.
Recommended flow (Mode 2)
- Your backend POST /api/v1/payments/sessions (amount, currency, merchantOrderRef, optional platformContextId).
- Redirect the host to PayShare hosted UI (sessionUrl from response).
- On Pay, PayShare POSTs signed create-payment to your server; you return a PSP redirectUrl (e.g. Stripe Checkout).
- After each payer completes on your PSP, your stripe-success bridge calls record-payment, then 302 back to PayShare.
- When all slots are paid, PayShare emits PAYSHARE_SESSION_COMPLETED — fulfil the order once, using eventId for idempotency.
What you build
| Piece | Owner |
|---|---|
| Session create (API key) | Your server |
| Create-payment route (HMAC verify → Checkout URL) | Your server |
| Stripe success bridge (retrieve → record-payment → 302) | Your server |
| Completion webhook handler | Your server |
| Split UI (host hub, guest join, pay) | PayShare hosted app |
App URLs
- API base: https://app.payshare.nz
- Partner dashboard & Integration Wizard: https://app.payshare.nz/partner
- Never send PAYSHARE_API_KEY to the browser.