Amazon Checkout Helper for WebMatrix

Helper Methods

Note: Current version does not support the full Checkout by Amazon API.

The helper mainly consists of a AmazonCheckout.cshtml file that should be placed in the App_Code folder of your WebMatrix site.

static void	Initialize(string merchantId, string awsAccessKeyId = null, string secretKeyId = null, X509Certificate2 x509Certificate = null, string associateTag = null, bool useSandbox = true, string currencyCode = "USD", string lengthUnitOfMeasure = "IN", string volumeUnitOfMeasure = "cubic-cm", string weightUnitOfMeasure = "LB", string jewelryWeightUnitOfMeasure = "LB", string degreeUnitOfMeasure = "degrees", string memorySizeUnitOfMeasure = "GB", string frequencyUnitOfMeasure = "MHz", string amperageUnitOfMeasure = "amps", string timeUnitOfMeasure = "sec", string dateUnitOfMeasure = "days", string assemblyTimeUnitOfMeasure = "minutes", string ageRecommendedUnitOfMeasure = "months", string batteryPowerUnitOfMeasure = "mAh", string voltageUnitOfMeasure = "volts", string wattageUnitOfMeasure = "watts", string temperatureRatingUnitOfMeasure = "degrees-celsius", string clothingSizeUnitOfMeasure = "IN")
	Initializes the Amazon Checkout helper. Examples Initialize Helper with AWS Signatures @{ AmazonCheckout.Initialize( merchantId: "{merchantId}", awsAccessKeyId: "{awsAccessKeyId}", secretKeyId: "{secretKeyId}") } Initialize Helper with X.509 Signatures @using System.Security.Cryptography.X509Certificates; @{ AmazonCheckout.Initialize( merchantId: "{merchantId}", x509Certificate: new X509Certificate2(@"pfx-location", "YouPassword"), } Note: to use X.509 certificates you must include the System.Security.dll assembly in the bin folder of the application
static HelperResult	GetAmazonButton( string name, string description, Decimal price, string imageUrl, double weight, string categoryName, string promotionId, string condition, string taxTableId, string imageButtonUrl = "https://payments.amazon.com/gp/cba/button?ie=UTF8&color=orange&background=white&size=medium", string alternativeButtonText = "Checkout with Amazon Payments", int quantity = 1, string sku = "", bool expressCheckout = true, string[] upsellingItems = null, string[] inclusionCategories = null, string[] exclusionCategories = null)
	Shows the Checkout By Amazon or the Add to Cart button depending on your configuration
static HelperResult	GetAmazonButton( AmazonCheckout.AmazonCart shoppingCart, string imageButtonUrl = "https://payments.amazon.com/gp/cba/button?ie=UTF8&color=orange&background=white&size=medium", string alternativeButtonText = "Checkout with Amazon Payments", bool expressCheckout = true)
	Initializes the Amazon CBA helper.
static AmazonCart	CreateAmazonCart()
	Creates an empty Shopping Cart.
static AmazonCart	AddItem(string name, string description, Decimal price, string imageUrl, int quantity, string sku, double? weight = null, string categoryName = null, string promotionId = null, string condition = null, string taxTableId = null, IEnumerable shippingMethodIds = null)
	Adds Items to the cart.
AmazonCart	AddUpsellingItems(IEnumerable items)
	Add items for upsell in the checkout's process
AmazonCart	AddInclusionCategories(IEnumerable items)
	Add an inclusion category in the checkout's process
AmazonCart	AddExclusionCategories(IEnumerable items)
	Add an exclusion category in the checkout's process
AmazonCart	WithFixedAmountDiscount(string promotionId, string description, decimal amount)
	Define a Fixed Amount Discount for the Shopping Cart
AmazonCart	WithDiscountRate(string promotionId, string description, decimal value)
	Define a promotion discount for the Shopping Cart
@AmazonCheckout	GetShoppingCart(Func minimizedTemplate = null, string cartAligment = "right")
	Shows the cart
TaxTable	AddRuleForUSZipRegion(string zipCode, decimal rate, bool isShippingTaxed = false)
	Adds a rule for a ZIP region of type Example @{ singleItemCart.DefaultTaxTable .AddRuleForPredefinedRegion(AmazonCheckout.AmazonPredefinedRegion.USContinental48States, 0.06m) .AddRuleForUSState("WA", 0.15m, true) .AddRuleForUSZipRegion("98004", 0.03m); }
TaxTable	AddRuleForPredefinedRegion(AmazonPredefinedRegion region, decimal rate, bool isShippingTaxed = false)
	Adds a rule for a predefined region Possible predefined regions AmazonCheckout.AmazonPredefinedRegion.USContinental48States AmazonCheckout.AmazonPredefinedRegion.USFull50States AmazonCheckout.AmazonPredefinedRegion.USAll AmazonCheckout.AmazonPredefinedRegion.WorldAll
TaxTable	AddRuleForUSState(string stateCode, decimal rate, bool isShippingTaxed = false)
	Adds a rule for a state region Possible values for stateCode Show/hide listing "AL" ( Alabama ) "AK" ( Alaska ) "AZ" ( Arizona ) "AR" ( Arkansas ) "CA" ( California ) "CO" ( Colorado ) "CT" ( Connecticut ) "DE" ( Delaware ) "DC" ( District of Columbia ) "FL" ( Florida ) "GA" ( Georgia ) "HI" ( Hawaii ) "ID" ( Idaho ) "IL" ( Illinois ) "IN" ( Indiana ) "IA" ( Iowa ) "KS" ( Kansas ) "KY" ( Kentucky ) "LA" ( Louisiana ) "ME" ( Maine ) "MD" ( Maryland ) "MA" ( Massachusetts ) "MI" ( Michigan ) "MN" ( Minnesota ) "MS" ( Mississippi ) "MO" ( Missouri ) "MT" ( Montana ) "NE" ( Nebraska ) "NV" ( Nevada ) "NH" ( New Hampshire ) "NJ" ( New Jersey ) "NM" ( New Mexico ) "NY" ( New York ) "NC" ( North Carolina ) "ND" ( North Dakota ) "OH" ( Ohio ) "OK" ( Oklahoma ) "OR" ( Oregon ) "PA" ( Pennsylvania ) "RI" ( Rhode Island ) "SC" ( South Carolina ) "SD" ( South Dakota ) "TN" ( Tennessee ) "TX" ( Texas ) "UT" ( Utah ) "VT" ( Vermont ) "VA" ( Virginia ) "WA" ( Washington ) "WV" ( West Virginia ) "WI" ( Wisconsin ) "WY" ( Wyoming )
TaxTable	AddRuleForPostalRegion(string postalRegion, decimal rate, bool isShippingTaxed = false)
	Adds a rule for a postal region
TaxTable	AddRuleForCountry(string countryCode, decimal rate, bool isShippingTaxed = false)
	Adds a rule for a country region Possible values for countryCode Show/hide listing "AF" ( Afghanistan ) "AX" ( Åland Islands ) "AL" ( Albania ) "DZ" ( Algeria ) "AS" ( American Samoa ) "AD" ( Andorra ) "AO" ( Angola ) "AI" ( Anguilla ) "AQ" ( Antarctica ) "AG" ( Antigua and Barbuda ) "AR" ( Argentina ) "AM" ( Armenia ) "AW" ( Aruba ) "AU" ( Australia ) "AT" ( Austria ) "AZ" ( Azerbaijan ) "BS" ( Bahamas ) "BH" ( Bahrain ) "BD" ( Bangladesh ) "BB" ( Barbados ) "BY" ( Belarus ) "BE" ( Belgium ) "BZ" ( Belize ) "BJ" ( Benin ) "BM" ( Bermuda ) "BT" ( Bhutan ) "BO" ( Bolivia ) "BA" ( Bosnia and Herzegovina ) "BW" ( Botswana ) "BV" ( Bouvet Island ) "BR" ( Brazil ) "IO" ( British Indian Ocean Territory ) "BN" ( Brunei ) "BG" ( Bulgaria ) "BF" ( Burkina Faso ) "BI" ( Burundi ) "KH" ( Cambodia ) "CM" ( Cameroon ) "CA" ( Canada ) "CV" ( Cape Verde ) "KY" ( Cayman Islands ) "CF" ( Central African Republic ) "TD" ( Chad ) "CL" ( Chile ) "CN" ( China ) "CX" ( Christmas Island ) "CC" ( Cocos Islands ) "CO" ( Colombia ) "KM" ( Comoros ) "CG" ( Congo ) "CD" ( Congo, the Democratic Republic of the ) "CK" ( Cook Islands ) "CR" ( Costa Rica ) "CI" ( Côte d'Ivoire ) "HR" ( Croatia ) "CU" ( Cuba ) "CY" ( Cyprus ) "CZ" ( Czech Republic ) "DK" ( Denmark ) "DJ" ( Djibouti ) "DM" ( Dominica ) "DO" ( Dominican Republic ) "EC" ( Ecuador ) "EG" ( Egypt ) "SV" ( El Salvador ) "GQ" ( Equatorial Guinea ) "ER" ( Eritrea ) "EE" ( Estonia ) "ET" ( Ethiopia ) "FK" ( Falkland Islands ) "FO" ( Faroe Islands ) "FJ" ( Fiji ) "FI" ( Finland ) "FR" ( France ) "GF" ( French Guiana ) "PF" ( French Polynesia ) "TF" ( French Southern Territories ) "GA" ( Gabon ) "GM" ( Gambia ) "GE" ( Georgia ) "DE" ( Germany ) "GH" ( Ghana ) "GI" ( Gibraltar ) "GR" ( Greece ) "GL" ( Greenland ) "GD" ( Grenada ) "GP" ( Guadeloupe ) "GU" ( Guam ) "GT" ( Guatemala ) "GN" ( Guinea ) "GW" ( Guinea-Bissau ) "GY" ( Guyana ) "HT" ( Haiti ) "HM" ( Heard Island And McDonald Islands ) "HN" ( Honduras ) "HK" ( Hong Kong ) "HU" ( Hungary ) "IS" ( Iceland ) "IN" ( India ) "ID" ( Indonesia ) "IR" ( Iran ) "IQ" ( Iraq ) "IE" ( Ireland ) "IL" ( Israel ) "IT" ( Italy ) "JM" ( Jamaica ) "JP" ( Japan ) "JO" ( Jordan ) "KZ" ( Kazakhstan ) "KE" ( Kenya ) "KI" ( Kiribati ) "KP" ( Korea, Demoratic People's Republic of ) "KR" ( Korea, Republic of ) "KW" ( Kuwait ) "KG" ( Kyrgyzstan ) "LA" ( Laos ) "LV" ( Latvia ) "LB" ( Lebanon ) "LS" ( Lesotho ) "LR" ( Liberia ) "LY" ( Libya ) "LI" ( Liechtenstein ) "LT" ( Lithuania ) "LU" ( Luxembourg ) "MO" ( Macao ) "MK" ( Macedonia ) "MG" ( Madagascar ) "MW" ( Malawi ) "MY" ( Malaysia ) "MV" ( Maldives ) "ML" ( Mali ) "MT" ( Malta ) "MH" ( Marshall Islands ) "MQ" ( Martinique ) "MR" ( Mauritania ) "MU" ( Mauritius ) "YT" ( Mayotte ) "MX" ( Mexico ) "FM" ( Micronesia ) "MD" ( Moldova ) "MC" ( Monaco ) "MN" ( Mongolia ) "MS" ( Montserrat ) "MA" ( Morocco ) "MZ" ( Mozambique ) "MM" ( Myanmar ) "NA" ( Namibia ) "NR" ( Nauru ) "NP" ( Nepal ) "NL" ( Netherlands ) "AN" ( Netherlands Antilles ) "NC" ( New Caledonia ) "NZ" ( New Zealand ) "NI" ( Nicaragua ) "NE" ( Niger ) "NG" ( Nigeria ) "NU" ( Niue ) "NF" ( Norfolk Island ) "MP" ( Northern Mariana Islands ) "NO" ( Norway ) "OM" ( Oman ) "PK" ( Pakistan ) "PW" ( Palau ) "PS" ( Palestine ) "PA" ( Panama ) "PG" ( Papua New Guinea ) "PY" ( Paraguay ) "PE" ( Peru ) "PH" ( Philippines ) "PN" ( Pitcairn ) "PL" ( Poland ) "PT" ( Portugal ) "PR" ( Puerto Rico ) "QA" ( Qatar ) "RE" ( Reunion ) "RO" ( Romania ) "RU" ( Russia ) "RW" ( Rwanda ) "SH" ( Saint Helena ) "KN" ( Saint Kitts And Nevis ) "LC" ( Saint Lucia ) "PM" ( Saint Pierre And Miquelon ) "VC" ( Saint Vincent And The Grenadines ) "WS" ( Samoa ) "SM" ( San Marino ) "ST" ( Sao Tome And Principe ) "SA" ( Saudi Arabia ) "SN" ( Senegal ) "CS" ( Serbia and Montenegro ) "SC" ( Seychelles ) "SL" ( Sierra Leone ) "SG" ( Singapore ) "SK" ( Slovakia ) "SI" ( Slovenia ) "SB" ( Solomon Islands ) "SO" ( Somalia ) "ZA" ( South Africa ) "GS" ( South Georgia And The South Sandwich Islands ) "ES" ( Spain ) "LK" ( Sri Lanka ) "SD" ( Sudan ) "SR" ( Suriname ) "SJ" ( Svalbard And Jan Mayen ) "SZ" ( Swaziland ) "SE" ( Sweden ) "CH" ( Switzerland ) "SY" ( Syria ) "TW" ( Taiwan ) "TJ" ( Tajikistan ) "TZ" ( Tanzania ) "TH" ( Thailand ) "TL" ( Timor-Leste ) "TG" ( Togo ) "TK" ( Tokelau ) "TO" ( Tonga ) "TT" ( Trinidad and Tobago ) "TN" ( Tunisia ) "TR" ( Turkey ) "TM" ( Turkmenistan ) "TC" ( Turks And Caicos Islands ) "TV" ( Tuvalu ) "UG" ( Uganda ) "UA" ( Ukraine ) "AE" ( United Arab Emirates ) "GB" ( United Kingdom ) "US" ( United States ) "UM" ( United States Minor Outlying Islands ) "UY" ( Uruguay ) "UZ" ( Uzbekistan ) "VU" ( Vanuatu ) "VA" ( Vatican ) "VE" ( Venezuela ) "VN" ( Vietnam ) "VG" ( Virgin Islands, British ) "VI" ( Virgin Islands, U.S. ) "WF" ( Wallis And Futuna ) "EH" ( Western Sahara ) "YE" ( Yemen ) "ZM" ( Zambia ) "ZW" ( Zimbabwe )
ShippingMethod	IncludeUSZipRegion(string zipCode)
	Includes a zip region of a given zip code in the shipping Example @{ shoppingCart.ShippingMethods.Add("shipping-1", "Standard shipping") .WithServiceLevel(AmazonCheckout.ServiceLevel.OneDay) .WithItemQuantityBasedShippingRate(5) .WithShipmentBasedShippingRate(10) .WithWeightBasedShippingRate(12) .IncludeCountryRegion("US") .IncludePredefinedRegion(AmazonCheckout.AmazonPredefinedRegion.USFull50States) .IncludeUSZipRegion("98004") .IncludeUSStateRegion("CA") .ExcludeCountryRegion("GB") .ExcludeUSZipRegion("01984") .ExcludeUSStateRegion("AZ"); }
ShippingMethod	IncludePredefinedRegion(AmazonPredefinedRegion region)
	Includes a predefined region in the shipping method Possible predefined regions AmazonCheckout.AmazonPredefinedRegion.USContinental48States AmazonCheckout.AmazonPredefinedRegion.USFull50States AmazonCheckout.AmazonPredefinedRegion.USAll AmazonCheckout.AmazonPredefinedRegion.WorldAll Example @{ shoppingCart.ShippingMethods.Add("shipping-1", "Standard shipping") .WithServiceLevel(AmazonCheckout.ServiceLevel.OneDay) .WithItemQuantityBasedShippingRate(5) .WithShipmentBasedShippingRate(10) .WithWeightBasedShippingRate(12) .IncludeCountryRegion("US") .IncludePredefinedRegion(AmazonCheckout.AmazonPredefinedRegion.USFull50States) .IncludeUSZipRegion("98004") .IncludeUSStateRegion("CA") .ExcludeCountryRegion("GB") .ExcludeUSZipRegion("01984") .ExcludeUSStateRegion("AZ"); }
ShippingMethod	IncludeUSStateRegion(string stateCode)
	Includes a US State region in the shipping (See AddRuleForUsState method for a list of possible US State region codes)
ShippingMethod	IncludePostalRegion(string postalRegion)
	Includes a Postal region in the shipping
ShippingMethod	IncludeCountryRegion(string countryCode)
	Includes a Country region in the shipping (See AddRuleForCountry method for a list of possible Country region codes)
ShippingMethod	ExcludeUSZipRegion(string zipCode)
	Excludes a zip region of a given zip code of the shipping
ShippingMethod	ExcludePredefinedRegion(AmazonPredefinedRegion region)
	Excludes a predefined region in the shipping method Possible predefined regions AmazonCheckout.AmazonPredefinedRegion.USContinental48States AmazonCheckout.AmazonPredefinedRegion.USFull50States AmazonCheckout.AmazonPredefinedRegion.USAll AmazonCheckout.AmazonPredefinedRegion.WorldAll
ShippingMethod	ExcludeUSStateRegion(string stateCode)
	Excludes a US State region of the shipping (See AddRuleForUsState method for a list of possible US State region codes)
ShippingMethod	ExcludePostalRegion(string postalRegion)
	Excludes a Postal region in the shipping
ShippingMethod	ExcludeCountryRegion(string countryCode)
	Excludes a Country region in the shipping (See AddRuleForCountry method for a list of possible Country region codes)
ShippingMethod	WithServiceLevel(ServiceLevel serviceLevel)
	Possible service levels AmazonCheckout.ServiceLevel.Standard AmazonCheckout.ServiceLevel.Expedited AmazonCheckout.ServiceLevel.OneDay AmazonCheckout.ServiceLevel.TwoDay Example @{ shoppingCart.ShippingMethods.Add("shipping-1", "Standard shipping") .WithServiceLevel(AmazonCheckout.ServiceLevel.OneDay) .WithItemQuantityBasedShippingRate(5) .WithShipmentBasedShippingRate(10) .WithWeightBasedShippingRate(12) .IncludeCountryRegion("US") .IncludePredefinedRegion(AmazonCheckout.AmazonPredefinedRegion.USFull50States) .IncludeUSZipRegion("98004") .IncludeUSStateRegion("CA") .ExcludeCountryRegion("GB") .ExcludeUSZipRegion("01984") .ExcludeUSStateRegion("AZ"); }
ShippingMethod	WithShipmentBasedShippingRate(decimal rate)

ShippingMethod	WithWeightBasedShippingRate(decimal rate)

ShippingMethod	WithItemQuantityBasedShippingRate(decimal rate)

Microsoft WebMatrix Helpers

Amazon Checkout Helper - Reference

Helper Methods

Examples

Initialize Helper with AWS Signatures

Initialize Helper with X.509 Signatures

Example

Possible predefined regions

Possible values for stateCode

Possible values for countryCode

Example

Possible predefined regions

Example

Possible predefined regions

Possible service levels

Example