Create Bank Billet Deposit Batch Item
POSTTag: api-paas-post-banking-billet-pix-deposit-batch-itemDescription: Create a new bank billet deposit batch item./banking/billet-pix-deposit-batch-items
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
Banking billet deposit batch ID
Payer name.
Payer document.
Payer email.
Description.
Amount specified in Brazilian Real (R$) cents.
Interest value specified in percentage by month.
Fine value (in (R$) amount or percentage).
Possible values: [AMOUNT, PERCENTAGE]
Fine type.
Discount value (in (R$) amount or percentage).
Possible values: [AMOUNT, PERCENTAGE]
Discount type.
Due date. Format: YYYY-MM-DD.
Responses
- 201
- 400
- 401
- 422
Banking billet deposit batch item created.
- application/json
- Schema
- Example (from schema)
Schema
Bank billet deposit batch item ID.
Bank billet deposit batch ID.
Possible values: [BILLET_WAITING, BILLET_CREATED, BILLET_FAILED]
Bank billet deposit batch item status.
Payer name.
Payer document.
Payer email.
Description.
Amount specified in Brazilian Real (R$) cents.
Interest value specified in percentage.
Fine value (converted to R$ cents).
Discount value (converted to R$ cents).
Due date.
Creation date.
{
"id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"banking_billet_pix_deposit_batch_id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"status": "BILLET_WAITING",
"payer_name": "John Doe",
"payer_document": "12345678900",
"payer_email": "example@example.com",
"description": "Payment for services",
"amount": 1299,
"interest_perc_value": 1.01,
"fine_value": 202,
"discount_value": 1001,
"due_date": "2025-12-26T17:17:50.625Z",
"created_at": "2025-12-26T17:17:50.625Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.