> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # クレジットチャージAPI > Stripeのチェックアウトを作成し、Diditの残高にチャージを追加します。金額は$50〜$10,000で額面どおりに反映され、Free・Growth・Scaleプランで利用できます。チャージの有効期間は12か月です。 クレジットをチャージするプロンプト プロンプトをクリップボードにコピー \

\``Goal: Start a manual credit top-up by creating a hosted Stripe Checkout session. Once Stripe processes the payment, Didit's invoice.paid webhook handler credits the organization's balance.

Endpoint: POST https://verification.didit.me/v3/billing/top-up/
Auth header: x-api-key: 
Content-Type: application/json

Request body:
\- amount_in_dollars (number, REQUIRED) — USD amount to charge, from $50 MINIMUM to $10,000 MAXIMUM. The balance receives the same amount: no discount or bonus. Tax is added automatically at checkout based on billing address.
\- success_url (URI, optional) — Stripe redirects here after successful payment. Currently defaults to `https://console.didit.me`. Pass a working URL explicitly; the default host is unavailable. Append literal placeholder {CHECKOUT_SESSION_ID} if you want Stripe to substitute the session id.
\- cancel_url (URI, optional) — Stripe redirects here when the customer aborts. Currently defaults to `https://console.didit.me`. Pass a working URL explicitly; the default host is unavailable.

curl:
curl -X POST 'https://verification.didit.me/v3/billing/top-up/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"amount_in_dollars": 500,
"success_url": "https://yourapp.com/billing/success",
"cancel_url": "https://yourapp.com/billing/cancel"
}'

Response 200:
\{
"checkout_session_id": "cs_test_a1B2c3D4e5F6g7H8i9J0",
"checkout_session_url": "https://checkout.stripe.com/c/pay/cs_test_..."
}
Redirect the customer's browser to checkout_session_url (or hand it off to your billing admin out-of-band) to complete payment.

Full flow:
1\. POST /v3/billing/top-up/ with amount_in_dollars and explicit success_url and cancel_url values.
2\. Redirect to checkout_session_url.
3\. Customer pays on Stripe-hosted page.
4\. Stripe redirects to success_url (or cancel_url on abort).
5\. Didit receives invoice.paid webhook, increases organization balance.
6\. Poll GET /v3/billing/balance/ to confirm balance reflects the top-up.

Failure modes:
\- 400 — the body is a JSON array with one message:
\["amount_in_dollars is required."]
\["amount_in_dollars must be a number."]
\["Amount must be at least $50."]
\["Amount must be at most $10,000."]
\["You have an annual plan. Contact your account manager to top up."]  // Enterprise annual-contract orgs cannot top up: usage beyond the contract credit is invoiced as overage.
\- 401 — missing/malformed x-api-key.
\- 403 — key valid but cannot create top-up sessions for this organization.
\- 429 — rate-limited.

Notes:
\- Top-ups are available on the Free, Growth and Scale plans, from $50 to $10,000 each. They are added at face value (pay $10,000, receive $10,000; no discount or bonus), pay for every product, and last 12 months. Each check uses the month's plan credit first, then the oldest top-up.
\- Auto top-up amounts, set in Console → Billing, follow the same $50 to $10,000 range.
\- The Stripe Checkout session is single-use, but calling this endpoint repeatedly creates NEW sessions — track completion on your side via success_url/cancel_url to avoid duplicate charges.
\- When the cardholder pays with card / SEPA / US ACH, Stripe attaches the payment method with setup_future_usage=off_session so Didit can later auto-charge it for auto-refill.
\- The organization must already have a Stripe customer set up (created automatically the first time the org configures billing).

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.``

