Skip to content

BillKit/Docs Console

Tenant

Rotate tenant provider credential

Replace the payment provider API key BillKit uses to charge on your behalf.

POST/v1/tenant/provider_credential

Operation rotate_tenant_provider_credential · Scope tenant:write · Spec snapshot 2026-09-13

Parameters

Parameter	Description
api_keystringrequired	At most 128 characters.
modeenum \| nulloptional	One of `live`, `test`.
providerconstoptional	Always `mollie`. Defaults to `"mollie"`.

Returns

Returns a TenantProviderCredentialResponse object.

Errors

Status	Cause
401	Missing or invalid API key.
403	Key is missing the `tenant:write` scope.
422	Validation Error
429	Rate limited. Back off and retry.

Get billing profile GET /v1/tenant/billing_profile
Update billing profile POST /v1/tenant/billing_profile
Get tenant capabilities GET /v1/tenant/capabilities
Export tenant data GET /v1/tenant/export
Get portal branding GET /v1/tenant/portal_branding
Update portal branding POST /v1/tenant/portal_branding

Request · curl

curl -X POST https://api.billkit.eu/v1/tenant/provider_credential \
  -H "Authorization: Bearer $BILLKIT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"string"}'

curl -X POST https://api.billkit.eu/v1/tenant/provider_credential \
  -H "Authorization: Bearer $BILLKIT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"string"}'

Request body · every field

{
  "api_key": "string",
  "mode": "live",
  "provider": "mollie"
}

{
  "api_key": "string",
  "mode": "live",
  "provider": "mollie"
}

Response · 200 OK

{
  "mode": "live",
  "object": "tenant_provider_credential",
  "provider": "mollie",
  "rotated_at": 1789392000,
  "tenant_id": "tenant_9XKp2vQ1"
}

{
  "mode": "live",
  "object": "tenant_provider_credential",
  "provider": "mollie",
  "rotated_at": 1789392000,
  "tenant_id": "tenant_9XKp2vQ1"
}