Accept Terms of Use

POST 
/card/onboarding/terms-of-use

Tag: api-users-post-accept-terms-of-useDescription: Accept terms of use for the customer. The customer must be finished onboarding.

Request

Header Parameters

x-transaction-uuid stringrequired

The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.

x-wallet-uuid string

Sender Wallet UUID (if empty, your default Wallet UUID will be settled)

nonce stringrequired

The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

x-lang string

Possible values: [pt-BR, en-US]

Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

x-product-uuid string

The product ID is a UUID (v4) used to identify the Z.ro product configuration.

x-product-target-user-uuid string

The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

application/json

Body

required

fingerprint stringrequired

Fingerprint.

documents string[]required

Documents.

Responses

200

Accept terms of use successfully.

application/json

Schema

Schema

id stringrequired

Card Onboarding ID.

user_id stringrequired

User ID.

onboarding_id stringrequired

Onboarding ID.

status objectrequired

Card Onboarding Status.

created_at date-timerequired

Card Onboarding Created At.

updated_at date-timerequired

Card Onboarding Updated At.

Example (from schema)

{
  "id": "12345678-1234-5678-1234-567812345678",
  "user_id": "12345678-1234-5678-1234-567812345678",
  "onboarding_id": "12345678-1234-5678-1234-567812345678",
  "status": "pending",
  "created_at": "2025-06-23T19:45:46.129Z",
  "updated_at": "2025-06-23T19:45:46.129Z"
}

400

If any required params are missing or has invalid format or type.

401

User authentication failed.

422

If any required params are missing or has invalid format or type.

Authorization: http

name: bearertype: httpscheme: bearerbearerFormat: JWT

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'https://docs.zrobank.io/card/onboarding/terms-of-use' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "fingerprint": "ZXhhbXBsZS1zdHJpbmctdG8tZW5jb2Rl",
  "documents": [
    {
      "documentUrl": "https://example.com/document.pdf",
      "type": "TERMS_OF_USE"
    }
  ]
}'

Request Collapse all

Auth

Bearer Token

Parameters

x-transaction-uuid — headerrequired

nonce — headerrequired

x-wallet-uuid — header

x-lang — header

---pt-BRen-US

x-product-uuid — header

x-product-target-user-uuid — header

Body required

{
  "fingerprint": "ZXhhbXBsZS1zdHJpbmctdG8tZW5jb2Rl",
  "documents": [
    {
      "documentUrl": "https://example.com/document.pdf",
      "type": "TERMS_OF_USE"
    }
  ]
}

ResponseClear

Click the Send API Request button above and see the response here!