OZozav
Customers

Record acceptance of a terms session

Records that your end user accepted the terms of the session, together with the evidence of that acceptance. You collect the acceptance in your own flow; this call is your attestation of it, and OZAV stores it against the terms version that was in force when the session was created.

Idempotent: repeating the call returns the same result and never overwrites the original evidence. The session token is not returned.

After a 200, submit the same terms_session_id to POST /customers.

post/customers/terms-sessions/accept

Request

  • Base URL
    https://developers.ozav.io/v2
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

terms_session_idstring required

The id returned by POST /customers/terms-sessions.

accepted_atstring date-time

When they accepted. ISO-8601 with an explicit UTC offset, not in the future. Defaults to the time of this call.

ip_addressstring
user_agentstring

Response

Acceptance recorded

idstring

The session token, prefixed ts_. Returned only on creation - OZAV stores just its hash. Persist it; it is never returned again, not even on an idempotent replay.

object'terms_session' required
status'pending' | 'accepted' required

pending until you record the acceptance; only accepted satisfies POST /customers. There is no hosted page in between, so there is no intermediate state.

terms_urlstring uri required

The terms to present to your end user.

terms_versionstring required

The version in force when the session was created. Acceptance is recorded against this version, not the current one.

expires_atstring date-time required
accepted_atstring date-time

Present once the acceptance has been recorded.

Changes

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