# Integration Guide ⚙️

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

* [ ] [Register your business](https://bridgecard.cards/register) 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](/reference/api-reference/cardholder.md#register-a-cardholder-synchronously) or asynchronously using this [endpoint](https://docs.bridgecard.co/introduction/pages/e5ROtsej1SMpZ3kUCRAm#register-a-cardholder.) 
* [ ] 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](https://docs.bridgecard.co/introduction/pages/MZdzG9LSiDrdbNFKhcny#cardholder_verification.successful) or [failed](https://docs.bridgecard.co/introduction/pages/MZdzG9LSiDrdbNFKhcny#cardholder_verification.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](/reference/api-reference/misc.md#fund-issuing-wallet) 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](/reference/api-reference/usd-cards.md#create-a-card).
* [ ] Call the [get user card details endpoint](/reference/api-reference/usd-cards.md#get-card-details) 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](/reference/api-reference/usd-cards.md#fund-card).
* [ ] You can also check the balance on the card using this [endpoint](/reference/api-reference/usd-cards.md#get-card-balance).
* [ ] 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](/reference/api-reference/usd-cards.md#unload-a-card).
* [ ] You can also mock a sample debit transaction on a card with this [endpoint](/reference/api-reference/usd-cards.md#mock-a-debit-transaction)
* [ ] Now that you've done a couple of transactions on the card, you can call this endpoint to [view the cards transaction history](/reference/api-reference/usd-cards.md#get-card-transactions)
* [ ] You can also explore the [other APIs here](/reference/api-reference/usd-cards.md) to manage your issued cards 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bridgecard.co/introduction/integration-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.