Sign in
Terms Of Service

Create Passthrough Terms of Service Acceptance

Changed on

For instances with passthrough Terms of Service enabled that collect the acceptance on their own page. Call it from your server right after the customer accepts, with the IP address and User-Agent collected from the customer browser, and use the returned tos_id when creating the customer. The acceptance time is recorded when BlindPay receives the request. Submissions are validated and monitored as set out in the Passthrough Terms of Service Partner Agreement (https://blindpay.com/passthrough-tos-partner-agreement).

post/v1/instances/{instance_id}/tos/passthrough

Request

  • Base URL: https://blindpay.com (the document declares no server; this is the origin it was published from)
  • URL: https://blindpay.com/v1/instances/{instance_id}/tos/passthrough
  • Auth: HTTP bearer

Path parameters

instance_idstring required
Example:in_000000000000

Request body

idempotency_keystring uuid required
customer_idstring nullable
ip_addressstring ip required

Public IP address of the customer device, as seen by your edge. Not the IP address of your servers.

user_agentstring required

The complete, unmodified User-Agent header sent by the browser of the customer

Example request

{
  "idempotency_key": "123e4567-e89b-12d3-a456-426614174000",
  "customer_id": "re_000000000000",
  "ip_address": "191.34.12.8",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
}

Response

Terms of service acceptance recorded

tos_idstring required
idempotency_keystring uuid required
customer_idstring nullable
version'1.0.0' | '1.0.1' nullable

Example response

{
  "tos_id": "to_000000000000",
  "idempotency_key": "123e4567-e89b-12d3-a456-426614174000",
  "customer_id": "re_000000000000",
  "version": "1.0.0"
}

Changes