Oggetto: ErrorResponse

Corpo della risposta

Corpo HTTP per tutte le risposte HTTP non 200.

Ecco un esempio di risposta:


  {
    "responseHeader": {
      "requestTimestamp": "1481899949611"
    },
    "errorResponseCode": "INVALID_IDENTIFIER",
    "errorDescription": "Unknown paymentIntegratorAccountId: PIAID1",
  }
Rappresentazione JSON
{
  "responseHeader": {
    object(ResponseHeader)
  },
  "errorResponseCode": string,
  "errorDescription": string,
}
Campi
responseHeader

object(ResponseHeader)

REQUIRED: intestazione comune per tutte le risposte.

errorResponseCode

string

FACOLTATIVO: fornisci uno dei codici elencati nella tabella seguente.

Codici di risposta di errore e codici HTTP consigliati
INVALID_API_VERSION 400

Utilizzato se l'integratore non supporta la versione API della richiesta.

INVALID_PAYLOAD_SIGNATURE 401

Utilizzato se la firma del payload è su una chiave sconosciuta o inattiva.

INVALID_PAYLOAD_ENCRYPTION 400

Utilizzato se la crittografia del payload è su una chiave sconosciuta o inattiva.

REQUEST_TIMESTAMP_OUT_OF_RANGE 400

Utilizzato se request_timestamp non è di ± 60 secondi dal momento attuale.

INVALID_IDENTIFIER 404

Utilizzato se un identificatore inviato nella richiesta non è valido o è sconosciuto. Possono essere inclusi paymentIntegratorAccountId, googlePaymentToken, captureRequestId e così via. Il tipo di identificatore non valido deve essere specificato nel campo errorDescription.

IDEMPOTENCY_VIOLATION 412

Utilizzata se la richiesta viola i requisiti di idempotenza per la richiesta.

INVALID_FIELD_VALUE 400

Utilizzato se la richiesta contiene un valore per un campo che non è nell'insieme dei valori supportati.

MISSING_REQUIRED_FIELD 400

Utilizzato se un campo obbligatorio non è impostato nella richiesta.

PRECONDITION_VIOLATION 400

Utilizzata se viene violata un vincolo dell'operazione (ad esempio, quando una richiesta di rimborso supera l'importo rimanente nella transazione).

USER_ACTION_IN_PROGRESS 400

Utilizzato se al momento la richiesta non può essere elaborata perché interromperebbe un'azione dell'utente in elaborazione che agisce di fatto come un blocco di sistema. Questo codice non deve essere utilizzato per indicare errori dovuti a errori di contemporaneità interni specifici dell'implementazione.

INVALID_DECRYPTED_REQUEST 400

Utilizzato se è stato possibile decriptare il payload della richiesta, ma non è stato possibile analizzare il messaggio risultante.

errorDescription

string

FACOLTATIVO: fornisci una descrizione di questo stato affinché i rappresentanti dell'assistenza possano eseguire il debug degli errori. Tieni presente che questa informazione non viene mai mostrata agli utenti. Può contenere testo descrittivo e non sensibile utilizzato per il debug. Tieni presente che alcuni valori di errorResponseCode devono essere accompagnati da ulteriori dettagli in questo campo (ad es. INVALID_IDENTIFIER deve essere accompagnato da informazioni in questo campo relative al tipo di identificatore non valido).