> ## 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.

# 取得大量訂單狀態

使用 `getVirtualCardBulkOrderStatus` 查詢來檢查大量建立虛擬卡的訂單狀態，並在訂單處理過程中擷取已建立卡片的詳細資訊。

<Info>
  **先決條件：** 具有 `CREATE_VIRTUALCARD` 範圍的使用者存取權杖，以及由[建立大量訂單](/features/create-bulk-order)回傳的 `orderId`。
</Info>

<Warning>
  回應包含以明文呈現的完整卡號、CVV 與到期日。請將其視為敏感的持卡人資料 — 透過 TLS 傳輸、避免記錄到日誌，且僅向授權使用者顯示。
</Warning>

## 參數

* `input` (`GetVirtualCardBulkOrderStatusInput!`): 包含大量訂單識別碼的輸入物件。

## GetVirtualCardBulkOrderStatusInput 欄位

| 欄位        | 型別        | 說明                                                | 必填 |
| :-------- | :-------- | :------------------------------------------------ | :- |
| `orderId` | `String!` | 大量訂單的唯一識別碼，您可從 `createVirtualCardBulkOrder` 變更取得。 | 是  |

## cURL 範例

```bash theme={null}
curl -X POST \
  https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_USER_ACCESS_TOKEN' \
  -d '{
    "query": "query GetVirtualCardBulkOrderStatus { getVirtualCardBulkOrderStatus( input: { orderId: \"ZTBhYTg2YmQtZWQwYS00OWQxLTk5ZmUtZDBhZGY3ZjYxZGUyfDI0NjMyM2NmLTBkMzEtNGI2YS04NGQ2LTRmNGI2NzMzNmU5Yw==\" } ) { orderStatus orderId virtualCards { cardNumber expiryMMYY cvv cardHolderName virtualCardId billingAddress { city } } successfulCardCreations failedCardCreations totalCards } }"
  }'
```

## 範例查詢

```graphql theme={null}
query GetVirtualCardBulkOrderStatus {
    getVirtualCardBulkOrderStatus(
        input: {
            orderId: "<<ORDER_ID>>"
        }
    ) {
        orderStatus
        orderId
        virtualCards {
            cardNumber
            expiryMMYY
            cvv
            cardHolderName
            virtualCardId
            billingAddress {
                city
            }
        }
        successfulCardCreations
        failedCardCreations
        totalCards
    }
}
```

## 範例回應

```json theme={null}
{
    "data": {
        "getVirtualCardBulkOrderStatus": {
            "orderStatus": "COMPLETED",
            "orderId": "<<ORDER_ID>>",
            "virtualCards": [
                {
                    "cardNumber": "5111147189413564",
                    "expiryMMYY": "08/29",
                    "cvv": "143",
                    "cardHolderName": "Test",
                    "virtualCardId": "104b50d2-97e5-49ee-b9fd-b42120d68212",
                    "billingAddress": {
                        "city": "San Jose"
                    }
                },
                {
                    "cardNumber": "5111143166431356",
                    "expiryMMYY": "08/29",
                    "cvv": "135",
                    "cardHolderName": "Test",
                    "virtualCardId": "03291f04-8358-44f7-ac58-73a6643ac07f",
                    "billingAddress": {
                        "city": "San Jose"
                    }
                }
            ],
            "successfulCardCreations": 4,
            "failedCardCreations": 0,
            "totalCards": 4
        }
    }
}
```

## 回應欄位

| 欄位                              | 型別                            | 說明                                          |
| ------------------------------- | ----------------------------- | ------------------------------------------- |
| `orderId`                       | `String`                      | 大量建立訂單的唯一識別碼。                               |
| `orderStatus`                   | `VirtualCardBulkOrderStatus!` | 大量訂單的狀態（例如：`COMPLETED`、`PENDING`、`FAILED`）。 |
| `virtualCards`                  | `[VirtualCardDetails]`        | 每張成功建立之卡片的完整詳細資料。會在卡片建立後逐步填入。               |
| `virtualCards[].cardNumber`     | `String`                      | 16 位數的完整虛擬卡卡號。                              |
| `virtualCards[].expiryMMYY`     | `String`                      | 卡片到期日，格式為 MM/YY。                            |
| `virtualCards[].cvv`            | `String`                      | 卡片的 3 位數安全碼。                                |
| `virtualCards[].cardHolderName` | `String`                      | 指派給持卡人的姓名。                                  |
| `virtualCards[].virtualCardId`  | `UUID`                        | 虛擬卡的唯一識別碼。                                  |
| `virtualCards[].billingAddress` | `Object`                      | 與虛擬卡關聯的帳單地址。                                |
| `successfulCardCreations`       | `Int`                         | 目前成功建立的卡片數量。                                |
| `failedCardCreations`           | `Int`                         | 建立失敗的卡片數量。                                  |
| `totalCards`                    | `Int`                         | 此訂單要求的卡片總數。                                 |

<Tip>
  持續輪詢此查詢直到 `orderStatus` 變為 `COMPLETED`（或 `FAILED`）。在 `PENDING` 期間，`virtualCards` 會逐步填入，而 `successfulCardCreations` 會逐步接近 `totalCards`。
</Tip>

## 後續步驟

<CardGroup cols={2}>
  <Card title="揭示虛擬卡" icon="eye" href="/recipes/reveal-virtual-card">
    安全地擷取單一卡片的敏感卡片資訊。
  </Card>

  <Card title="虛擬卡錯誤代碼" icon="triangle-alert" href="/features/virtual-card-error-codes">
    解讀 `failedCardCreations` 並處理部分失敗案例。
  </Card>
</CardGroup>