Billing

Start Developer card setup

Changed on Oct 20, 2026

Stripe Checkout in setup mode saves a card. Usage after the prepaid balance is zero is metered and billed monthly in arrears. Refused while a plan subscription is open. 404 feature_disabled when Developer billing is off. Account keys only.

Scope: billing:manage. Acts on the account; keys bound to a customer are refused.

post/v1/billing/developer/checkout

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/billing/developer/checkout
Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: billing:manage)

Headers

Idempotency-Keystring

Optional on this route. At most 128 characters. When present, the same key and body replays the first response for 24 hours. A different body is 409 idempotency_key_reused. A second call waits for the first and replays it. Omit the header to run the request normally.

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

Response

Hosted card setup.

mode'stripe' | 'unconfigured' required

urlstring nullable required

Hosted checkout URL. Send the buyer here. Null when checkout is not configured.

session_idstring nullable required

Checkout session id.

creditsinteger required

Credits this checkout adds after payment.

Example response

{
  "mode": "stripe",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4e5f6",
  "session_id": "cs_test_a1b2c3d4e5f6",
  "credits": 7500
}

Changes

Oct 20, 2026ad27b35513a6 Revision changes
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status

Operation history