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

# Create Brcode Payments

`POST /v2/brcode-payment`

## Request

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

Use this route to pay registered brcodes generated at Stark Bank or at other financial institutions using the available balance in your Stark Bank account.
NOTE:Initially, the brcode entity amount will be zero because the brcode is processed asynchronously.

## Request body

- object
  - `brcode` string, required: Brcode that describes the payment.
  - `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, required: If the brcode does not provide an amount, this parameter is mandatory, else it is optional. Example: 23456 (R$ 234,56).
  - `rules` string[]: List of rules for modifying brcodePayment behavior. Example: [{"key": "resendingLimit", "value": 5}]
  - `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)