> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 測試虛擬卡優惠

> 可直接使用的優惠 ID，用於在測試環境簽發虛擬卡，以及如何動態探索優惠。

在**測試**環境中使用這些優惠 ID 來簽發虛擬卡。每張虛擬卡皆對應一個\_offer\_，其決定卡片計畫（網路、BIN 與回饋）。下列優惠 ID 已在測試環境啟用，可直接傳給 `createVirtualCard`。

<Warning>
  **請先完成 KYC**

  只有完成身分驗證的帳戶才能簽發虛擬卡。在帳戶 — 若為企業則包含其實益擁有人 — 通過 KYC/KYB 之前，`getVirtualCardOffers` 可能會回傳空結果，而 `createVirtualCard` 也會失敗。請先執行驗證再進行測試。參見[使用者 KYC 驗證](/features/user-kyc-verification)以了解如何提交，並從[測試 KYC 流程](/test-kyc-flows)擷取測試身分資料。
</Warning>

<Note>
  **僅限測試環境**

  這些優惠 ID 只接受於測試端點（`https://transactional-graph.staging.fluzapp.com/api/v1/graphql`）。在正式環境會被拒絕，屆時你必須從[取得虛擬卡優惠](/features/get-virtual-card-offers)檢索正式的優惠 ID。
</Note>

## 測試環境的優惠 ID

| Offer ID                               | Program                                        | Network    |
| -------------------------------------- | ---------------------------------------------- | ---------- |
| `5b22153c-7c1e-4a66-9d2c-e786da7e9393` | Virtual Card - Mastercard Prepaid              | Mastercard |
| `e5d209d2-97b2-4636-9531-b3a459e34651` | Brand Locked Virtual Card - Mastercard Prepaid | Mastercard |
| `0a6f66ec-a615-47cb-a850-ef971f7054b8` | Single Load Virtual Card - Mastercard Prepaid  | Mastercard |
| `490032ad-2e67-4ef0-92ff-cd7071332716` | Reloadable Virtual Card - Mastercard Prepaid   | Mastercard |

## 應該選哪個優惠？

每個計畫都會簽發 Mastercard 預付卡，但它們在可消費場所與資金補充方式上有所不同。選擇符合你想測試行為的選項：

<AccordionGroup>
  <Accordion title="Virtual Card" icon="credit-card">
    通用型計畫——標準的多次使用預付卡，可在接受 Mastercard 的任何地方消費，受你設定的消費上限限制。若你想從頭到尾跑一遍順利路徑，從這裡開始。
  </Accordion>

  <Accordion title="Brand Locked Virtual Card" icon="store">
    僅限單一商家或品牌使用的卡片。在其他任何商家的交易都會被拒絕。用於測試商家限制的消費控管——例如只允許在某一個供應商使用的卡片。
  </Accordion>

  <Accordion title="Single Load Virtual Card" icon="banknote">
    在建立時一次性加值的卡片。餘額會先行加值並逐步消耗——之後無法再儲值。用於測試固定面額、一次性使用的卡片流程，如單次供應商付款或撥款。
  </Accordion>

  <Accordion title="Reloadable Virtual Card" icon="refresh-ccw">
    可在建立後再次加值的卡片。用於測試長期使用、可反覆補款的卡片——例如定期補助、團隊卡，或持續性的訂閱支出。
  </Accordion>
</AccordionGroup>

## 建議流程

我們建議在執行時動態探索優惠，而非硬編碼優惠 ID——回傳的清單會精準反映你的帳戶可用的項目。這是個快速的兩步驟流程。

<Steps>
  <Step title="列出可用優惠">
    呼叫 `getVirtualCardOffers` 並從回應中擷取一個 `offer_id`。
  </Step>

  <Step title="建立卡片">
    將該 `offer_id` 傳給 `createVirtualCard`。成功回應會回傳狀態為 `ACTIVE` 的 `virtual_card_id`。
  </Step>
</Steps>

<CodeGroup>
  ```graphql Step 1 — Get offers theme={null}
  query {
    getVirtualCardOffers(input: {}) {
      offer_id
      program_name
      bank_name
      rewardValue
    }
  }
  ```

  ```graphql Step 2 — Create a card theme={null}
  mutation {
    createVirtualCard(input: {
      offerId: "5b22153c-7c1e-4a66-9d2c-e786da7e9393"
      spendLimit: 5.00
      idempotencyKey: "<any unique string>"
    }) {
      virtual_card_id
      status
      initial_amount
    }
  }
  ```
</CodeGroup>

<Tip>
  將 `spendLimit` 設為不超過你可用餘額——卡片資金來自你的 Fluz 餘額，若上限較高會因餘額不足而失敗。建議先以 5 美元進行測試最安全。你可以在第一張卡片省略帳單地址，讓順利路徑更簡單；之後再透過[新增虛擬卡地址](/features/add-virtual-card-address)補上。
</Tip>

## 下一步

<CardGroup cols={2}>
  <Card title="建立虛擬卡" icon="credit-card" href="/features/create-virtual-cards">
    完整的 `createVirtualCard` 參考——輸入參數、資金與卡片生命週期。
  </Card>

  <Card title="測試 KYC 流程" icon="id-card" href="/test-kyc-flows">
    可回傳各種驗證結果的測試身分——核准、拒絕與重複。
  </Card>
</CardGroup>

**想了解更多？** 請聯絡 [partnerships@fluz.app](mailto:partnerships@fluz.app)。與我們的專家交流以取得更多資訊或申請示範。