Method: vdc.getProofingStatus

Un endpoint per recuperare lo stato attuale di una correzione.

Richiesta HTTP

POST https://example.issuer.com/api/v1/vdc/getProofingStatus

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "proofingId": string
}
Campi
requestMetadata

object (RequestMetadata)

I metadati relativi alla richiesta, necessari in tutte le richieste.
deviceReferenceId

string

L'ID corrispondente al dispositivo e la chiave di identità associata al dispositivo. Non si tratta di un ID dispositivo, il che significa che se l'utente avesse due credenziali separate sullo stesso dispositivo, questo ID sarebbe diverso.

Questo ID viene fornito in tutte le richieste e può essere utilizzato per correlarle.
proofingId

string

Un identificatore opaco che rappresenta una verifica con un bundle specifico di prove per un dispositivo specifico.

Esempio: UUID

Corpo della risposta

Una risposta contenente lo stato attuale di una bozza.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingStatus": {
    object (ProofingStatus)
  }
}
Campi
responseMetadata

object (ResponseMetadata)

I metadati relativi alla risposta, obbligatori in tutte le risposte.
proofingStatus

object (ProofingStatus)

Lo stato attuale della correzione.

ProofingStatus

Un oggetto che rappresenta i diversi stati che può avere una bozza.

Rappresentazione JSON 
{

  // Union field status can be only one of the following:
  "pending": {
    object (Pending)
  },
  "accepted": {
    object (Accepted)
  },
  "rejected": {
    object (Rejected)
  },
  "challenged": {
    object (Challenged)
  },
  "canceled": {
    object (Canceled)
  },
  "revoked": {
    object (Revoked)
  },
  "expired": {
    object (Expired)
  }
  // End of list of possible types for union field status.
}
Campi
Campo unione status. Un campo oneof contenente i diversi stati possibili per una bozza. status può essere solo uno dei seguenti tipi:
pending

object (Pending)

Uno stato in attesa, che indica che l'emittente non ha ancora preso una decisione.
accepted

object (Accepted)

Uno stato accettato, che indica che l'emittente ha accettato la verifica.
rejected

object (Rejected)

Uno stato rifiutato, che indica che l'emittente ha rifiutato la verifica.
challenged

object (Challenged)

Uno stato di verifica, che indica che l'emittente vuole che l'utente completi una verifica prima di prendere una decisione sulla verifica dell'identità.
canceled

object (Canceled)

Stato Annullato, che indica che l'utente ha annullato la verifica.
revoked

object (Revoked)

Uno stato revocato, che indica che l'emittente ha revocato la verifica.
expired

object (Expired)

Uno stato scaduto, che indica che la verifica non ha avuto una decisione (probabilmente perché una verifica non è stata completata) prima di una scadenza, stabilita dall'emittente.

In attesa

Questo tipo non contiene campi.

Un oggetto che rappresenta uno stato in attesa. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.

Accettato

Questo tipo non contiene campi.

Un oggetto che rappresenta uno stato di approvazione accettato.

Rifiutato

Un oggetto che rappresenta uno stato di verifica rifiutato.

Rappresentazione JSON 
{
  "primaryRejection": {
    object (Rejection)
  },
  "additionalRejections": [
    {
      object (Rejection)
    }
  ]
}
Campi
primaryRejection

object (Rejection)

Il motivo principale per cui questa verifica ha lo stato Rifiutato.
additionalRejections[]

object (Rejection)

Ulteriori motivi, se esistenti, per cui la bozza ha lo stato Rifiutato.

rifiuto

Un oggetto contenente i dettagli di un motivo di rifiuto specifico, che ha portato a una bozza con stato rifiutato.

Rappresentazione JSON 
{
  "rejectionDescription": string,
  "issuerRejectionIdentifier": string,

  // Union field reason can be only one of the following:
  "evidenceMismatch": {
    object (EvidenceMismatch)
  },
  "evidenceIncomplete": {
    object (EvidenceIncomplete)
  },
  "lowRiskScore": {
    object (LowRiskScore)
  },
  "recordNotFound": {
    object (RecordNotFound)
  },
  "recordInvalid": {
    object (RecordInvalid)
  },
  "maxProvisioningsReached": {
    object (MaxProvisioningsReached)
  },
  "riskCheckFailure": {
    object (RiskCheckFailure)
  },
  "livenessCheckFailure": {
    object (LivenessCheckFailure)
  }
  // End of list of possible types for union field reason.
}
Campi
rejectionDescription

