STstriga
Consent

Record consent (consumer)

Records the user's acceptance of the Payment Account terms.

The first acceptance wins: re-posting "accepted": true for a user who already consented leaves the original consent record — including its acceptance date — unchanged. Recording "accepted": false withdraws consent: the user’s third-party transactions are refused from then on.

ip defaults to the source IP of this API request. When calling from your backend — the normal integration pattern — pass the end user's IP explicitly, otherwise your server's IP is recorded on the consent record.

dateAccepted defaults to the server time of the call.

post/user/payment-account/consent

Request

  • Base URL
    https://www.sandbox.striga.com/api/v1
  • URL
    https://www.sandbox.striga.com/api/v1/user/payment-account/consent
  • Auth
    API key in header api-key and API key in header Authorization

Request body

userIdstring uuid required

The user recording consent.

acceptedboolean required

true records acceptance of the Payment Account terms; false withdraws it. Must be a JSON boolean — the string "true" is rejected with a validation error.

termsVersionstring

The version of the terms document you displayed to the user.

termsUristring uri

Where the displayed terms document is hosted.

dateAcceptedstring date-time

ISO 8601 timestamp of the acceptance. Defaults to the server time of the call.

ipstring

The end user's IP address (IPv4 or IPv6). Defaults to the source IP of this API request — pass this explicitly when calling from your backend, otherwise your server's IP is recorded.

Example request

{
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "accepted": true,
  "termsVersion": "2026-08-v1",
  "termsUri": "https://yourapp.example/legal/payment-account-terms",
  "dateAccepted": "2026-09-11T12:00:00.000Z",
  "ip": "198.51.100.9"
}

Response

Consent recorded. The response echoes the stored record.

userIdstring uuid required

Example response

{
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "paymentAccountConsent": {
    "accepted": true,
    "dateAccepted": "2026-09-11T12:00:00.000Z",
    "ip": "198.51.100.9",
    "termsUri": "https://yourapp.example/legal/payment-account-terms",
    "termsVersion": "2026-08-v1"
  }
}

Changes

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