Carrier MFA

Some carriers (notably FedEx) require multi-factor authentication during account registration. Orderly handles this flow seamlessly.

FedEx Account Registration

FedEx requires a verification step when connecting a new account:

1. Submit credentials — Provide your FedEx client ID, secret, and account number
2. Choose verification method — FedEx offers email or SMS verification
3. Enter PIN — You’ll receive a PIN via your chosen method
4. Verify — Submit the PIN to complete registration

Portal Flow

The portal guides you through this automatically:

1. Enter your FedEx credentials in the carrier account form
2. If MFA is required, a verification dialog appears
3. Select your verification method (email/SMS)
4. Enter the PIN when received
5. The account activates upon successful verification

API Flow

For programmatic registration:

# Step 1: Create account (may return pending verification)
POST /api/carrier-accounts
→ { "status": "pending_verification", "mfaOptions": [...] }
 
# Step 2: Request verification
POST /api/carrier-accounts/:id/verify
{ "method": "email" }
 
# Step 3: Submit PIN
POST /api/carrier-accounts/:id/verify
{ "pin": "123456" }
→ { "status": "active" }

Verification Statuses