Skip to main content
Version: 1.0.0

Stripe Integration API

Payment endpoints for relay's Stripe integration. Allows partners to collect rental application fees via Stripe Checkout.

Authentication​

All requests require an X-API-KEY header provided by relay during partner onboarding.

Duplicate Payment Prevention​

A renter who has successfully paid within the last 30 days cannot create a new checkout session. Attempts to do so will return a 409 Conflict response.

Amount Handling​

  • If amount is omitted, it defaults to the relay fee configured for your account
  • If amount is provided, it must be greater than or equal to the relay fee
  • Stripe processing fees are calculated and applied automatically

Authentication​

API key provided by relay during partner onboarding. Include this header in every API request (except webhooks). A missing or invalid key returns 403 with errorCode 324 ("Invalid client secret.").

Security Scheme Type:

apiKey

Header parameter name:

X-API-KEY