---
title: "POST /v1/charges"
method: POST
path: "/v1/charges"
tags: ["charges"]
---

# POST /v1/charges

`POST /v1/charges`

## Request

- Base URL: `https://apibusiness-staging-civ.djamo.io`
- URL: `https://apibusiness-staging-civ.djamo.io/v1/charges`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Company-Id`

## Request body

- CreateChargesBody
  - `amount` number, required: The amount to charge.
  - `externalId` string, required: The unique identifier of the transaction on your side.
  - `description` string: Description of the charge
  - `onCanceledRedirectionUrl` string: URL to redirect the user to when the charge is canceled
  - `onCompletedRedirectionUrl` string: URL to redirect the user to when the charge is completed

## Response `200`

- Charges
  - `id` string: The unique identifier of the charge.
  - `createdAt` string: Date and time when the charge was created. The API returns this value in ISO 8601 format.
  - `externalId` string: The unique identifier of the transaction on your side.
  - `description` string, required: Description of the charge
  - `currency` string: Currency of the charge
  - `amount` number, required: The amount to send to the account
  - `due` number: The amount due for the charge
  - `fees` object
    - `amount` number: The fee amount
    - `currency` string: Currency of the fee
    - `rate` number: The fee rate
    - `value` number: The fee value
  - `status` 'due' | 'paid' | 'canceled' | 'expired' | 'failed': Status of the charge
  - `droppedReason` string: The reason why the charge was dropped
  - `paid` number: The amount that has been paid
  - `refunded` number: The amount that has been refunded
  - `attempts` number: The number of attempts made to process the charge
  - `metadata` object: Additional information about the charge
  - `transactions` unknown[]: List of transactions related to the charge
    - unknown

## Other responses

- `400`

---

[API](https://skmtc.dev/djamo/apis/djamo-business-api-playground.md) - [All operations](https://skmtc.dev/djamo/apis/djamo-business-api-playground/llms.txt) - [OpenAPI document](https://skmtc.dev/djamo/apis/djamo-business-api-playground/revisions/e7f36f4cab53?raw)
