---
title: "Create Darf payments"
method: POST
path: "/v2/darf-payment"
tags: ["Darf Payment"]
---

# Create Darf payments

`POST /v2/darf-payment`

## Request

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

Use this route to pay Darfs using the available balance in your Stark Bank account.

## Request body

- object
  - `competence` string, required: Competence month of the service. Example: '2020-03-10'
  - `description` string, required: Text to be displayed in your statement (min. 10 characters). Example: "payment ABC"
  - `due` string, date-time, required: Due date for payment. Example: '2020-03-10'
  - `fineAmount` integer, required: Fixed amount due in cents for fines. Example: 234 (= R$ 2.34)
  - `interestAmount` integer, required: Amount due in cents for interest. Example: 456 (= R$ 4.56)
  - `nominalAmount` integer, required: Amount due in cents without fee or interest. Example: 23456 (= R$ 234.56)
  - `revenueCode` string, required: 4-digit tax code assigned by Federal Revenue. Example: "5948"
  - `taxId` string, required: Payer CPF (11 digits formatted or unformatted) or CNPJ (14 digits formatted or unformatted). Example: 012.345.678-90
  - `referenceNumber` string: Number assigned to the region of the tax. Example: "08.1.17.00-4"
  - `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)