Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions white-box-pentest/billing.mdx
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: "Credits and billing"
description: "Understand Whitebox Scan credits, estimates, purchases, deductions, and refunds."

Check warning on line 3 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L3

Did you really mean 'Whitebox'?
---

Whitebox Scans use shared organization credits. A scan must have a completed or

Check warning on line 6 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L6

Did you really mean 'Whitebox'?
partial cost estimate with credits before it can start, and the organization
needs enough credits for that estimate.

<Info>
Whitebox Scan credits are organization-wide. They are separate from Code

Check warning on line 11 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L11

Did you really mean 'Whitebox'?
Review seats, Automation credits, trials, and pooled PR/MR review limits.
</Info>

Expand All @@ -16,12 +16,12 @@

<Steps>
<Step title="Calculate first">
Hacktron calculates the credit cost from the selected repositories and

Check warning on line 19 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L19

Did you really mean 'Hacktron'?
scope. Cost calculation does not deduct credits.
</Step>
<Step title="Start with enough balance">
Starting the scan deducts the calculated credits from the organization's
Whitebox Scan credit balance. Internal unlimited organizations show

Check warning on line 24 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L24

Did you really mean 'Whitebox'?
unlimited credits and are not charged.
</Step>
<Step title="Track usage">
Expand All @@ -30,24 +30,58 @@
</Step>
</Steps>

## Large estimates and scoping calls

Estimates of up to 10,000 credits are self-service. Hacktron shows the credit

Check warning on line 35 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L35

Did you really mean 'Hacktron'?
total, and you can continue to checkout with **Next**.

When an estimate is above 10,000 credits, Hacktron asks for a short scoping

Check warning on line 38 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L38

Did you really mean 'Hacktron'?
consultation before checkout:

- The cost calculation step hides the credit total and per-repository credits.
- **Next** is disabled, so you cannot start the scan from that estimate.
- Hacktron follows up by email to confirm coverage, pricing, and timeline.

Check warning on line 43 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L43

Did you really mean 'Hacktron'?
- You can also book a scoping call. Organization owners with a work email can
open a shared Slack channel with Hacktron from **Settings**.

Check warning on line 45 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L45

Did you really mean 'Hacktron'?

The threshold compares the base scan credits. The optional or required triage
fee is not counted toward the 10,000 credits. On-premises deployments do not
use this gate.

