Blog posts by Jooeun Lee

Blog posts by Jooeun Lee2015-10-27T19:33:33.0000000Zhttps://world.optimizely.com/blogs/jooeun-lee/ Optimizely World AutoClose property for new EPiServer projectsI got a question from a customer about the AutoClose property being true on their CMS database that is created whenever they create a new EPiServer project in Visual Studio. A quick Google search reveals why they brought the topic… <a class="read-more-button" href="http://ejooeun.com/2015/10/27/autoclose-property-for-new-episerver-projects/">Read more</a> The post <a rel="nofollow" href="http://ejooeun.com/2015/10/27/autoclose-property-for-new-episerver-projects/">AutoClose property for new EPiServer projects</a> appeared first on <a rel="nofollow" href="http://ejooeun.com">ejooeun.com</a>. 2015-10-27T19:33:33.0000000Z

Blog post

AutoClose property for new EPiServer projectsI got a question from a customer about the AutoClose property being true on their CMS database that is created whenever they create a new EPiServer project in Visual Studio. A quick Google search reveals why they brought the topic… <a class="read-more-button" href="https://ejooeun.com/2015/10/27/autoclose-property-for-new-episerver-projects/">Read more</a> The post <a rel="nofollow" href="https://ejooeun.com/2015/10/27/autoclose-property-for-new-episerver-projects/">AutoClose property for new EPiServer projects</a> appeared first on <a rel="nofollow" href="https://ejooeun.com">ejooeun.com</a>. 2015-10-27T19:33:33.0000000Z

Blog post

The model item passed into the dictionary is of type ‘Castle.Proxies.MyVariationProxy’, but this dictionary requires a model item of type ‘EPiServerSite.Models.ViewModels.IPageViewModel`1 [EPiServerSite.Models.Pages.SitePageData]’Here is a quick “gotcha” that you might run into if you are adding EPiServer.Commerce to your CMS site: Server Error in ‘/’ Application. The model item passed into the dictionary is of type ‘Castle.Proxies.MyVariationProxy’, but this dictionary requires a… <a class="read-more-button" href="http://ejooeun.com/2015/09/25/the-model-item-passed-into-the-dictionary-is-of-type-castle-proxies-myvariationproxy-but-this-dictionary-requires-a-model-item-of-type-episerversite-models-viewmodels-ipageviewmodel1episerver/">Read more</a> The post <a rel="nofollow" href="http://ejooeun.com/2015/09/25/the-model-item-passed-into-the-dictionary-is-of-type-castle-proxies-myvariationproxy-but-this-dictionary-requires-a-model-item-of-type-episerversite-models-viewmodels-ipageviewmodel1episerver/">The model item passed into the dictionary is of type ‘Castle.Proxies.MyVariationProxy’, but this dictionary requires a model item of type ‘EPiServerSite.Models.ViewModels.IPageViewModel`1[EPiServerSite.Models.Pages.SitePageData]’</a> appeared first on <a rel="nofollow" href="http://ejooeun.com">ejooeun.com</a>. 2015-09-26T07:24:50.0000000Z

Blog post

Asset Importer fix for EPiServer Commerce 8 and CMS 8I recently helped a customer resolve this issue and will share the solution. The customer was developing on the latest versions of CMS and Commerce (i.e. version 8.X.Y). Breaking changes from CMS 7.X to CMS 8 prevented the <a href="/link/53298e30fbc24849a5720b1133a19563.aspx" target="_blank">Asset Importer</a> from running in a set-up with Commerce and CMS 8.X. In order to fix this, do the following: <ol> <li>Update the Asset Importer project to match your Commerce site by installing NuGet packages. <li>Get the fixes <a href="https://gist.github.com/jooeun/b5d6cc680df7ed9961f6">here</a>. <li>Run the tool <a href="/link/53298e30fbc24849a5720b1133a19563.aspx">as documented</a>.</li></li></li></ol> If you are interested in reading the details of the problem and the fix, go <a href="http://ejooeun.com/2015/08/29/asset-importer-fix-for-episerver-commerce-8-and-cms-8/" target="_blank">here</a>. If you need to solve this problem, I hope this helps. Please feel free to contact me with any questions/suggestions/bugs in EPiServer Expert Services by emailing me at jooeun.lee@episerver.com or by leaving a comment below.2015-09-09T02:59:54.0000000Z

