> For the complete documentation index, see [llms.txt](https://dev.hybrid-chain.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.hybrid-chain.com/guides/consumer-platforms-and-payments/crypto-backed-debit-cards.md).

# Crypto-Backed Debit-Cards

**Overview:** Offer your users the ability to spend their crypto assets in real time via physical or virtual debit cards, without relying on centralized custodians. Hybrid-Chain makes it easy to connect self-custody Hybrid-Vaults to merchant payment rails, automating token-to-fiat conversion at the moment of purchase.

**Platform Benefits:** By leveraging Hybrid-Chain’s abstraction layer and transaction routing, your users maintain full control of their funds while enjoying seamless usability. Crypto is converted just-in-time, transactions are confirmed within milliseconds, and detailed records are retained on-chain for full transparency and accounting.

**Integration Flow:**

1. **Card Issuer Partnership Setup:**
   * Partner with a third-party card issuer (e.g., Visa/Mastercard enabler) to generate virtual/physical cards
   * Register card profiles to match Hybrid-Wallets via internal token ID or vault address
2. **User Wallet Integration:**
   * Provision Hybrid-Vaults and assign them to users
   * Use `RegisterCard()` API to link cards to a specific wallet
   * Configure spending rules, whitelists, limits, and security triggers
3. **Spending and Conversion Workflow:**
   * When a transaction is initiated (POS or online), trigger `GetAvailableBalance()`
   * Execute `TokenSwap()` or `RouteSpend()` to convert crypto into stablecoin or fiat proxy
   * Push converted value to merchant settlement rail (via issuer integration)
4. **Transaction Monitoring and Security:**
   * Use `GetTransactionLog()` and webhook alerts to show spend history
   * Trigger `FreezeVault()` or `DisableCard()` in case of compromise or fraud risk
5. **Incentive Layer and UX:**
   * Implement cashback or fee discounts for users paying with native tokens (e.g., HYBRID)
   * Offer real-time FX swaps for international transactions with built-in rate transparency
   * Present users with receipt metadata, merchant category, and spend analytics

**Optional Add-ons:**

* Multi-currency wallet selection for each purchase (user chooses which token to spend)
* Vault-tiered benefits based on staking levels or KYC tier
* Branded card issuance with gamified rewards
* Smart budgeting, round-up savings, or carbon offset tracking

**Note:** Depending on your issuer and jurisdiction, crypto-to-fiat spending may require additional licenses or disclosures. Hybrid-Chain facilitates the self-custody architecture but does not provide financial intermediation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://dev.hybrid-chain.com/guides/consumer-platforms-and-payments/crypto-backed-debit-cards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.