---
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`

## Request

- Base URL: `https://app.officernd.com`
- URL: `https://app.officernd.com/api/v2/organizations/{orgSlug}/charges`
- Auth: OAuth 2
  - Authorization code: `https://identity.officernd.com/auth/authorize`
  - Client credentials
  - Token URL: `https://identity.officernd.com/auth/token` scopes: `flex.billing.charges.create`

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/billing-product-api.md) - [All operations](https://skmtc.dev/officernd/apis/billing-product-api/llms.txt) - [OpenAPI document](https://skmtc.dev/officernd/apis/billing-product-api/revisions/78f9c9851fb0?raw)