Blog post

Asset Importer fix for EPiServer Commerce 8 and CMS 8First real blog post! As I noted in the previous post, these posts are part-information and part-discovery journal of a sort. This means that my posts can get pretty long (this one certainly is). Click on the TL;DR link in the… <a class="read-more-button" href="http://ejooeun.com/2015/08/29/asset-importer-fix-for-episerver-commerce-8-and-cms-8/">Read more</a> The post <a rel="nofollow" href="http://ejooeun.com/2015/08/29/asset-importer-fix-for-episerver-commerce-8-and-cms-8/">Asset Importer fix for EPiServer Commerce 8 and CMS 8</a> appeared first on <a rel="nofollow" href="http://ejooeun.com">ejooeun.com</a>. 2015-08-29T10:03:55.0000000Z

Blog post

EPiServerFor one thing, I plan to start blogging about my own findings as I continue to work with the EPiServer product and find out more about the pitfalls, errors, and hopefully, victories I have been working at EPiServer since 2012, following the acquisition of Mediachase.… <a class="read-more-button" href="http://ejooeun.com/2015/08/22/episerver/">Read more</a> The post <a rel="nofollow" href="http://ejooeun.com/2015/08/22/episerver/">EPiServer</a> appeared first on <a rel="nofollow" href="http://ejooeun.com">ejooeun.com</a>. 2015-08-22T20:33:23.0000000Z

Blog post

Hello world!Hello world, indeed. I have finally decided to get serious about blogging, so here it is. Topics I will be blogging about: Learning Software Development Don’t want to spend too long on a Hello World post! Here we go! The post <a rel="nofollow" href="http://ejooeun.com/2015/08/22/hello-world/">Hello world!</a> appeared first on <a rel="nofollow" href="http://ejooeun.com">ejooeun.com</a>. 2015-08-22T10:50:38.0000000Z

Blog post

