# Card upgrade to physical details

Notification that there has been an update in the card upgrade to physical process

Endpoint: POST /managed_cards/physical_cards_upgrade/watch
Version: v2

## Header parameters:

  - `call-ref` (string)
    A call reference generated by the caller and unique to the caller to provide correlation between the caller and system with a maximum length of 255

  - `published-timestamp` (integer, required)
    The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

  - `signature-v2` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the call-ref + payload + published-timestamp using your API key.

  - `signature` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

## Request fields (application/json):

  - `id` (object, required)
    The id of the managed card on which the event occurred.

  - `id.id` (string, required)

  - `id.type` (string, required)
    Enum: "managed_cards", "managed_accounts"

  - `physicalCardDetails` (object, required)

  - `physicalCardDetails.bulkDelivery` (boolean)
    Bulk delivery is available for deliveryMethods REGISTERED_MAIL or COURIER.
All cards marked as bulk and ordered within the fulfilment centre’s dispatch window will be sent in bulk. Delivery address must be identical for all orders. contactNumber in the deliveryAddress object is mandatory when bulk is selected. Maximum number of cards delivered in a single box/packet is REGISTERED_MAIL = 90, COURIER = 200.

  - `physicalCardDetails.productReference` (string)
    The unique reference indicating the configuration of the physical card. Example the card design.

  - `physicalCardDetails.carrierType` (string)

  - `physicalCardDetails.pendingActivation` (boolean, required)
    Indicates if the physical card is activated for physical usage such as with physical terminals.

  - `physicalCardDetails.pinBlocked` (boolean)
    Indicates if the physical card is blocked due to providing incorrect PINs.

  - `physicalCardDetails.manufacturingState` (string)
    Information on the manufacturing of the physical card, as follows:
  - REQUESTED: The upgrade of the card to physical has been requested.
  - SENT_FOR_FULFILLMENT - The card has been sent for printing.
  - DISPATCHED: The card has been manufactured and dispatched. You may receive a second DISPATCHED event when the manufacturer provides a tracking code.
  - DELIVERED: The card has been received and activated by the recipient.
    Enum: "REQUESTED", "SENT_FOR_FULFILLMENT", "DISPATCHED", "DELIVERED"

  - `physicalCardDetails.deliveryAddress` (object)
    The delivery address where the physical card is delivered.

  - `physicalCardDetails.deliveryAddress.name` (string, required)

  - `physicalCardDetails.deliveryAddress.surname` (string, required)

  - `physicalCardDetails.deliveryAddress.addressLine1` (string, required)

  - `physicalCardDetails.deliveryAddress.addressLine2` (string)

  - `physicalCardDetails.deliveryAddress.city` (string, required)

  - `physicalCardDetails.deliveryAddress.postCode` (string, required)

  - `physicalCardDetails.deliveryAddress.state` (string)

  - `physicalCardDetails.deliveryAddress.country` (string, required)
    Country of the identity in ISO 3166 alpha-2 format.

  - `physicalCardDetails.deliveryAddress.contactNumber` (string)
    Mandatory when bulk delivery is selected. Will be printed on the box/packet to assist delivery.

  - `physicalCardDetails.deliveryMethod` (string)
    The delivery methods supported for delivering printed physical cards. If not specified, the STANDARD_DELIVERY method will be used.
    Enum: "STANDARD_DELIVERY", "REGISTERED_MAIL", "COURIER", "FIRST_CLASS_MAIL"

  - `physicalCardDetails.deliveryTrackingCode` (string)
    The delivery tracking code for tracking the physical card's delivery status. This may not always be available on the first dispatched event, and so you will receive an additional dispatched notification with the delivery tracking code populated as soon as it is available.

  - `physicalCardDetails.deliveryTrackingMethod` (string)
    The delivery tracking method for tracking the physical card's delivery status.

  - `physicalCardDetails.deliveryTrackingUrl` (string)
    The delivery tracking URL for tracking the physical card's delivery status.

  - `physicalCardDetails.replacement` (object)
    Indicates if the physical card is replaced by another card.

  - `physicalCardDetails.replacement.replacementReason` (string)
    The reason why the physical card was replaced.
  - DAMAGED: The physical card was damaged and cannot be used at a physical terminal.
  - LOST_STOLEN: The physical card was either lost or stolen and cannot be used.
  - EXPIRED: The physical card expired.
    Enum: "DAMAGED", "LOST_STOLEN", "EXPIRED"

  - `physicalCardDetails.replacement.replacementId` (string)
    The unique identifier of the new card that replaces this card.

  - `physicalCardDetails.nameOnCardLine2` (string)
    Line 2 of the 'name on card' field. For Physical cards, this field will be printed on the card. The maximum characters allowed will depend on the design chosen and will be provided to you by Weavr when setting up your plastic cards. This field is deprecated

  - `upgradedTimestamp` (string, required)
    Epoch timestamp using millisecond precision.


## Response 204 fields