Create Bank Billet Pix Deposit Batch
POSTTag: api-baas-post-banking-billet-pix-deposit-batchDescription: Create a new bank billet pix deposit batch by uploading a CSV file with the required information. The CSV must contain the following columns: payer_name, payer_document, description, amount, due_date. Optional columns: payer_email, interest_perc_value, fine_value, discount_value, fine_type, discount_type./v1/banking/billet-pix-deposit-batches
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.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
- application/json
Body
required
Batch name.
Pix key.
Whether the billet PDF will be personalized or not.
Email send date. Format: YYYY-MM-DD.
CSV file ID
Responses
- 201
- 400
- 401
Banking billet pix deposit batch created.
- application/json
- Schema
- Example (from schema)
Schema
Bank billet deposit batch ID.
Batch name.
Possible values: [UNDER_ANALYSIS, VALIDATED, REJECTED, GENERATED, FAILED]
Bank billet deposit batch status.
Whether the billet PDF is personalized or not.
Pix key.
File ID of uploaded CSV.
Email send date.
Creation date.
{
"id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"batch_name": "Batch January 2025",
"status": "UNDER_ANALYSIS",
"personalized": true,
"pix_key": "c6537646-a972-4531-97a3-18002de8219e",
"file_id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"email_send_date": "2025-02-01",
"created_at": "2026-03-26T14:02:58.319Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.