---
title: "Credit Stripe Top Up"
method: POST
path: "/v1/internal/billing/stripe/top-ups"
---

# Credit Stripe Top Up

`POST /v1/internal/billing/stripe/top-ups`

## Request

- Base URL: `https://api.aivikings.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aivikings.ai/v1/internal/billing/stripe/top-ups`
- Auth: none declared

## Request body

- StripeTopUpCreditRequest
  - `customer_id` union, required
    - string
    - integer
  - `invoice_id` integer, required
  - `amount_cents` integer, required
  - `currency` string, required
  - `stripe_event_id` string, required
  - `stripe_event_type` string, required
  - `stripe_checkout_session_id` string, required
  - `stripe_payment_intent_id` string, nullable

## Response `200`

Successful Response

- StripeTopUpCreditResponse
  - `transaction` LedgerTransactionResponse, required
    - `id` integer, required
    - `customer_id` string, required
    - `currency` string, required
    - `amount_amount` string, required
    - `kind` string, required
    - `description` string, nullable
    - `stripe_payment_intent_id` string, nullable
    - `stripe_checkout_session_id` string, nullable
    - `stripe_event_id` string, nullable
    - `connect_reseller_domain_id` string, nullable
    - `registration_attempt_id` string, nullable
    - `external_reference` string, nullable
    - `gross_amount` string, nullable
    - `stripe_fee` string, nullable
    - `nicky_fee` string, nullable
    - `total_fee` string, nullable
    - `net_credit` string, nullable
    - `posted_at` string, date-time, required
  - `balance` CustomerBalanceResponse, required
    - `customer_id` string, required
    - `currency` string, required
    - `balance_amount` string, required
  - `invoice` BillingInvoiceResponse, required
    - `id` integer, required
    - `customer_id` string, required
    - `invoice_number` string, required
    - `status` string, required
    - `currency` string, required
    - `subtotal_amount` string, required
    - `tax_amount` string, required
    - `total_amount` string, required
    - `notes` string, nullable
    - `stripe_checkout_session_id` string, nullable
    - `stripe_payment_intent_id` string, nullable
    - `issued_at` string, date-time, required
    - `due_at` string, date-time, nullable
    - `paid_at` string, date-time, nullable
    - `voided_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `items` BillingInvoiceItemResponse[], required
      - `id` integer, required
      - `invoice_id` integer, required
      - `description` string, required
      - `quantity` integer, required
      - `unit_amount` string, required
      - `total_amount` string, required
      - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar.md) · [All operations](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/llms.txt) · [OpenAPI document](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/revisions/2fc32ee9d1b1?raw)