It’s not compliant to issue cards via API as the cardholders will be required to agree to legal terms, and go through bank approved workflows.
White Label Web App
The easiest way to issue cards is through our hosted white label web app! There is no dev work required to issue cards. All user credentialing will be managed through Hydrogen with no-code.
Web Components & WebViews
The most flexible solution for tenants that have their own web and mobile apps that they wish to embed card issuance into. You will need to be a developer with a strong technical background to integrate this solution. If you do not have developer resources we recommend using our standalone white label apps.
Consumer funded cards will require a
username created in the Hydrogen Admin so that the cardholder can properly authenticate in OAuth to view their data and fund their card after issuance. There are multiple ways to accomplish this:
Sign Up Users Before Issuance
Use this option if the user already exists in your system, or the user is signing up for your site during a previous step and you have captured all of their data.
Sign up user in the Hydrogen API
Admin username and password (required) - the admin
usernamewill connect the user auth to the user’s Nucleus data and should always be kept in sync
View the following password storage options: GUIDE-127: User Authentication Password OptionsDONE
Nucleus Client - POST /nucleus/v1/client with the same
usernameas above. The component will pre-populate as much info as you pass into the client object, besides PII data such as the SSN and DOB.
Pass in existing Hydrogen user to component
The Card Issuance component will create a new Nucleus client
usernameby default with the user’s email address, unless you pass in
client-iddata attribute into the component
Sign Up Users After Issuance
If you do not sign up the user before issuance you can still perform the mapping after the process occurs. The user’s email address will create a new Nucleus
client_id which you can retrieve asynchronously using the following two methods:
onSuccess: The “On Success URL” config on the Card Issuance component, will pass the Nucleus
client_idof . You can then add code to your to map the logged in user on your site to Hydrogen, by creating a
username(Link to onSuccess article)
Webhooks: subscribing to either the Client or Card creation webhooks will give you the Nucleus
client_idwhich you can then map to your current userbase or create a new user in your system
After card issuance, you will need to permission the component: