Create Express Session
POST/platform/v1/wallet-sessions
Creates a wallet session URL for Embedded Express customers, allowing them to access their branded stablecoin wallet. The URL is returned in walletSessionUrl and can be shared via web view, redirect, or other integration methods. Each session link is time-bound and user-specific for security. BVNK verifies the user's identity before granting access. For details on the customer experience, consult your Account Manager.
To maintain consistent branding, include the optional theme object with each session creation. This ensures your customer sees your colors and logo in their wallet interface.
The endpoint automatically manages onboarding based on the customer's status with BVNK:
• New customers receive an onboarding link.
• Existing BVNK customers who have not used Express receive an Express registration link.
• Existing Express customers receive a login link.
• Customers with an active session token can access the wallet interface directly.
For existing BVNK customers receiving an Express link for the first time, ensure the link is accessible only by the intended customer.
Use this endpoint to enable Express features for your customers.
Request
Responses
- 200
- 400
- 401
Express session created successfully