> ## Documentation Index > Fetch the complete documentation index at: https://docs.kelviq.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a charge > Creates a one-time charge billed immediately against the customer's default payment method, without requiring a checkout session. The customer must already have a usable payment method on file (a saved payment method or an active subscription). If no default payment method exists, or the off-session charge is declined or requires authentication, the request fails with a `400`. > **Note:** `chargePeriod` must be `ONE_TIME`. Recurring charge periods are not supported by this endpoint — use [Create a subscription](/api-reference/subscriptions/create-a-subscription) instead. Click the base URL in the API playground and select the **Sandbox** host for test data or the **Production** host for live data. Use credentials from the same environment. ## OpenAPI ````yaml /api-reference/openapi.json post /charges/ openapi: 3.0.0 info: title: kelviq API version: 1.0.0 description: >- API for interacting with kelviq services, derived from Python SDK documentation. servers: - url: https://sandboxapi.kelviq.com/api/v1 description: Sandbox — Test payments - url: https://api.kelviq.com/api/v1 description: Production — Live payments security: - bearerAuth: [] tags: - name: Products description: Catalog products. - name: Product Settings description: Per-product settings (currency, VPN/Tor/proxy, product URL). - name: Product Files description: Product images and downloadable assets. - name: Features description: Catalog features that can be granted as plan entitlements. - name: Plans description: Catalog plans (CRUD, publish, versions, prices). - name: Plan Entitlements description: Feature entitlements attached to a plan. - name: Plan Files description: Files attached to plans, and signed download links. - name: Media description: Generate presigned S3 upload URLs for product/plan images and files. - name: Partner description: Partner integration APIs (organization provisioning, lookup). - name: Charges description: >- One-time payments charged immediately against a customer's default payment method. - name: Refunds description: Full and partial refunds for paid orders. - name: Payment Methods description: Saved customer payment methods (cards, etc.). paths: /charges/: post: tags: - Charges summary: Create a charge description: >- Creates a one-time charge billed immediately against the customer's default payment method, without requiring a checkout session. The customer must already have a usable payment method on file (a saved payment method or an active subscription). If no default payment method exists, or the off-session charge is declined or requires authentication, the request fails with a `400`. > **Note:** `chargePeriod` must be `ONE_TIME`. Recurring charge periods are not supported by this endpoint — use [Create a subscription](/api-reference/subscriptions/create-a-subscription) instead. operationId: createCharge requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateChargeRequest' responses: '201': description: Charge created content: application/json: schema: $ref: '#/components/schemas/CreateChargeResponse' example: id: 7c2f3a91-2d4e-4a8b-9b1c-6f0a2e5d9c11 startDate: '2026-06-20' endDate: null billingPeriodStartTime: null billingPeriodEndTime: null amount: '49.00' recurrence: '' currency: USD status: active product: name: Invoice Test id: 88e437b8-6017-405b-9328-e0f4e140bb79 identifier: invoice-test plan: name: Lifetime Access identifier: lifetime-access features: [] trialDaysRemaining: 0 customerId: geojacob billingType: ONE_TIME recurrenceUnit: null recurrenceType: null '400': description: >- Bad Request - Validation or business logic error (e.g. no default payment method, declined charge, blocked organization, or a non-`ONE_TIME` charge period). content: application/json: schema: $ref: '#/components/schemas/DetailErrorResponse' example: detail: A payment method is required to complete this payment. components: schemas: CreateChargeRequest: type: object required: - planIdentifier - chargePeriod - customerId properties: planIdentifier: type: string description: The identifier of the plan being purchased as a one-time payment. example: lifetime-access chargePeriod: type: string description: Must be `ONE_TIME`. Any other value is rejected. enum: - ONE_TIME example: ONE_TIME customerId: type: string description: >- The ID of the customer being charged. The customer must already have a default payment method on file. example: cust_789 features: type: array items: $ref: '#/components/schemas/FeatureInput' nullable: true description: A list of features and their desired quantities. example: - identifier: seats quantity: 5 currencyCode: type: string nullable: true description: >- Optional ISO 4217 currency code to charge in. Must match the customer's currency if they already have one set. example: USD ipAddress: type: string nullable: true description: The IP Address of the customer, used for location-based pricing. example: 103.154.35.20 CreateChargeResponse: type: object properties: id: type: string format: uuid description: The unique identifier of the created charge record. example: 7c2f3a91-2d4e-4a8b-9b1c-6f0a2e5d9c11 startDate: type: string format: date description: The date the one-time payment was created. example: '2026-06-20' endDate: type: string format: date nullable: true description: Always null for one-time payments. example: null billingPeriodStartTime: type: string format: date-time nullable: true description: Not applicable for one-time payments. example: null billingPeriodEndTime: type: string format: date-time nullable: true description: Not applicable for one-time payments. example: null amount: type: string description: The amount charged. example: '49.00' recurrence: type: string description: Empty for one-time payments. example: '' currency: type: string description: The currency of the payment. example: USD status: type: string description: The status of the resulting record. example: active product: type: object properties: name: type: string description: The name of the product. example: Invoice Test id: type: string format: uuid description: The unique identifier of the product. example: 88e437b8-6017-405b-9328-e0f4e140bb79 identifier: type: string description: The identifier of the product. example: invoice-test plan: type: object properties: name: type: string description: The name of the plan. example: Lifetime Access identifier: type: string description: The identifier of the plan. example: lifetime-access features: type: array items: {} description: List of features included in the purchase. trialDaysRemaining: type: integer description: Always 0 for one-time payments. example: 0 customerId: type: string description: The customer identifier associated with this payment. example: geojacob billingType: type: string description: The billing type of the record. example: ONE_TIME DetailErrorResponse: type: object properties: detail: type: string description: A human-readable error message. example: Customer does not exist. FeatureInput: type: object required: - identifier - quantity properties: identifier: type: string description: The unique identifier for the feature. example: seats quantity: type: integer description: The desired quantity for this feature. example: 5 securitySchemes: bearerAuth: type: http scheme: bearer description: >- The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer __YOUR_API_KEY__' ````