Create Withdraw Setting
POST/utils/user-withdraw-settings
Create a new withdraw setting for the user.
Request
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR
, en-US
]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
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
- DailyUserWithdrawSettingDto
- WeeklyUserWithdrawSettingDto
- MonthlyUserWithdrawSettingDto
- BalanceUserWithdrawSettingDto
Transaction type tag.
Possible values: [CNPJ
, CPF
, PHONE
, EMAIL
, EVP
]
Pix key type.
Pix key.
Pix key document related (CPF or CNPJ).
Possible values: [DAILY
, WEEKLY
, MONTHLY
, BALANCE
]
Withdraw settings type.
data object required
Withdraw configuration data (based on type)
Withdraw settings balance in cents, minimum 100.
Total available balance for withdraw (if withdraw settings type is DAILY, WEEKLY or MONTHLY).
Withdraw settings balance in cents, minimum 100.
Total available balance for withdraw (if withdraw settings type is DAILY, WEEKLY or MONTHLY).
Possible values: [MONDAY
, TUESDAY
, WEDNESDAY
, THURSDAY
, FRIDAY
, SATURDAY
, SUNDAY
]
Week day of withdraw (if withdraw settings type is WEEKLY).
Withdraw settings balance in cents, minimum 100.
Total available balance for withdraw (if withdraw settings type is DAILY, WEEKLY or MONTHLY).
Month day of withdraw (if withdraw settings type is MONTHLY).
Withdraw settings balance in cents, minimum 100.
Responses
- 201
- 400
- 422
User withdraw settings created successfully.
- application/json
- Schema
- Example (from schema)
Schema
User withdraw settings id.
Possible values: [ACTIVE
, DEACTIVE
]
User withdraw settings state.
Possible values: [DAILY
, WEEKLY
, MONTHLY
, BALANCE
]
Withdraw settings type.
Withdraw settings balance.
Total available balance for withdraw (if withdraw settings type is DAILY, WEEKLY or MONTHLY).
Month day of withdraw (if withdraw settings type is MONTHLY).
Possible values: [MONDAY
, TUESDAY
, WEDNESDAY
, THURSDAY
, FRIDAY
, SATURDAY
, SUNDAY
]
Week day of withdraw (if withdraw settings type is WEEKLY).
User wallet id.
Transaction type tag.
Possible values: [CNPJ
, CPF
, PHONE
, EMAIL
, EVP
]
Pix key type.
Pix key.
Pix key document related (CPF or CNPJ).
Date of created withdraw.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"state": "ACTIVE",
"type": "DAILY",
"balance": 1000000,
"total_available_balance": true,
"day": 10,
"week_day": "MONDAY",
"wallet_id": "3267dfe0-73ee-4421-80e7-0c3a5372fa13",
"transaction_type_tag": "PIXSEND",
"pix_key_type": "CNPJ",
"pix_key": "string",
"pix_key_document": "00000000000",
"created_at": "2025-09-03T22:01:48.455Z"
}
If any required params are missing or has invalid format or type.
If any required params are missing or has invalid format or type.