擷取客戶的驗證狀態

發行項
03/08/2023

合作夥伴可以視需要擷取客戶驗證的狀態。

必要條件

建立的認證，如合作夥伴中心驗證中所述。此案例僅支援使用「應用程式+使用者」認證來進行驗證。
客戶識別碼 (customer-tenant-id) 。如果您不知道客戶的識別碼，您可以選取 [客戶] 工作區，然後從客戶清單中選取客戶，然後從客戶清單中查閱該識別碼。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找Microsoft 識別碼。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。

C#

若要擷取客戶帳戶的驗證狀態，請先建立代表要擷取 之 ValidationType 的列舉。然後，使用客戶識別碼呼叫 IAggregatePartner.Customers.ById 方法。然後，使用 ValidationStatus 屬性來擷取 IValidationStatus 介面。最後，以驗證類型列舉變數作為輸入參數呼叫 GetValidationStatus() 或 GetValidationStatusAsync() 。

var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);

範例：主控台範例應用程式。專案：SdkSamples 類別：GetValidationStatus.cs

REST 要求

要求的語法

方法	URI
GET	{baseURL}/v1/customers/{customer-id}/validationStatus？type=account

URI 參數

使用下列查詢參數來指定您要擷取驗證狀態的客戶。

名稱	類型	必要	描述
{customer-id}	guid	Y	此值是 GUID 格式的 CustomerTenantId，可讓您指定客戶。
type	字串	Y	要擷取的驗證狀態類型。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

REST 回應

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

回應欄位

欄位	類型	描述	注意
類型	列舉	驗證資訊類型	與驗證類型相同的資料。驗證類型會傳回帳戶作為回應類型。
狀態	列舉	驗證狀態	可用狀態：Unknown、UnderReview、Allowed、NotAllowed、Not Ready
最新更新時間	string	UTC 中的上次狀態更新時間

回應範例

允許的狀態

{
    "type": "account",
    "status": "Allowed",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

處於檢閱狀態

{
    "type": "account",
    "status": "UnderReview",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

NotAllowed 狀態

{
    "type": "account",
    "status": "NotAllowed",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

未知狀態

{
    "type": "account",
    "status": "Unknown",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

未就緒狀態

{
    "type": "account",
    "status": "Not Ready",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

404 找不到錯誤

{
    "code": 600074,
    "message": "Account Status for the customer, {customer-id} was not found.",
    "description": "Account Status for the customer, {customer-id} was not found.",
    "errorName": "AccountStatusNotFound",
    "isRetryable": false,
    "errorMessageExtended": "InternalErrorCode=600074"

購買資格

當客戶的帳戶具有下列任何狀態時，將會封鎖客戶的交易：

UnderReview
NotAllowed
Unknown

當客戶符合下列條件時，將不會封鎖客戶的交易：

客戶具有 [允許] 狀態
客戶沒有帳戶狀態

共用方式為