> ## 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 Isi Saldo Kredit Didit > Buat checkout Stripe untuk isi saldo Didit: $50 hingga $20,000 nilai nominal, pada paket Free, Growth, dan Scale. Berlaku 12 bulan. Prompt Isi Saldo Kredit Salin prompt ke papan klip \

\``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 $20,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 $20,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 $20,000 each. They are added at face value (pay $20,000, receive $20,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 $20,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.``

\
Tempel ke ## OpenAPI ````yaml id/openapi-25.json POST /v3/billing/top-up/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/billing/top-up/: post: tags: - Billing summary: Isi saldo kredit description: >- Tambahkan kredit melalui sesi Stripe Checkout yang di-hosting (**\$50 hingga \$20,000** per pengisian saldo). Pengisian saldo tersedia pada paket Free, Growth, dan Scale, ditambahkan pada nilai nominal tanpa diskon atau bonus, dan berlaku selama 12 bulan; kontrak tahunan Enterprise tidak dapat melakukan isi saldo. Alihkan pelanggan ke `checkout_session_url` yang dikembalikan. 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: 20000 description: >- Jumlah yang akan ditagihkan, dalam USD. **Harus antara 50 hingga 20.000.** Saldo menerima jumlah yang sama, tanpa diskon atau bonus. Pajak ditambahkan secara otomatis saat checkout berdasarkan alamat penagihan pelanggan. success_url: type: string format: uri description: >- URL tujuan pengalihan pelanggan oleh checkout yang di-hosting setelah pembayaran berhasil. Saat ini default-nya adalah `https://console.didit.me`. Teruskan URL yang berfungsi secara eksplisit; host default tidak tersedia. Tambahkan placeholder literal `{CHECKOUT_SESSION_ID}` jika Anda ingin checkout yang di-hosting mengganti ID sesi tersebut. cancel_url: type: string format: uri description: >- URL tujuan pengalihan pelanggan oleh checkout yang di-hosting saat mereka membatalkan atau menutup jendela Checkout. Saat ini default-nya adalah `https://console.didit.me`. Teruskan URL yang berfungsi secara eksplisit; host default tidak tersedia. 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: >- Sesi checkout yang di-hosting dibuat. Arahkan pengguna ke `checkout_session_url` untuk menyelesaikan pembayaran. content: application/json: schema: type: object required: - checkout_session_id - checkout_session_url properties: checkout_session_id: type: string description: >- Pengidentifikasi sesi checkout yang di-hosting (misalnya `cs_test_a1B2c3...`). Berguna untuk rekonsiliasi sisi server. checkout_session_url: type: string format: uri description: >- URL halaman pembayaran yang di-hosting sekali pakai. Arahkan pelanggan ke sini untuk menyelesaikan pembayaran. examples: Created: value: checkout_session_id: cs_test_a1B2c3D4e5F6g7H8i9J0 checkout_session_url: >- https://checkout.example.com/c/pay/cs_test_a1B2c3D4e5F6g7H8i9J0 '400': description: >- Payload tidak valid: jumlah hilang, bukan angka, di bawah minimum \$50 atau di atas maksimum \$20,000, atau organisasi menggunakan kontrak tahunan Enterprise. Body kesalahan berupa array 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 $20,000. Annual plan: value: - >- You have an annual plan. Contact your account manager to top up. '403': description: >- Kunci API tidak ada, tidak valid, atau dicabut, atau kunci tidak dapat membuat sesi isi saldo untuk organisasi ini. Kunci yang tidak ada mengembalikan `403`; kunci yang salah, dicabut, atau kedaluwarsa mengembalikan `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: >- Batas laju terlampaui; kurangi laju permintaan dan coba lagi setelah interval yang ditunjukkan dalam `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: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.