Stripe Payment Provider for EPiServer Commerce<h2>Introduction/Motivation</h2> <a href="https://stripe.com/">Stripe</a> is a full-stack payment solution provider that is both user and developer-friendly. In this blog post, I will show how to implement a Stripe payment provider for EPiServer Commerce. You can <a href="https://stripe.com/us/features">use Stripe</a> to charge customer credit cards, set up recurring payments, store customer information, and much more with simple API calls (and great documentation to go with it) instead of implementing complicated payment gateway logic (take a look at EPiServer’s <a href="/link/f15d5bf1928a41f8977dff4caaea7462.aspx">PayPal payment provider</a> for comparison). It is also designed to reduce PCI-compliance exposure for your site with Stripe (more about that later if you are not already familiar with and <a href="https://stripe.com/help/security">in Stripe documentation</a>). Stripe provides pre-built libraries in several languages, but unfortunately, as of this blog’s writing, an official .NET library does not exist. Having said that, there are a few C# libraries written by various people. For this example here, I used this <a href="https://github.com/jaymedavis/stripe.net/">.NET library for Stripe</a>, a well-written, free library that you can add to your solution as a NuGet package. It is, however, a few versions behind the API at the time of writing this blog. The good news is that there is ongoing work to keep up with the official API, so chances are that your download will be fully up-to-date and compatible with the latest and greatest from Stripe. The Stripe payment provider in this blog is to demonstrate how to implement a payment gateway for your EPiServer Commerce site to charge customer credit cards. As you will see, this is not a standard EPiServer Commerce payment provider. Unlike other payment providers that must implement that payment gateway logic directly, this Stripe payment gateway boils down to a service call to Stripe, with error-checking as needed. Your front-end implementation will pass the sensitive information to Stripe directly to request a token. You will then pass the token to your server for further processing, having ensured that your server does not ever get to see the aforementioned sensitive data. Refer to the following links to read more about how to build a <a href="https://stripe.com/docs/tutorials/forms">custom form</a> to collect credit card information from the user and then to receive a token from Stripe that is valid only for one request by using <a href="https://stripe.com/docs/stripe.js">Stripe.js</a>. This is the approach recommended by Stripe when not using their embedded form called <a href="https://stripe.com/docs/checkout">Checkout</a>. <h2>Installation Instructions for Stripe and the Sample Implementation</h2> <h2>Requirements</h2> <h3>HTTPS, TLS (no SSL due to the <a href="https://stripe.com/blog/poodle">POODLE</a> vulnerability)</h3> According to this <a href="https://stripe.com/help/ssl#does-stripe-use-ssl-in-the-api">page</a>, Stripe is served only over TLS. You can test your page <a href="https://stripe.com/help/ssl#what-if-i-dont-want-to-set-up-ssl-yet">without encryption</a>, but you will eventually need to set up TLS when you want to go live. Add the <a href="https://www.nuget.org/packages/Stripe.net/">Stripe.net</a> library via NuGet to your project. <h2>Stripe Set-up</h2> Set up a free account with Stripe <a href="https://dashboard.stripe.com/register">here</a>. Your account will remain in test mode until you are ready to <a href="https://stripe.com/docs/tutorials/dashboard#activating-your-account">activate your account</a>. <h2>Setting Up the Sample Implementation</h2> You can find a bare-bones, sample site with the Stripe payment provider <a href="https://bitbucket.org/episerver-es/stripe-payment-provider">here</a>. Here are the steps to set up the solution so that you can test the payment provider. <ul> <li>Open the solution and build the solution to restore NuGet packages.</li> <li>In a command prompt, run msbuild.exe solution.targets /t:Setup. This sets up the databases for your front-end and Commerce Manager sites.</li> <li>Create two IIS sites to point to the SampleSite and CommerceManager projects in the solution.</li> <li>Import the test catalog. In Commerce Manager:</li> <li>Browse Catalog Management.</li> <li>Click on Catalogs.</li> <li>Click on Import/Export and select Import Catalog.</li> <li>Select the row with the test catalog.</li> <li>Click on Start Import.</li> <li>Follow the next sections to set up a payment method for Stripe.</li> </ul> <h2>Frontend site</h2> Add references to provider project and Stripe.Net NuGet package to your frontend site project. <h2>Commerce Manager</h2> Follow steps 1 through 5 under the “Creating a custom payment gateway” section <a href="/link/1497e13f805f4f2295f9688fa3068d29.aspx">here</a> to add the gateway to your Commerce Manager so that you can configure it. Alternatively, if you have a project for your Commerce Manager, you can directly add references to example payment provider project and Stripe.Net NuGet package to your project. Get API keys for your <a href="https://dashboard.stripe.com/account/apikeys">Stripe account</a>. Create a new payment method for the Stripe payment gateway in Commerce Manager by following steps 6 through 11 from the above link. Use “Stripe” as the System Keyword if you are following along the sample implementation. Step 10 is where you will save your API keys. Make a meta class for the payment method (import the attached MetaData export) by following these steps: <ul> <li>Navigate to the Order System/Meta Class node in the Administration section of Commerce Manager.</li> <li>Click on Create New at the top of the page and select New Meta Class.</li> <li>Enter the following in corresponding fields:</li> <li>Name: StripePayment</li> <li>Friendly Name: Stripe Payment</li> <li>Object Type: Select Order Form Payment</li> <li>Click OK.</li> <li>Click Meta Fields in the Left Menu under Administration / Order System.</li> <li>Click New Meta Field.</li> <li>Enter the following in corresponding fields:</li> <li>Name: StripeToken</li> <li>Friendly Name: Stripe Token</li> <li>Type: Select Short String</li> <li>Check Allow Null Values.</li> <li>Click OK.</li> <li>Repeat step 7 for “StripeChargeId”.</li> <li>Navigate back to Meta Classes in the Left Menu under Administration / Order System.</li> <li>Assign the newly created meta fields to the Stripe Payment meta class:</li> <li>For Element: select Order Form Payment</li> <li>For Type: select Stripe Payment</li> <li>Scroll down to the bottom of the screen and check the box for Stripe Token.</li> <li>The form will scroll to the top. Scroll back down to the bottom of the screen and click OK.</li> <li>Repeat steps a through d for Stripe Charge ID.</li> </ul> <h2>Testing the Sample Implementation</h2> Now that you are set up, pay for a new order with Stripe by following the steps below: <ul> <li>Browse to your front-end site. If a screen about migration comes up, click the link to start the migration process.</li> <li>Click Shopping in the top bar area.</li> <li>Click test-node, then test-sku.</li> <li>Click Buy. You will be redirected to the cart page.</li> <li>Click Checkout in the top bar.</li> <li>Click Single Shipment Checkout.</li> <li>Click Add Shipment.</li> <li>Click Add Payment (Stripe payment provider).</li> <li>Click Submit Payment to Stripe.</li> <li>Fill out the required fields (more information <a href="https://stripe.com/docs/testing#cards">here</a>).</li> <li>Card Number: 4242424242424242.</li> <li>Cvc: 123 (or any 3-digit number).</li> <li>Expiry Month and Year: Any future date.</li> <li>Other fields are optional for this demo.</li> <li>Click Submit Stripe payment.</li> <li>Click Complete Order.</li> <li>Note the purchase order tracking number.</li> <li>In Commerce Manager, browse to Order Management / Purchase Orders / Today to confirm that the purchase order with the tracking number from the previous step has been successfully created.</li> <li>In your Stripe account <a href="https://dashboard.stripe.com/test/dashboard">dashboard</a>, you can also check that the charge with the correct amount has been made.</li> </ul> <h2>Implementation Recommendations</h2> My particular implementation necessitated that I save the Stripe token in the database before making a charge. However, depending on your site implementation, you may not need to do this. The only requirement for using the gateway is to make sure StripePayment.Token is populated when you are ready to complete an order. Examine the ProcessPayments activity to make sure that the code will eventually hit the gateway. You can download the workflow activities code from <a href="/link/6d03901bee9f46e4b065b6a34501d574.aspx">here</a>. The main thing here is that payment status is “Pending”. Earlier in the post, I briefly mentioned that using Stripe helps reduce PCI-compliance exposure. You can have a look <a href="https://cmatskas.com/processing-payments-and-being-pci-compliant-with-stripe-js/">here</a> for a clear, concise, and generic example on how to make a Stripe charge using Stripe.js in a .NET project. The important thing here is that you do not submit sensitive information (credit card numbers, expiration dates, etc.) to your server. The example here achieves this by the following steps: <ul> <li>Leave inputs for sensitive information out of the submitted form altogether.</li> <li>Use <a href="https://stripe.com/docs/stripe.js">Stripe.js</a> to make a call to Stripe API and retrieve a one-time token.</li> <li>Submit the form with the card amount. All other fields are optional.</li> </ul> By doing this, you keep the sensitive information from reaching your server. One thing to remember is that using Stripe reduces your PCI-compliance exposure – it does NOT absolve you of PCI-compliance completely. After you post the form to the server, you can attach the token to a StripePayment object, add it to the cart, and run the checkout workflow to process the payment (i.e. make a charge) through the Stripe payment gateway. <h2>Further considerations</h2> If you have payment plans, you might want to consider implementing subscriptions for Stripe in addition to making it work with what is already in Commerce Manager. This way, you will be able to track your transactions on Stripe’s interface as well. <h2>Disclaimer/Limitations</h2> This is only an example implementation and is offered as is. This is not a supported payment provider by EPiServer and merely a demonstration project This project only supports making one-time charges of transaction type Mediachase.Commerce.Orders.TransactionType.Sale. If you need to solve this problem, I hope this helps. Please feel free to contact me with any questions/suggestions/bugs in EPiServer Expert Services at Jooeun dot Lee at episerver.com. <h2>Useful Links</h2> <a href="https://bitbucket.org/episerver-es/stripe-payment-provider">https://bitbucket.org/episerver-es/stripe-payment-provider</a> - Source of sample implementation on Expert Services Bitbucket account. <a href="https://stripe.com/docs">https://stripe.com/docs</a> - Stripe documentation. It is a great place to start learning about Stripe. <a href="/link/1497e13f805f4f2295f9688fa3068d29.aspx">http://world.episerver.com/documentation/Items/Developers-Guide/EPiServer-Commerce/8/Payments/Payment-gateways/</a> - EPiServer’s guide to implementing your own payment gateways. <a href="https://github.com/jaymedavis/stripe.net">https://github.com/jaymedavis/stripe.net</a> – GitHub repository of the Stripe.Net library used in this project. This library is very helpful in extracting away most of the complexities with working with Stripe in a .NET project. <a href="https://cmatskas.com/processing-payments-and-being-pci-compliant-with-stripe-js/">https://cmatskas.com/processing-payments-and-being-pci-compliant-with-stripe-js/</a>2015-05-14T02:55:07.4870000Z

Blog post