API Reference

Shipping zone

Shipping zone

Shipping ZoneThis is used to view shipping zones, their countries, provinces, and shipping rates.What you can do with Shipping ZoneThe Haravan API lets you do the following with the Shipping Zone resource. More detailed versions of these general actions may be available:GET /admin/shipping_zones.jsonReceive a list of all Shipping ZonesHaravanShipping Zone...

ScriptTag

ScriptTag

ScriptTagThe ScriptTag resource represents remote javascripts which are loaded into the pages of a shop's storefront and in the order status page of checkout. This makes it easy to add functionality to those pages without touching any theme templates.A script tag has the following attributes:src: The URL of the remote script.event: The...

Product Image

Product Image

haravan API - Developer Resources Product ImageProduct ImageProducts are easier to sell if customers can see pictures of them, which is why there are product images.Any product may have up to 250 images, and images can be in .png, .gif or .jpg format.What can you do with Product Image?The haravan...

Province

Province

haravan API - Developer Resources ProvinceProvinceShop owners can specify which country or countries they will ship to and these countries are made available through the API using the country resource. Shop owners can do this by navigating to the "Preferences" tab under "Regions & Taxes." If any of those countries...

Redirect

Redirect

haravan API - Developer Resources RedirectRedirectA redirect causes a visitor on a specific path on the shop's site to be automatically sent to a target (different location). The target can be a new location on the shop's site, or a full URL, even one on a completely different domain. Redirect...

Policy

Policy

haravan API - Developer Resources PolicyPolicyThe list of policies that a merchant has configured for their store, such as their refund or privacy policies.Only the shop owner can edit this information from inside their shop admin dashboard by navigating to the "Settings" tab and selecting the "General" tab. The API...

FulfillmentService

FulfillmentService

haravan API - Developer Resources FulfillmentServiceFulfillmentServiceA Fulfillment Service is a third party warehouse that prepares and ships orders on behalf of the store owner. Fulfillment services charge a fee to package and ship items and update product inventory levels. Some well known fulfillment services with haravan integrations include: Amazon, Shipwire,...

Location

Location

haravan API - Developer Resources LocationLocationA Location represents a geographical location where your stores, headquarters, and/or pop-up shops exist. These locations can be used to track sales and to help haravan configure the tax rates to charge when selling products.What can you do with Location?The haravan API lets you do...

RecurringApplicationCharge

RecurringApplicationCharge

haravan API - Developer Resources RecurringApplicationChargeRecurringApplicationChargeRequest to charge a shop a recurring fee (every 30 days) by issuing this call with the name the charge should appear under (on the shop owner’s invoice), the price your application is charging, and a return_url to where haravan will redirect the shop owner...

Fulfillment

Fulfillment

haravan API - Developer Resources FulfillmentFulfillmentA fulfillment represents a shipment of one or more items in an order. When we say that an order has been completely fulfilled, we mean that all the items that make up that order have been sent to the customer.Ideally, a shop owner would want...

Transaction

Transaction

haravan API - Developer Resources TransactionTransactionTransactions are created for every order that results in an exchange of money.There are five types of transactions:Authorization: represents an amount reserved against the cardholder's funding source. Money does not change hands until an authorization is captured.Sale: an authorization and capture performed together in a...

Product Variant

Product Variant

haravan API - Developer Resources Product VariantProduct VariantA product variant is a different version of a product, such as differing sizes or differing colours.Without product variants, you would have to treat the small, medium and large versions of a t-shirt as three separate products; product variants let you treat the...

Metafield

Metafield

haravan API - Developer Resources MetafieldMetafieldMetafields allow you to attach metadata, which is additional information, to a store's resources.Metafields can be added to:BlogsCustom CollectionsCustomersOrdersPagesProductsProduct VariantsMetafields have four required properties: a key, a namespace, a value and a value_type. The key is the identifier for a metafield. The namespace functions a...

Order

Order

