---
title: "Create Dynamic Brcodes"
method: POST
path: "/v2/dynamic-brcode"
tags: ["Dynamic Brcode"]
---

# Create Dynamic Brcodes

`POST /v2/dynamic-brcode`

## Request

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

Use this route to create up to 100 new dynamic brcodes at a time.

## Request body

- object
  - `amount` integer, required: A non-negative integer that represents the amount in cents to be received. Example: 100 (R$1.00).
  - `displayDescription` string: Description to be shown in the payer bank interface. ex: "Payment for service #1234"
  - `expiration` integer: Time in seconds counted from the creation datetime until the brcode expires. After expiration, the brcode cannot be paid anymore. Default value: 3600 (1 hour).
  - `rules` string[]: List of rules for modifying dynamic brcode behavior. Example: [{"key": "allowedTaxIds", "value": ["012.345.678-90", "45.059.493/0001-73"]}]
  - `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)