Consent

Record consent (business)

Records the business's acceptance of the Payment Account terms, given by its director / primary user in your application. Consent is recorded once for the business entity, not per member.

Send the real businessId — not a sub-admin id.

Semantics match the consumer endpoint: re-posting replaces the record wholesale, "accepted": false withdraws consent, ip defaults to the request's source IP (pass the end user's IP explicitly from your backend), and dateAccepted defaults to the server time.

post/business/payment-account/consent

Request

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

Request body

businessIdstring uuid required

The business recording consent. Send the real businessId, not a sub-admin id.

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

{
  "businessId": "1c2f6f0a-9c1e-4f57-9f1e-6a2b7c1d0e2f",
  "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.

businessIdstring uuid required

Example response

{
  "businessId": "1c2f6f0a-9c1e-4f57-9f1e-6a2b7c1d0e2f",
  "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.