Settle a group-checkout share over the processor rail
const url = 'https://quikstik-core.fly.dev/g/example/pay';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"provider":"example","instrument_token":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://quikstik-core.fly.dev/g/example/pay \ --header 'Content-Type: application/json' \ --data '{ "provider": "example", "instrument_token": "example" }'Settles the payer’s group-checkout share addressed by the capability token — money-only:
seats stay on the parent booking. Token-authed (no tenant/bearer). The amount is
never taken from the payer: it is the server-priced group share. The payer supplies only
the processor and a tokenized instrument; the processor reference and settled amount are
returned. Fail-closed: 503 when no backend is wired.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Opaque, unguessable group-checkout capability token.
Request Bodyrequired
Section titled “Request Bodyrequired”What the payer supplies to settle their share. The amount is never taken from the payer — it is the server-priced group share.
object
Processor provider (e.g. stripe, finix).
Tokenized payment instrument for this share.
Example generated
{ "provider": "example", "instrument_token": "example"}Responses
Section titled “Responses”Share settled
object
Processor reference for the settled charge.
Settled amount, in minor units.
Example generated
{ "processor_ref": "example", "amount_minor": 1}Malformed request body (missing provider or instrument token)
No durable backend is wired for this operation (fail-closed)
object
Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).
Example
{ "reason": "sold_out"}