Terms of Service

You should make your customers accept BlindPay terms of service before initiating their KYC process.

What is the terms of service?

BlindPay's Terms of Service is a legal agreement that must be accepted by your customers before creating a receiver. This acceptance is required for regulatory compliance and allows BlindPay to legally provide services such as generating blockchain wallets and creating virtual accounts on behalf of your customers.

The terms can only be accepted by users accessing the BlindPay URL https://app.blindpay.com on the client side, so all requests from servers will be ignored.

Generating terms of service url

Before generating a terms of service url, you need to:

Remember: replace YOUR_SECRET_TOKEN with your API key and in_000000000000 with your instance ID.

Remember: we only accept uuid on the idempotency_key field.

cURL

curl --request POST \
  --url https://api.blindpay.com/v1/e/instances/in_000000000000/tos \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "idempotency_key": "<your_uuid>"
  }'

After you do this request, the API will return a url with the following query parameters:

URL Example

https://app.blindpay.com/e/terms-of-service?session_token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZGVtcG90ZW5jeV9rZXkiOiI1ZDhiMTQ5ZS1hNTVkLTRiNWItYThmOC03YzRmYTMxNWY4NTQiLCJleHAiOjE3NDI3OTk5MjcsImlhdCI6MTc0Mjc5OTgwN30.gP5imRCt_Ws-SFD7Pc8HRiGooxGM8pd_hXWUEcwKE0I&idempotency_key=5d8b149e-a55d-4b5b-a8f8-7c4fa315f854&redirect_url=

Param	Required	Example
session_token	yes	eyJ0eXAi...E0I (jwt)
idempotency_key	yes	5d8b149e-a55d-4b5b-a8f8-7c4fa315f854 (uuid)
redirect_url	no	https://blindpay.com/
receiver_id	no	re_000000000000 (mandatory for accepting a new TOS version)

We strongly recommend adding a redirect_url parameter. When users accept the terms of service, they will be automatically redirected back to your application, creating a seamless user experience.

Accepting terms of service

After the user accepts the terms of service, we will redirect them to the redirect_url and automatically add a query parameter tos_id.

You need to use this tos_id when creating a receiver.

You'll also receive a webhook event tos.accept when the terms of service is accepted. See the payload here.

Accepting a new version of terms of service

If BlindPay updates the terms of service, all requests to payout quote and payin quote endpoint will return an error with message please_accept_terms_of_service.

If you receive this, please generate a new terms of service and make sure to set the receiver_id parameter on the url returned.

After the customer accepts the new version of terms of service, all quotes endpoints won't return the error anymore.

Instances

Receivers

On this page