Skip to main content
Some Etherfuse flows run inside the app rather than over the API — the user completes them in their browser, in a real authenticated session. You send a user into one of these flows with a launch, and every launch works the same way:
  1. Sign a short-lived user JWT with the flow’s scope.
  2. Have the user’s browser POST it to /auth/launch with the flow’s target.
The app verifies the JWT, establishes the session, and drops the user on the target page. Only the scope and target change between launches — the mechanism is identical and is documented once in JWT User Authentication. 
<form method="POST" action="https://sandbox.etherfuse.com/auth/launch">
  <input type="hidden" name="grant_type" value="urn:ietf:params:oauth:grant-type:jwt-bearer" />
  <input type="hidden" name="assertion" value="<scoped_jwt>" />
  <input type="hidden" name="target" value="<target>" />
</form>
Launch lives on the app host (https://app.etherfuse.com, or https://sandbox.etherfuse.com in sandbox), not the API host. Prefer not to POST a form? Hand the credentials to the launch page over postMessage instead. Pass an optional return_url to send the user back to your app when they finish.

​
Available launches

LaunchscopetargetWhat the user does
Sign agreementsagreements/agreementsReviews and signs the three required agreements: electronic signature, terms and conditions, and customer agreement.
Business KYBkyb/kybCompletes Know Your Business verification for a business. See the KYB guide for the full walkthrough.
A launch’s JWT needs the matching scope and nothing more — scope is strictly enforced, and any other value is rejected with invalid_scope. See Scopes.
Sign agreements has one prerequisite: the customer agreement is generated from the customer’s identity (name, address, email), so submit their KYC identity first — for example via POST /ramp/customer/{id}/kyc — or let them fill any missing fields on the signing page. See Customer Onboarding (KYC). In sandbox, the customer is auto-approved once all three agreements are signed.