Partner create-payment
Signed POST from PayShare when a host or guest taps Pay.
Configure partnerCreatePaymentUrl and partnerCreatePaymentSigningSecret on your integration. PayShare calls your URL with a signed JSON body; you return { redirectUrl } to your PSP checkout.
Request headers
- Content-Type: application/json
- X-PayShare-Signature — HMAC-SHA256 (same pattern as completion webhooks)
- X-PayShare-Event-Id — UUID; replay-safe idempotency key
Key body fields
| Field | Notes |
|---|---|
| role | host or participant |
| shareAmountMinor | Charge this amount (string integer) |
| sessionId / participantId | For record-payment later |
| platformContextId | Echoed from session — map to Stripe acct_… on your server |
| payshareHostResumeUrl | Host only — Stripe cancel_url and post-pay redirect |
| payshareParticipantReturnUrl | Guest — post-pay redirect after record-payment |
| payshareReturnId | Guest only; null for host |
Response
{ "redirectUrl": "https://checkout.stripe.com/c/pay/cs_..." }Return HTTP 200 with HTTPS redirectUrl. Timeouts are ~15s. Persist PayShare fields in Checkout metadata for your success bridge.