---
title: "Create a new charge for invoice"
method: POST
path: "/api/v2/organizations/{orgSlug}/charges"
tags: ["Charges"]
---

# Create a new charge for invoice

`POST /api/v2/organizations/{orgSlug}/charges`

Create a new charge for the specified invoice. 

 Required scopes: `flex.billing.charges.create`

## Path parameters

- `orgSlug` string, required

## Request body

- AddChargeDto
  - `payment` string, required — The payment for which the charge should be created
  - `date` string, required — The date of the charge
  - `amount` number, required — The amount of the charge.
  - `account` string, required — The account with which the charge will be associated.
  - `reference` string — A short description of the charge
  - `providerChargeReference` string — Provider payment gateway charge reference used for reconciliation and operational tooling.
  - `status` 'pending' | 'fail' | 'success' | 'refund' — The status of the charge.
  - `source` string — The origin of the charge, you should denote entries created from the API accordingly.

## Response `201`

- ChargeResultDto
  - `_id` string, required — The _id of the charge.
  - `amount` number, required — The amount of the charge.
  - `currency` string — The currency of the charge.
  - `account` string — The account to which the charge is allocated.
  - `reference` string — A short description of the charge
  - `date` string — The date of the charge.
  - `accounting` AccountingResultDto
    - `provider` string — The name of the accounting provider.
    - `providerId` string — The id of the payment in the accounting provider.
    - `externalOrgId` string — The organization id in the accounting provider.
    - `deepLink` string — A deep link to the payment in the accounting provider.
    - `lastSync` string — The date of the last sync of the payment with the accounting integration.
    - `error` string — An error message with more details about the reason of the failure.
  - `source` string — The source of the charge. The source will be an accounting integration if the charge is synced from an integration.
  - `status` 'pending' | 'fail' | 'success' | 'refund' — The status of the charge.
  - `payment` string — Reference to the invoice, to which the charge belongs to.
  - `providerChargeReference` string — The payment gateway reference for the charge (e.g., Stripe charge ID).
  - `createdAt` string, date-time — The date when the charge has been created at.
  - `createdBy` string — The user that created the charge.
  - `modifiedAt` string, date-time — The date when the charge has been modified for the last time.
  - `modifiedBy` string — The user that did the last modification to the charge. Before the first modification, this field equals to the createdBy field.

---

[API](https://skmtc.dev/officernd/apis/authentication-api.md) · [All operations](https://skmtc.dev/officernd/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/officernd/authentication-api/revisions/6bcd33dc648e/schema)