getVirtualCardBulkOrderStatus 查詢來檢查大量建立虛擬卡的訂單狀態，並在訂單處理過程中擷取已建立卡片的詳細資訊。
先決條件： 具有
CREATE_VIRTUALCARD 範圍的使用者存取權杖，以及由建立大量訂單回傳的 orderId。回應包含以明文呈現的完整卡號、CVV 與到期日。請將其視為敏感的持卡人資料 — 透過 TLS 傳輸、避免記錄到日誌，且僅向授權使用者顯示。
參數
input(GetVirtualCardBulkOrderStatusInput!): 包含大量訂單識別碼的輸入物件。
GetVirtualCardBulkOrderStatusInput 欄位
| 欄位 | 型別 | 說明 | 必填 |
|---|---|---|---|
orderId | String! | 大量訂單的唯一識別碼，您可從 createVirtualCardBulkOrder 變更取得。 | 是 |
cURL 範例
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 } }"
}'
範例查詢
query GetVirtualCardBulkOrderStatus {
getVirtualCardBulkOrderStatus(
input: {
orderId: "<<ORDER_ID>>"
}
) {
orderStatus
orderId
virtualCards {
cardNumber
expiryMMYY
cvv
cardHolderName
virtualCardId
billingAddress {
city
}
}
successfulCardCreations
failedCardCreations
totalCards
}
}
範例回應
{
"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 | 此訂單要求的卡片總數。 |
持續輪詢此查詢直到
orderStatus 變為 COMPLETED（或 FAILED）。在 PENDING 期間，virtualCards 會逐步填入，而 successfulCardCreations 會逐步接近 totalCards。後續步驟
揭示虛擬卡
安全地擷取單一卡片的敏感卡片資訊。
虛擬卡錯誤代碼
解讀
failedCardCreations 並處理部分失敗案例。