Billing

Create or reactivate a verified Stripe customer alias

Admin-only endpoint that explicitly maps one historical Stripe customer to one Crawlora user. It never resolves by email, cannot shadow another user's canonical customer, and records the acting admin and reason.

post/admin/billing/stripe/customer-aliases

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/admin/billing/stripe/customer-aliases
  • Auth: API key in header x-api-key

Headers

x-api-keystring required

Admin API key required unless an Admin JWT is already present

Request body

reasonstring
stripe_customer_idstring
user_idstring

Example request

{
  "reason": "Verified against subscription metadata and invoice history",
  "stripe_customer_id": "cus_123",
  "user_id": "user-1"
}

Response

Created or reactivated alias

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "created_at": "2026-08-09T00:00:00Z",
    "created_by": "admin-user",
    "reason": "Verified against subscription metadata and invoice history",
    "revoked_at": "2026-08-10T00:00:00Z",
    "revoked_by": "admin-user",
    "source": "admin_verified",
    "status": "active",
    "stripe_customer_id": "cus_123",
    "updated_at": "2026-08-09T00:00:00Z",
    "updated_by": "admin-user",
    "user_id": "user-1"
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.