Troubleshooting

Created 11 April 2026

System Issue Resolution Center

Common issues, fixes, and diagnostic steps for the plugin

If you see an error, first check Strapi server logs. Plugin logs often show a prefix like [webbycommerce].

OTP not sending

  • Verify SMTP settings in Settings → WebbyCommerce → Configure
  • Check email provider restrictions (ports, TLS, auth)
  • Check Strapi logs for SMTP errors
  • Confirm “From Email” and “From Name” are set

401 Unauthorized

  • Ensure you send: Authorization: Bearer <JWT>
  • Enable permission: Users & Permissions → Roles → Public/Authenticated → WebbyCommerce → Enable
  • Check if token expired or user is blocked

403 Forbidden when creating address

  • If Shipping Type is Single Address Mode, you can only have one billing and one shipping address
  • Use PUT /addresses/:id instead of creating a new one

404 Not Found

  • Confirm plugin is enabled in config/plugins.js
  • Check route prefix in plugin settings matches your URL
  • Restart Strapi after changing settings