---
title: "Create Charge"
method: POST
path: "/charges"
tags: ["Charges"]
---

# Create Charge

`POST /charges`

Create a **Charge**. **Charges** require a specified **Card Account** or **Bank Account**. You may pass through an existing **User**, or define the `user_id` of the new user that will be associated with the **Charge** and the provided Account. The `user_id` can be left blank if you wish for a new user to be created for the **Charge**, or specified if you wish for a new **User** to be created with the passed `user_id`.

## Request body

- ChargeRequestBody
  - `account_id` string, required — Bank Account or Card Account ID
  - `name` string — Description of the Charge being created.
  - `amount` integer, required — The cost being charged in cents.
  - `email` string, required — Email of the user associated with the account being charged.
  - `zip` integer, required — Postcode
  - `country` string, required — [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements) country code of the User being charged.
  - `user_id` string — The ID of the User
  - `fee_ids` string — A comma separated list of fee IDs to apply
  - `currency` string — [ISO 4217 alpha-3](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) currency code. This is an optional field and if not provided, the item will be created with the default currency of the marketplace.
  - `retain_account` boolean — True - Enables the account to be charged in the future. False - Redacts the account after this charge.
  - `device_id` string — Device Information for the device initiating the payment
  - `ip_address` string — IP Information for the device initiating the payment
  - `custom_descriptor` string — When `custom_descriptors` are enabled, this is the information to appear on credit card and direct debit statements.
  - `cvv` string — CVV / CVC

## Response `201`

OK

- SingleCharge
  - `charges` Charge
    - `id` string
    - `name` string
    - `custom_descriptor` string
    - `custom_data` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `state` string
    - `buyer_fees` integer
    - `seller_fees` integer
    - `credit_card_fee` integer
    - `status` integer
    - `amount` integer
    - `dynamic_descriptor` string
    - `account_id` string, uuid
    - `account_type` string
    - `promisepay_fee` integer
    - `currency` string
    - `payment_method` string
    - `buyer_name` string
    - `buyer_email` string, email
    - `buyer_zip` string
    - `buyer_country` string
    - `seller_name` string
    - `seller_email` string, email
    - `seller_zip` string
    - `seller_country` string
    - `related` object
      - `buyers` string
      - `sellers` string
    - `links` object
      - `self` string
      - `buyers` string
      - `sellers` string
      - `status` string

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/versions/60b528b2e015/schema)