INTERNAL_FIO_API_UNAVAILABLE

Fio API is temporarily unavailable.

The upstream Fio bank API did not return a parseable response within the timeout window. The most common causes are scheduled Fio maintenance, a token that was just rotated, or a brief network glitch between Vercel and Fio. The raw response body is appended to the error message for debugging.

Example Error Response

JSON format

{
  "error": {
    "code": "INTERNAL_FIO_API_UNAVAILABLE",
    "message": "Fio API is temporarily unavailable.",
    "description": "The upstream Fio bank API did not return a parseable response within the timeout window. The most common causes are scheduled Fio maintenance, a token that was just rotated, or a brief network glitch between Vercel and Fio. The raw response body is appended to the error message for debugging."
  }
}

Troubleshooting Steps

Follow these steps to resolve this error

Retry the cron job in the next tick — transient Fio outages typically resolve within minutes.

Confirm the Fio API token configured in `shop__bank` is still valid (Fio sometimes invalidates tokens after a long idle period).

Check Fio status page if the failure persists for more than 15 minutes.

System Logs

For detailed system information about this error, check the system logs in your BizKitHub Admin dashboard. We provide transparent access to all system logs including detailed error information, request traces, and debugging data.

Need Help?

If you're still experiencing issues after following the troubleshooting steps, our support team is here to help.

Contact Support

Related Resources

Last updated: May 19, 2026

Back to Error Codes