<Tip>
To stay within the self-service range, [narrow the included folders or path
patterns](/white-box-pentest/quickstart#path-patterns) and calculate the cost
again.
</Tip>

### Quote confirmation email

After a hosted cost calculation completes with a credit cost, Hacktron emails

Check warning on line 59 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L59

Did you really mean 'Hacktron'?
the person who ran it. The subject is `Whitebox Pentest for <Organization>`.

- For self-service estimates, the email states the quoted credits and their
USD value, with a link to book an optional scoping call.
- For estimates above 10,000 credits, the email omits pricing and invites you
to reply or book a scoping call to confirm coverage, pricing, and timeline.

## Buy credits

Organization owners can buy Whitebox Scan credits. If a member reaches checkout

Check warning on line 69 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L69

Did you really mean 'Whitebox'?
without enough credits, Hacktron asks them to contact an owner to top up the

Check warning on line 70 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L70

Did you really mean 'Hacktron'?
balance.

Whitebox Scan Credits do not use auto top-up. Owners purchase them manually without changing the organization's Automation credit balance or its auto top-up settings.

Check warning on line 73 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L73

Did you really mean 'Whitebox'?

Owners need a saved payment method before purchasing credits. If there is no
payment method on file, the checkout flow prompts the owner to add one first,
then opens the credit purchase modal.

Organization owners can buy credits from **Billing** or from the Whitebox Scan

Check warning on line 79 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L79

Did you really mean 'Whitebox'?
checkout step when the organization does not have enough credits.

<Steps>
<Step title="Open Billing">
Go to **Billing** in the Hacktron dashboard and find the Whitebox Scan

Check warning on line 84 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L84

Did you really mean 'Hacktron'?

Check warning on line 84 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L84

Did you really mean 'Whitebox'?
credit balance.
</Step>
<Step title="Add a payment method">
Expand All @@ -59,7 +93,7 @@
price.
</Step>
<Step title="Complete checkout">
Complete any required card authentication. Hacktron adds the purchased

Check warning on line 96 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L96

Did you really mean 'Hacktron'?
credits to the organization balance after checkout succeeds.
</Step>
</Steps>
Expand All @@ -79,7 +113,7 @@
3. Start the scan again after the balance covers the calculation.

API callers receive `402 Payment Required` when a scan cannot start because the
organization has insufficient Whitebox Scan credits.

Check warning on line 116 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L116

Did you really mean 'Whitebox'?

<Tip>
The API does not buy credits automatically. Handle `402` by directing an
Expand All @@ -89,20 +123,20 @@

## Retests

Each pentest includes **one free retest**, with no extra Whitebox Scan credits

Check warning on line 126 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L126

Did you really mean 'pentest'?

Check warning on line 126 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L126

Did you really mean 'Whitebox'?
deducted. See [Retests](/white-box-pentest/retests) for how to request it.

## Refunds and cancellations

If a started scan cannot launch successfully after credits are deducted,
Hacktron attempts to refund those credits automatically. Failed and stopped

Check warning on line 132 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L132

Did you really mean 'Hacktron'?
scans can show refunded credits in the scan details and transaction history.

## Related docs

<Columns cols={2}>
<Card
title="Trigger a Whitebox Scan"

Check warning on line 139 in white-box-pentest/billing.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/billing.mdx#L139

Did you really mean 'Whitebox'?
icon="shield-halved"
href="/api-reference/scans/create-scan"
>
Expand Down
4 changes: 4 additions & 0 deletions white-box-pentest/quickstart.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: "Quickstart"
description: "Prepare scope, estimate credits, and start a white-box pentest."

Check warning on line 3 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L3

Did you really mean 'pentest'?
---

Use this guide to prepare scope and start a White-box Pentest from the Hacktron

Check warning on line 6 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L6

Did you really mean 'Pentest'?

Check warning on line 6 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L6

Did you really mean 'Hacktron'?
dashboard.

## Prerequisites
Expand All @@ -11,10 +11,10 @@
Before you start, make sure the organization has:

- A connected repository or an uploaded archive to assess
- The branch or commit you want Hacktron to use

Check warning on line 14 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L14

Did you really mean 'Hacktron'?
- For dynamic testing, the domains or URLs of the applications to test and
instructions for accessing each one, even if no sign-in is required
- Enough Whitebox Scan credits, or an organization owner who can add a payment

Check warning on line 17 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L17

Did you really mean 'Whitebox'?
method and buy credits

<Card
Expand Down Expand Up @@ -111,6 +111,10 @@
**Edit scope** to adjust the paths. Any scope change resets the estimate,
so calculate again before starting.

If the estimate is above 10,000 credits, Hacktron hides the total, disables
**Next**, and follows up by email to scope the pentest with you. See
[Large estimates and scoping calls](/white-box-pentest/billing#large-estimates-and-scoping-calls).
Comment on lines +114 to +116

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Add a screenshot of the gated estimate state

For estimates above 10,000 credits, this new branch introduces a distinct dashboard state that readers need to recognize, but the existing image immediately below only shows the pre-calculation screen with Calculate cost and does not show the hidden prices, consultation message, or disabled Next button. Add a current product screenshot of the gated result beside this explanation so the dashboard workflow documents the controls and state it describes.

AGENTS.md reference: AGENTS.md:L6-L8

Useful? React with 👍 / 👎.


<img src="/images/whitebox_cost_estimate.png" width="2212" height="1256" alt="Run the credit cost estimate for the scan" />

</Step>
Expand Down Expand Up @@ -195,24 +199,24 @@
| Authentication | Test credentials, SSO notes, MFA bypass instructions, or invite steps. |
| Sensitive areas | Auth, billing, permissions, file upload, webhooks, AI agents, or admin paths. |
| Exclusions | Systems, data, tenants, destructive actions, or rate limits that are out of scope. |
| Context documents | Architecture notes, threat models, API specs, or prior pentest reports. |

Check warning on line 202 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L202

Did you really mean 'pentest'?

## Other ways to start a pentest

Check warning on line 204 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L204

Did you really mean 'pentest'?

You can also prepare a pentest in Slack, through an AI assistant connected to

Check warning on line 206 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L206

Did you really mean 'pentest'?
Hacktron's MCP server, or through the REST API. Set the scope and review the

Check warning on line 207 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L207

Did you really mean 'Hacktron's'?
credit estimate before starting. These options require an organization admin
to start the pentest.

Check warning on line 209 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L209

Did you really mean 'pentest'?

<Columns cols={2}>
<Card title="Hacktron in Slack" icon="slack" href="/platform/slack-assistant">
Mention @Hacktron AI with a repository or an attached archive.
</Card>
<Card title="MCP" icon="plug" href="/mcp/get-started">
Set up pentests from Claude, Cursor, and other AI assistants.

Check warning on line 216 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L216

Did you really mean 'pentests'?
</Card>
<Card
title="Create pentest draft"

Check warning on line 219 in white-box-pentest/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hacktronai) - vale-spellcheck

white-box-pentest/quickstart.mdx#L219

Did you really mean 'pentest'?
icon="code"
href="/api-reference/pentests/create-pentest"
>
Expand Down
Loading