---
title: "Create Company Payment"
method: POST
path: "/api/company-payment/"
tags: ["Payments"]
---

# Create Company Payment

`POST /api/company-payment/`

## Request

- Base URL: `https://api.avete.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avete.ai/api/company-payment/`
- Auth: HTTP bearer

## Request body

- PaymentCreate
  - `company_id` integer, required: ID of the company making the payment
  - `plan_id` integer, required: ID of the plan selected
  - `amount` integer, required: Total amount billed in yen
  - `status` 'paid' | 'pending' | 'failed' | 'cancelled' | 'expired' | 'invoiced', required
  - `stripecustomerid` string, required: Stripe Customer ID
  - `stripesubscriptionid` string, required: Stripe Subscription ID
  - `invoice_url` string, nullable: Stripe-hosted invoice URL
  - `stripe_invoice_id` string, nullable: Stripe invoice ID
  - `payment_method` 'stripe' | 'bank_transfer' | 'external_api': How this payment is settled
  - `external_provider` string, nullable: External API provider when payment_method=external_api
  - `billing_period_start` string, date-time, nullable
  - `billing_period_end` string, date-time, nullable
  - `day_rate` integer, nullable
  - `usage_days` integer, nullable
  - `notes` string, nullable

## Response `200`

Successful Response

- PaymentRead
  - `id` integer, required
  - `company_id` integer, required
  - `plan_id` integer, required
  - `amount` integer, required
  - `status` 'paid' | 'pending' | 'failed' | 'cancelled' | 'expired' | 'invoiced', required
  - `stripecustomerid` string, required
  - `stripesubscriptionid` string, required
  - `invoice_url` string, nullable
  - `stripe_invoice_id` string, nullable
  - `payment_method` 'stripe' | 'bank_transfer' | 'external_api', nullable
  - `external_provider` string, nullable
  - `billing_period_start` string, date-time, nullable
  - `billing_period_end` string, date-time, nullable
  - `day_rate` integer, nullable
  - `usage_days` integer, nullable
  - `notes` string, nullable
  - `created_date` string, date-time, required
  - `updated_date` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/avete/apis/fastcognito.md) - [All operations](https://skmtc.dev/avete/apis/fastcognito/llms.txt) - [OpenAPI document](https://skmtc.dev/avete/apis/fastcognito/revisions/2c3bbf575ddb?raw)