string

Una descrizione di questo rifiuto per consentire ai rappresentanti dell'assistenza di eseguire il debug. Tieni presente che questo messaggio non viene mai mostrato agli utenti. Può contenere testo descrittivo e non sensibile utilizzato per il debug.

Avviso: non includere informazioni che consentono l'identificazione personale in questo messaggio.
issuerRejectionIdentifier

string

Questo identificatore è specifico per l'emittente e viene generato da quest'ultima. Viene utilizzato solo a scopo di debug per identificare il rifiuto. Questo è l'identificatore con cui l'emittente conosce questo rifiuto.
Campo unione reason. Un oneof tra i vari motivi per cui una verifica potrebbe essere rifiutata. reason può essere solo uno dei seguenti tipi:
evidenceMismatch

object (EvidenceMismatch)

Indica che la verifica è stata rifiutata a causa di una mancata corrispondenza delle prove.

Esempi di utilizzo: - Mancata corrispondenza tra il selfie acquisito dall'app e l'immagine nel sistema dell'emittente. - Mancata corrispondenza tra l'immagine del documento di acquisizione dell'app e l'immagine nel sistema dell'emittente.
evidenceIncomplete

object (EvidenceIncomplete)

Indica che la verifica è stata rifiutata a causa di prove incomplete.

Esempi di utilizzo: - L'emittente non ha ricevuto tutte le prove richieste.
lowRiskScore
(deprecated)

object (LowRiskScore)

(RITIRATO: utilizza riskCheckFailure o livenessCheckFailure a seconda dei casi)

Indica che la verifica è stata rifiutata a causa di un punteggio di rischio basso.

Esempi di utilizzo: - Il punteggio di rischio fornito dal wallet è basso. - L'emittente ha bloccato questo utente a causa di ripetuti tentativi non riusciti.
recordNotFound

object (RecordNotFound)

Indica che la verifica è stata rifiutata perché il documento non esiste nel sistema dell'emittente.

Esempi di utilizzo: - Il record non è stato trovato nel sistema dell'emittente. - Un record specifico è stato disattivato.
recordInvalid

object (RecordInvalid)

Indica che la verifica è stata rifiutata perché il record nel sistema dell'emittente si trova in uno stato non valido.

Esempi di utilizzo: - Il record è in stato Annullato. - Il record è scaduto.
maxProvisioningsReached

object (MaxProvisioningsReached)

Indica che la verifica è stata rifiutata perché il documento è stato sottoposto a provisioning sul numero massimo di dispositivi consentiti.
riskCheckFailure

object (RiskCheckFailure)

Indica che la verifica è stata rifiutata a causa di un errore di controllo del punteggio di rischio.

Esempi di utilizzo: - Il punteggio di rischio fornito dal wallet è elevato, il che rappresenta un rischio elevato di frode. - L'emittente valuta che la richiesta presenta un rischio elevato di frode.
livenessCheckFailure

object (LivenessCheckFailure)

Indica che la verifica è stata rifiutata a causa di un errore nel controllo di attività.

Esempi di utilizzo: - Il punteggio di vivacità fornito dal portafoglio è basso.

EvidenceMismatch

Un oggetto che indica un rifiuto per mancata corrispondenza delle prove.

Rappresentazione JSON 
{
  "evidenceType": string
}
Campi
evidenceType

string

Una descrizione della prova che non corrispondeva. Utilizzata solo a scopo di debug.

EvidenceIncomplete

Un oggetto che indica un rifiuto per prove incomplete.

Rappresentazione JSON 
{
  "evidenceType": string
}
Campi
evidenceType

string

Una descrizione della prova incompleta. Utilizzata solo a scopo di debug.

LowRiskScore

Questo tipo non contiene campi.

Un oggetto che indica un rifiuto del punteggio di rischio basso. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.

RecordNotFound

Questo tipo non contiene campi.

Un oggetto che indica un rifiuto di record non trovato. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.

