SecondAppraisal

Error codes

billing_required

Billing method required

HTTP 403

Provider-paid and split-pay referrals need a billing method (the Billing step in onboarding). Customer-paid referrals don't.

The problem body

Sent as application/problem+json, with the request id in request_id and the X-Request-Id header. Branch on code: the error and detail sentences can change, and some operations add members of their own.

Example problem
{
  "error": "Provider-paid and split-pay referrals are unavailable until a billing method is configured. Complete the Billing step in onboarding.",
  "code": "billing_required",
  "type": "https://secondappraisal.com/developers/errors/billing_required",
  "title": "Billing method required",
  "status": 403,
  "detail": "Provider-paid and split-pay referrals are unavailable until a billing method is configured. Complete the Billing step in onboarding.",
  "instance": "/api/gap/v1/referrals",
  "request_id": "req_4f9a2c7e1b8d4a6f9c3e2b1a7d5f8e0c"
}

Operations that can send it