You can provide an endpoint that Vinoshipper will notify of changes in your account. All webhooks have the same format, and include the URL where you can get the full details of the order or customer that has been created or updates.

{
  "identifier": Order, customer, or membership ID,
  "subject": ORDER|CUSTOMER|CLUB_MEMBERSHIP,
  "event": APPROVED|CREATED|UPDATED|CANCELLED|DELETED|CARD_DECLINED|TRACKING_NUMBER_ADDED,
  "href": Deprecated, use hrefV3 instead,
  "hrefV3": URL to the resource, pointing to our newer v3 api
}

To add a web hook, go to Account -> Integrations -> Webhooks and specify the URL of your webhook listener.

If you do not see webhooks as an option, contact customerservice@vinoshipper.com to have webhooks enabled for your account.

Events

Once web hooks are enabled you will start receiving events for customer and order changes.

Customer Events

The event subject will be CUSTOMER and the identifier will contain the id of the customer.

Event Types

CREATED A customer has been created.
UPDATED One or more of s customer's attributes as been updated.
DELETED A customer has been deleted.

Order Events

The event subject will be ORDER and the identifier will be container the order number.

APPROVED An order has been approved.
CREATED A new completed order has been created.
UPDATED An order has been updated.
CANCELLED An order has been cancelled.
CARD_DECLINED An order failed to be created due to a credit card decline.
TRACKING_NUMBER_ADDED A new tracking number has been added to an order.

Club Membership Events

The event subject will be CLUB_MEMBERSHIP and the identifier will contain the membership ID.

Event Types

CREATED A customer has signed up for a wine club membership.

Cart Events

The event subject will be CART and the identifier will contain the cart ID.

Event Types

CREATED A new cart has been created with items added to it (This is for web store only).