RecordInvalid

Un oggetto che indica il rifiuto di un record non valido.

Rappresentazione JSON 
{
  "invalidityReason": string
}
Campi
invalidityReason

string

Una descrizione del motivo per cui il record non è valido.

MaxProvisioningsReached

Un oggetto che indica un rifiuto per raggiungimento del numero massimo di provisioning.

Rappresentazione JSON 
{
  "maxNumberOfProvisioningsAllowed": integer
}
Campi
maxNumberOfProvisioningsAllowed

integer

Il numero massimo di provisioning consentiti, come impostato dalle norme dell'emittente.

RiskCheckFailure

Questo tipo non contiene campi.

Un oggetto che indica il rifiuto del controllo del rischio. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.

LivenessCheckFailure

Questo tipo non contiene campi.

Un oggetto che indica il rifiuto del controllo di attività. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.

In difficoltà

Un oggetto che rappresenta uno stato di verifica contestato.

Rappresentazione JSON 
{
  "challengeDescription": string,

  // Union field challenge can be only one of the following:
  "physicalLocationVisit": {
    object (PhysicalLocationVisit)
  },
  "issuerUrlVisit": {
    object (IssuerUrlVisit)
  },
  "additionalTimeRequired": {
    object (AdditionalTimeRequired)
  }
  // End of list of possible types for union field challenge.
}
Campi
challengeDescription

string

Una descrizione del problema che i rappresentanti dell'assistenza possono utilizzare per eseguire il debug. Tieni presente che questo messaggio non viene mai mostrato agli utenti. Può contenere testo descrittivo e non sensibile utilizzato per il debug.

Avviso: non includere informazioni che consentono l'identificazione personale in questo messaggio.
Campo unione challenge. Un'opzione tra le varie verifiche che l'utente potrebbe dover completare. challenge può essere solo uno dei seguenti tipi:
physicalLocationVisit

object (PhysicalLocationVisit)

Una verifica in cui l'utente deve recarsi in una sede fisica, ad esempio l'ufficio di un emittente, per completare la verifica.
issuerUrlVisit

object (IssuerUrlVisit)

Un'opzione di verifica in cui un utente deve visitare un URL fornito dall'emittente e completare una verifica a quell'URL.
additionalTimeRequired

object (AdditionalTimeRequired)

Un'opzione di contestazione in cui è necessario più tempo per esaminare questa correzione.

PhysicalLocationVisit

Questo tipo non contiene campi.

Un oggetto che rappresenta l'opzione di verifica in cui un utente deve recarsi in una sede fisica, ad esempio l'ufficio di un emittente, per completare la verifica. Questa sfida non è di Google. Per motivi di sicurezza, se l'emittente supporta questo tipo di verifica, deve fornire a Google i dettagli della posizione durante l'onboarding.

IssuerUrlVisit

Questo tipo non contiene campi.

Un oggetto che rappresenta l'opzione di verifica in cui un utente deve visitare un URL fornito dall'emittente e completare una verifica a quell'URL. Questa sfida non è di Google. Per motivi di sicurezza, se l'emittente supporta questo tipo di verifica, deve fornire l'URL a Google durante l'onboarding.

AdditionalTimeRequired

Un oggetto che rappresenta l'opzione di contestazione in cui è necessario tempo aggiuntivo per esaminare la verifica. Il tempo stimato per il completamento può essere fornito facoltativamente.

Rappresentazione JSON 
{
  "estimatedCompletion": string
}
Campi
estimatedCompletion

string (int64 format)

Il tempo stimato in cui verrà completata la revisione, se disponibile. Il formato è un timestamp e il timestamp è rappresentato come il numero di millisecondi trascorsi dall'epoca Unix.

Annullato

Questo tipo non contiene campi.

Un oggetto che rappresenta uno stato di verifica annullato. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.

Revocato

Questo tipo non contiene campi.

Un oggetto che rappresenta uno stato di verifica revocato. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.

Scaduto

Questo tipo non contiene campi.

Un oggetto che rappresenta uno stato di verifica scaduto. Al momento questo messaggio è intenzionalmente vuoto. In futuro potrebbero essere aggiunti nuovi campi.