How it Works

Authentication

All API requests use the Bearer Token Authorization. See Authentication for details.

Identity Verification

Zūm Rails' card onboarding platform collects the required information from the cardholder, including personal details and verification documents such as a valid government-issued ID, proof of address, or other supporting documentation.

The onboarding platform is a web form hosted by Zūm Rails that handles the collection of identity verification information from card applicants. You can use our hosted card onboarding URL or integrate the process into your application’s embedded flow using our SDK. See Zum Connect for integration details.

Identity Verification Process Below is the two-step identity verification flow required to meet Zūm Rails’ KYC requirements:

1. Profile Setup – Collects the applicant’s full name, email address, and phone number.

2. ID Verification – Includes a selfie, upload of a valid government-issued ID, and occupation information.

Here’s a preview of the form used in Zūm Rails’ sample integration:

How to access your unique card onboarding URL/SDK

• Navigate to Settings → Integration Codes page

• For the URL, click on the Embedded Codes tab and locate the Card Onboarding banner to find your unique card onboarding URL

• For SDK, click on the JavaScript SDK and locate the Card Onboarding banner to find the “ConnectTokenType”: “Card Onboarding”

How to customize your card onboarding URL/SDK

• Navigate to Settings → Brand Customization to customize the visual appearance of the form and logo. You must provide the name, color, and icon of your brand.

Available notifications and webhooks

• After the card applicant completes the card onboarding flow, based on your configuration and level of integration, if applicable, the following will occur:

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Customer	Notification of card application submitted, approved, under review and declined
Cardholder	Notification of card application submitted, approved, under review and declined

Webhooks

Card Issuance

Upon receiving card application has passed the identify verification, a Partner and Customer can approve the card on the Zūm Rails portal on the Users page or with the Approve Card endpoint in the Users API. This endpoint is used when the identity verification process has been completed and the card applicant has passed verification.

Available notifications and webhooks

If you have the configuration, the following emails will be sent.

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Customer	Notification of card is issued successfully
Cardholder	Notification of card is issued successfully

Webhooks

Card Management

Display full card details

You can use our View Card Information SDK to display the sensitive data of your issued cards on your application.

Go to Settings → Integration Codes → JavaScript SDK to locate the View Card Information banner to find the “ConnectTokenType”: “ViewCardInformation”

Add a new card to a user

If your user has an existing card and wants a new card, you can use the Reissue Card endpoint in the Card API to create a new card and attach it to your user. The old card will be detached from our database but you can still access the information via Get Card Accounts endpoint in the Cards API.

Available notifications

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Cardholder	Notification of new card being added

Activate the users current card

Once your card has been approved or you created a new card, you need to activate the card to perform other card management activities. You can use the Activate Card endpoint in the Cards API to activate your user's card.

Available notifications and webhooks

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Cardholder	Notification of card being activated

Webhooks

Change the card program of a user's current card

Each card is assigned a card program ID which sets the overall transaction limitations, card artwork, and other program configurations. To change the card program attached to a user's card, call the Change Card Program endpoint in the Cards API. The card program ID you input must be an existing card program id listed under your Customer profile.

You can also do this on our portal through the user detail page.

Available notifications and webhooks

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Cardholder	Notification that the users card has changed card programs

Webhooks

Get the balance on a user's current card

You can view a user's current card balance through the Get Balance Inquiry endpoint in the Cards API.

Get all cards attached to a user

You can view a user's cards through the Get Card Accounts endpoint in the Cards API.

Update the status on a user's current card

You can update the user’s current card status through our Set Card Status endpoint in the Cards API.

You can also do this through our portal on the View User Details page.

Available notifications and webhooks

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Cardholder	Notification of what the card status is changed to

Webhooks

Update card profile

There are 3 different endpoints we have to update the card profile.

• Update Basic Information endpoint in User API

• Update Shipping Information endpoint in User API

• Update Prepaid Card Information endpoint in User API

You can also do this through our portal on the users edit detail page.

Available notifications and webhooks

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Cardholder	Notification of card profile updates (name, address, date of birth, occupation, phone number)

Webhooks

Reissue card

You can reissue a card manually through the Reissue Card endpoint in the Cards API.

You can also do this through our portal on the users edit detail page.

Available notifications and webhooks

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Cardholder	Notification of card reissuance

Webhooks

Funding

For Prepaid Cards, you can add funds to the card from your Zūm Wallet via the Zūm Rails portal and Transaction API, or the cardholder can load funds through an applicable Zūm Rails payment method via the Card Funding Checkout SDK. You can unload funds back to your Zūm Wallet through the Zūm Rails portal.

Available notifications

Emails from Zum Rails

Email(s) To	Reason for Email(s)
Cardholder	Notification for transactions (Approved, Pending, Declined)