Merge pull request #7 from paypal/master

rajarampadmanathan · web-flow · commit 292876d699a7 · 2019-02-05T14:33:09.000-08:00
master to develop
diff --git a/README.MD b/README.MD
@@ -14,21 +14,36 @@ An environment which supports TLS 1.2 (see the TLS-update site for more informat
 
 ## Usage
 
+### Binaries
+
+It is not mandatory to fork this repository for using the PayPal SDK. You can refer [PayPal Checkout Server SDK](https://developer.paypal.com/docs/checkout/reference/server-integration) for configuring and working with SDK without forking this code.
+
+For contirbuting or referrring the samples, You can fork/refer this repository. 
 ### Setting up credentials
 Get client ID and client secret by going to https://developer.paypal.com/developer/applications and generating a REST API app. Get <b>Client ID</b> and <b>Secret</b> from there.
 
 ```dotnet
+using System;
 using PayPalCheckoutSdk.Core;
+using PayPalCheckoutSdk.Orders;
+using BraintreeHttp;
+using System.Collections.Generic;
+using System.Threading.Tasks;
 
-public class Credentials {
-    static String clientId = "CLIENT-ID";
-    static String secret = "CLIENT-SECRET";
-    
+public class CaptureOrderSample 
+{
+    static String clientId = "PAYPAL-CLIENT-ID";
+    static String secret = "PAYPAL-CLIENT-SECRET";
+
+    public static HttpClient client()
+    {
     // Creating a sandbox environment
-    var environment = new SandboxEnvironment(clientId, secret);
-    
+    PayPalEnvironment environment = new SandboxEnvironment(clientId, secret);
+
     // Creating a client for the environment
-    var client = new PayPalHttpClient(environment);
+    PayPalHttpClient client = new PayPalHttpClient(environment);
+    return client;
+    }
 }
 ```
 
@@ -37,11 +52,9 @@ public class Credentials {
 This will create an order and print order id for the created order
 
 ```dotnet
-using PayPalCheckoutSdk.Orders;
-
-public class CreateOrderExample {
-    static void main(String[] args){
-        
+public async static Task<HttpResponse> createOrder()
+ {
+         HttpResponse response;
         // Construct a request object and set desired parameters
         // Here, OrdersCreateRequest() creates a POST request to /v2/checkout/orders
         var order = new OrderRequest() {
@@ -50,83 +63,71 @@ public class CreateOrderExample {
                 {
                     new PurchaseUnitRequest()
                     {
-                        ReferenceId = "test_ref_id1",
                         Amount = new AmountWithBreakdown()
                         {
                             CurrencyCode = "USD",
                             Value = "100.00"
                         }
                     }
-                }, 
+                },
                 ApplicationContext = new ApplicationContext()
                 {
                     ReturnUrl = "https://www.example.com",
                     CancelUrl = "https://www.example.com"
                 }
             };
-        
-        
+
+
             // Call API with your client and get a response for your call
             var request = new OrdersCreateRequest();
             request.Prefer("return=representation");
             request.RequestBody(order);
-            try 
-            {
-              HttpResponse response = await client().Execute(request);
-              var statusCode = response.StatusCode;
-              Order result = response.Result<Payment>();
-            } 
-            catch(HttpException httpException) 
+            response = await client().Execute(request);
+            var statusCode = response.StatusCode;
+            Order result = response.Result<Order>();
+            Console.WriteLine("Status: {0}", result.Status);
+            Console.WriteLine("Order Id: {0}", result.Id);
+            Console.WriteLine("Intent: {0}", result.Intent);
+            Console.WriteLine("Links:");
+            foreach (LinkDescription link in result.Links)
             {
-              var statusCode = httpException.StatusCode;
-              var debugId = httpException.Headers.GetValues("PayPal-Debug-Id").FirstOrDefault();
+                 Console.WriteLine("\t{0}: {1}\tCall Type: {2}", link.Rel, link.Href, link.Method);
             }
+            return response;
     }
-}
 ```
 
 ### Capturing an Order
-This will capture an order
+Before capturing an order, order should be approved by the buyer using the approve link in create order response
 ```dotnet
-using PayPalCheckoutSdk.Orders;
-
-public class CaptureOrderExample {
-    static void main(String[] args){
-        
+  public async static Task<HttpResponse> captureOrder()
+    {
             // Construct a request object and set desired parameters
-            // Here, OrdersCaptureRequest() creates a POST request to /v2/checkout/orders
-            // Replace ORDER-ID with the order id from create order
-            var request = new OrdersCaptureRequest("ORDER-ID");
-            
-            request.RequestBody(order);
-            try 
-            {
-              HttpResponse response = await client().Execute(request);
-              var statusCode = response.StatusCode;
-              Order result = response.Result<Payment>();
-            } 
-            catch(HttpException httpException) 
-            {
-              var statusCode = httpException.StatusCode;
-              var debugId = httpException.Headers.GetValues("PayPal-Debug-Id").FirstOrDefault();
-            }
+            // Replace ORDER-ID with the approved order id from create order
+            var request = new OrdersCaptureRequest("69E54436G09638353");
+            request.RequestBody(new OrderActionRequest());
+            HttpResponse response = await client().Execute(request);
+            var statusCode = response.StatusCode;
+            Order result = response.Result<Order>();
+            Console.WriteLine("Status: {0}", result.Status);
+            Console.WriteLine("Capture Id: {0}", result.Id);
+            return response;
     }
-}
 ```
 ## Running tests
 
 To run integration tests using your client id and secret, run the `test` gradle command with the `-Pintegration` flag
 ```sh
-$ dotnet test -v normal
+$ PAYPAL_CLIENT_ID=YOUR_SANDBOX_CLIENT_ID PAYPAL_CLIENT_SECRET=YOUR_SANDBOX_CLIENT_SECRET dotnet test -v normal
 ```
 
 You may use the client id and secret above for demonstration purposes.
 
 
-*NOTE*: This SDK is still in beta, is subject to change, and should not be used in production.
-
 ## Samples
 
 You can start off by trying out [creating and capturing an order](/Samples/CaptureIntentExamples/RunAll.java).
 
 To try out different samples for both create and authorize intent head to [this link](/Samples).
+
+Note: Update the `PayPalClient.cs` with your sandbox client credentials or pass your client credentials as environment variable whie executing the samples.
