---
title: "Create Boleto Payments"
method: POST
path: "/v2/boleto-payment"
tags: ["Boleto Payment"]
---

# Create Boleto Payments

`POST /v2/boleto-payment`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/boleto-payment`
- Auth: API key in header `Digital-Signature`

Use this route to pay registered boletos generated at Stark Bank or at other financial institutions using the available balance in your Stark Bank account.

## Request body

- object
  - `description` string, required: Text to be displayed in your statement. Min length = 10.
  - `taxId` string, required: Receiver CPF (11 digits formatted or unformatted) or CNPJ (14 digits formatted or unformatted). Example: 012.345.678-90.
  - `amount` integer: Amount to be paid. If none is informed, the current boleto value will be used. Example: 23456 (= R$ 234.56)
  - `barCode` string, required: Bar code number that describes the payment. Either "line" or "barCode" parameters are required. If both are sent, they must match.
  - `line` string, required: Number sequence that describes the payment. Either "line" or "barCode" parameters are required. If both are sent, they must match.
  - `scheduled` string, date-time: Schedule the payment for a specific date. Default value is the current day.
  - `tags` string[]: Array of strings to tag the entity for future queries. All tags will be converted to lowercase.

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)