Redirects

Portal supports redirect-based integration where users are redirected from your application to complete escrow actions, then returned to your application upon completion.

How It Works

1. Request Link: Get a redirect URL from Portafino's API with a callback URL

2. Redirect User: Navigate user to the Portafino portal

3. User Action: User completes the action in the portal

4. Return to App: User is redirected back to your application

5. Check Status: Your app checks the user's status via API

Implementation

Request Link with Callback

Include a callbackUrl in your API request to specify where users should return

const response = await requestLink({
  action: 'REGISTER',
  payload: {
    email: '[email protected]',
    type: 'individual',
    callbackUrl: 'https://yourapp.com/return-page'
  }
});

// Redirect user to Portafino portal
window.location.href = response.redirectUrl;

Handle Return

When users return to your application, check their status via API

// On your return page
async function handleUserReturn() {
  // Refetch user status to get latest state
  const userStatus = await fetchUserStatus();
  
  // Update your UI based on the new status
  updateUI(userStatus);
}

Key Points

• No Status in URL: The redirect URL does not include completion status

• API Check Required: Always verify user status through your API after return

• Seamless Flow: Users complete actions in the portal and return to your app

• Simple Integration: Minimal code required for basic redirect flow

This approach provides a straightforward integration method suitable for applications where popup windows are not preferred or supported.