\
貼り付け先 ## OpenAPI ````yaml ja/openapi-25.json POST /v3/billing/top-up/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 本人確認API。x-api-keyヘッダーで認証します。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/billing/top-up/: post: tags: - Billing summary: クレジットをチャージ description: >- ホスト型のStripe Checkoutセッションでクレジットを追加します（1回のチャージあたり**\$50〜\$10,000**）。チャージはFree、Growth、Scaleプランで利用でき、割引やボーナスなしで額面どおりに追加され、有効期間は12か月です。Enterpriseの年間契約ではチャージできません。返された`checkout_session_url`に顧客をリダイレクトしてください。 operationId: billing_top_up requestBody: required: true content: application/json: schema: type: object required: - amount_in_dollars properties: amount_in_dollars: type: number minimum: 50 maximum: 10000 description: >- 請求する金額（USD）。**50から10,000の範囲である必要があります**。残高には同額が加算され、割引やボーナスはありません。税金は、顧客の請求先住所に基づいてチェックアウト時に自動的に加算されます。 success_url: type: string format: uri description: >- 決済成功後にホスト型チェックアウトが顧客をリダイレクトするURL。現在のデフォルトは`https://console.didit.me`です。デフォルトのホストは利用できないため、動作するURLを明示的に指定してください。ホスト型チェックアウトでセッションIDを置換させたい場合は、リテラルのプレースホルダー`{CHECKOUT_SESSION_ID}`を末尾に追加してください。 cancel_url: type: string format: uri description: >- 顧客がCheckoutウィンドウを中断または閉じたときに、ホスト型チェックアウトが顧客をリダイレクトするURL。現在のデフォルトは`https://console.didit.me`です。デフォルトのホストは利用できないため、動作するURLを明示的に指定してください。 examples: Minimum top-up: value: amount_in_dollars: 50 Custom amount with redirects: value: amount_in_dollars: 500 success_url: https://yourapp.com/billing/top-up/success cancel_url: https://yourapp.com/billing/top-up/cancel responses: '200': description: >- ホスト型チェックアウトセッションが作成されました。支払いを完了するには、ユーザーを`checkout_session_url`にリダイレクトしてください。 content: application/json: schema: type: object required: - checkout_session_id - checkout_session_url properties: checkout_session_id: type: string description: >- ホスト型チェックアウトセッションの識別子です(例: `cs_test_a1B2c3...`)。サーバー側での照合に役立ちます。 checkout_session_url: type: string format: uri description: 1回限り使用できるホスト型決済ページのURL。顧客をここにリダイレクトして支払いを完了させてください。 examples: Created: value: checkout_session_id: cs_test_a1B2c3D4e5F6g7H8i9J0 checkout_session_url: >- https://checkout.example.com/c/pay/cs_test_a1B2c3D4e5F6g7H8i9J0 '400': description: >- ペイロードが無効です。金額が欠落している、数値ではない、最低額\$50未満である、最高額\$10,000を超えている、または組織がEnterpriseの年間契約を結んでいることが原因です。エラーボディはJSON配列です。 content: application/json: examples: Missing amount: value: - amount_in_dollars is required. Not a number: value: - amount_in_dollars must be a number. Below minimum: value: - Amount must be at least $50. Above maximum: value: - Amount must be at most $10,000. Annual plan: value: - >- You have an annual plan. Contact your account manager to top up. '403': description: >- APIキーがない、無効、または失効しています。または、そのキーではこの組織のチャージセッションを作成できません。キーがない場合は`403`を返し、誤った、失効した、または期限切れのキーの場合は`401`を返します。 content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: レート制限を超過しました。間隔を空け、`Retry-After`で示された時間が経過してから再試行してください。 content: application/json: examples: Throttled: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST 'https://verification.didit.me/v3/billing/top-up/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "amount_in_dollars": 500, "success_url": "https://yourapp.com/billing/success", "cancel_url": "https://yourapp.com/billing/cancel" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.billing.top_up( amount_in_dollars=50.0, ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.billing.topUp({ amount_in_dollars: 50.0, }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Billing.TopUp(ctx, didit.BillingTopUpParams{\n\tAmountInDollars: 50.0,\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; import me.didit.types.BillingTopUpParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.billing().topUp(BillingTopUpParams.builder() .amountInDollars(50.0) .build()); System.out.println(result); - lang: php label: PHP source: |- billing->topUp([ 'amount_in_dollars' => 50.0, ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.billing.top_up(amount_in_dollars: 50.0) puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Billing.TopUpAsync(new BillingTopUpParams { AmountInDollars = 50.0, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.