Integration Guide ⚙️

Step by Step guide

Here is a step-by-step guide on how to use our APIs to issue cards to your users.

• Register your business on our administrator dashboard to get access to a production and sandbox token to authenticate your API calls. Also don't forget to set up a webhook URL.

• You'll have to register your user as a cardholder on our platform, you can do this either synchronously using this endpoint or asynchronously using this endpoint

• If you registered the cardholder synchronously you'll get a response immediately but this API call can take up to 45sec to return a response because the verification is done on the fly, so remember to set your request timeout to about 45sec if you have to. If you used the asynchronous API to register the cardholder, we will verify the cardholder's ID and other details in the background and send you a successful or failed webhook event to let you know the verification result. Cardholder verification takes about 2 minutes after account creation.

• You'll need to fund your issuing wallet with some test funds so you can create a card and also fund one. You can use this API to do this.

• After the cardholder has been successfully verified, you can then go ahead and request a card for this cardholder using this endpoint.

• Call the get user card details endpoint to reveal the user's card details. This information is usually encrypted because it contains sensitive information but you can change the API baseURL to the relay endpoint URLs below to decrypt the card details.

RELAY URLS sandbox: https://issuecards-api-bridgecard-co.relay.evervault.com/v1/issuing/sandbox/cards/get_card_details

production: https://issuecards-api-bridgecard-co.relay.evervault.com/v1/issuing/cards/get_card_details

Note: We strongly suggest that you don't save card details except your PCI-DSS compliant, you can always call this endpoint whenever you need to fetch the card details.

• Now that you have created a card, you can now fund the card using this endpoint.

• You can also check the balance on the card using this endpoint.

• We also have an API to withdraw some funds from the card, if this fits your use case you can try out the feature using this endpoint.

• You can also mock a sample debit transaction on a card with this endpoint

• Now that you've done a couple of transactions on the card, you can call this endpoint to view the cards transaction history

• You can also explore the other APIs here to manage your issued cards