Go to developer

invalid_return_url

returnUrl failed Partner callback rules (typically origin match against project callback).

On this page
HTTP 400configurationpartner-2faapitypescriptjava

Code: invalid_return_url · Shape: partner

Meaning

returnUrl failed Partner callback rules (typically origin match against project callback).

Likely causes

  1. Project has no callback URL configured
  2. returnUrl origin does not match project callback origin
  3. Malformed URL

How to diagnose

  • Compare returnUrl origin to the project callback URL origin
  • Note: Partner returnUrl uses origin matching (localhost↔127.0.0.1 equivalence), not OAuth exact redirect_uri match

How to fix

  • Configure the project callback URL.
  • Pass a returnUrl whose origin matches that callback.

Retry behavior

Safe to retry after correcting returnUrl / project config.

API: POST /v1/identities/enroll, POST /v1/auth/challenge

SDK: enable2FA(), startAuthentication()

Troubleshooting: credentials, partner-2fa

Guides: Enrollment, Credentials