haravan API - Developer Resources OrderOrderAn order is a customer's completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time s/he provides an email address, billing address and payment information.You should note that orders can...

Blog

Blog

haravan API - Developer Resources BlogBlogIn addition to an online storefront, haravan shops come with a built-in blogging engine, allowing a shop to have one or more blogs.Shop owners are encouraged to use blogs to:Make announcementsTalk about their products in more detailShow off their expertiseConnect with their customers andBoost their...

Collect

Collect

haravan API - Developer Resources CollectCollectA collect is an object that connects a product to a custom collection.For every product in a custom collection there exists a collect that tracks the ids of both the product and the custom collection it's a member of. A product can be a member...

Country

Country

haravan API - Developer Resources CountryCountryShop owners can specify the country or countries they will ship their products to. Shop owners are able to do this through their shop admin dashboard in the "Settings" tab, under the "Taxes" tab.These countries are made available through the API using the country resource....

Customer

Customer

haravan API - Developer Resources CustomerCustomerThe Customer resource stores information about a shop's customers, such as their contact details, their order history, and whether they've agreed to receive email marketing.The Customer resource also holds information on the status of a customer's account. Customers with accounts save time at checkout when...

CustomerAddress

CustomerAddress

haravan API - Developer Resources CustomerAddressCustomerAddressA customer address resource instance represents one of the many addresses a customer may haveFor more information about Customers, see the Customer API DocumentationWhat can you do with CustomerAddress?The haravan API lets you do the following with the CustomerAddress resource. More detailed versions of these...

Order Risks

Order Risks

haravan API - Developer Resources Order RisksOrder RisksThe Order risk assessment is used to indicate to a merchant the fraud checks that have been done on an order.What can you do with Order Risks?The haravan API lets you do the following with the Order Risks resource. More detailed versions of...

Theme

Theme

haravan API - Developer Resources ThemeThemeA theme is the look and feel template for your haravan shop.A shop can have multiple themes which take the role of either "published" or "unpublished". Each shop can have 20 themes total, including one main theme, and a max of 19 unpublished themes. The...

Checkout

Checkout

haravan API - Developer Resources CheckoutCheckoutThis is used to return abandoned checkouts. A checkout is considered abandoned when a customer has entered their billing & shipping info, but has yet to complete the purchase.What can you do with Checkout?The haravan API lets you do the following with the Checkout resource....

Shop

Shop

haravan API - Developer Resources ShopShopThe haravan API's shop object is a collection of the general settings and information about the shop.Only the shop owner can edit this information from inside their shop admin dashboard by navigating to the "Settings" tab and selecting the "General" tab. The API doesn't let...

CarrierService

CarrierService

haravan API - Developer Resources CarrierServiceCarrierServiceA Carrier Service (also known as a Carrier Calculated Service or Shipping Service) provides real-time shipping rates to haravan. Some common carrier services include: FedEx, USPS and UPS.ReminderAccess to the Carrier Services API requires the store be on the Unlimited Plan or higher. The term...

Metafield

Metafield

haravan API - Developer Resources MetafieldMetafieldMetafields allow you to attach metadata, which is additional information, to a store's resources.Metafields can be added to:BlogsCustom CollectionsCustomersOrdersPagesProductsProduct VariantsMetafields have four required properties: a key, a namespace, a value and a value_type. The key is the identifier for a metafield. The namespace functions a...

Policy

Policy

haravan API - Developer Resources PolicyPolicyThe list of policies that a merchant has configured for their store, such as their refund or privacy policies.Only the shop owner can edit this information from inside their shop admin dashboard by navigating to the "Settings" tab and selecting the "General" tab. The API...

Haravan - Công ty công nghệ cung cấp giải pháp kinh doanh thương mại điện tử, duy nhất tại Việt Nam được Google lựa chọn vào chương trình bệ phóng tiềm năng với hỗ trợ và đào tạo công nghệ để vươn ra thị trường quốc tế vững chắc.