payments

Create Subscription

Create or update subscription with bonus days logic.

Business Rules:

  • First subscription gets bonus days (Pro: +15, Premium: +30)
  • Subsequent renewals are standard 30-day cycles
  • Upgrades allowed mid-cycle (immediate effect)
  • Downgrades NOT allowed mid-cycle (must wait for next billing)
post/payments/subscribe

Request

  • Base URL
    https://api.oxlo.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.oxlo.ai/payments/subscribe
  • Auth
    HTTP bearer

Request body

planstring required
payment_method_idstring required
auto_renewboolean
idempotency_keystring required

Response

Successful Response

idstring required
planstring required
statusstring required
current_period_endstring date-time required
effective_end_datestring date-time nullable
bonus_daysinteger
auto_renewboolean required
client_secretstring nullable
requires_actionboolean
payment_statusstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.