PATCH [/instances/$INSTANCE]/private/otp-devices/$DEVICE_ID

This is used to update an OTP device. It is useful when we need to change information in the OTP device or when we have mistake some information.

Required permission: otp-devices-write

Request:

The request must be a OtpDevicePatchDetails.

Response:

204 No content:

The template has successfully modified.

400 Bad Request:

The request body is malformed.

404 Not found:

The OTP device(ID) is unknown to the backend. Returned with TALER_EC_MERCHANT_GENERIC_OTP_DEVICE_UNKNOWN.

500 Internal Server Error:

The server experienced an internal failure. Returned with TALER_EC_GENERIC_DB_STORE_FAILED or TALER_EC_GENERIC_INTERNAL_INVARIANT_FAILURE.

Details:

interface OtpDevicePatchDetails {

  // Human-readable description for the device.
  otp_device_description: string;

  // A key encoded with RFC 3548 Base32.
  // IMPORTANT: This is not using the typical
  // Taler base32-crockford encoding.
  // Instead it uses the RFC 3548 encoding to
  // be compatible with the TOTP standard.
  otp_key?: string;

  // Algorithm for computing the POS confirmation.
  otp_algorithm: Integer;

  // Counter for counter-based OTP devices.
  otp_ctr?: Integer;
}