Merge pull request #36 from razorpay/invoice-cancel

invoice: Adds cancel endpoint

README.md

@@ -100,14 +100,14 @@ Refund refund = razorpayClient.Payments.fetchRefund("refund_id");
 * Create Transfer for a payment:
 ```java
 JSONObject request = new JSONObject();
-    
+
 JSONArray transfers = new JSONArray();
 
 JSONObject transfer = new JSONObject();
 transfer.put("amount", <amount>); // The amount should be in paise.
 transfer.put("currency", "INR");
 transfer.put("account", <account_id>);
-    
+
 transfers.put(transfer);
 request.put("transfers", transfers);
 
@@ -164,7 +164,7 @@ List<Payment> payments = razorpayClient.Orders.fetchPayments("order_id");
 You can use the Utils class to verify the signature received in response to a payment made using Orders API
 ```java
 JSONObject paymentResponse = new JSONObject();
-options.put("razorpay_order_id", "<order_id>"); 
+options.put("razorpay_order_id", "<order_id>");
 options.put("razorpay_payment_id", "<payment_id>");
 options.put("razorpay_signature", "<signature>");
 Utils.verifyPaymentSignature(paymentResponse, "<secret_key>");
@@ -189,11 +189,10 @@ JSONObject request = new JSONObject();
 request.put("line_items", lineItems);
 request.put("date", 1480768625); // Timestamp in seconds
 request.put("currency", "INR");
-request.put("sms_notify", "0"); 
+request.put("sms_notify", "0");
 
 Invoice invoice = razorpayClient.Invoices.create(request);
 ```
-
 * Fetch a particular invoice:
 ```java
 Invoice invoice = razorpayClient.Invoices.fetch("invoice_id");
@@ -202,6 +201,10 @@ Invoice invoice = razorpayClient.Invoices.fetch("invoice_id");
 ```java
 List<Invoice> invoices = razorpayClient.Invoices.fetchAll();
 ```
+* Cancel a particular invoice:
+```java
+Invoice invoice = razorpayClient.Invoices.cancel("invoice_id");
+```
 
 ### [Cards](https://docs.razorpay.com/v1/page/cards)
 
@@ -256,7 +259,7 @@ JSONObject request = new JSONObject();
 request.put("amount", <amount>); // The amount should be in paise.
 request.put("currency", "INR");
 request.put("account", <account_id>);
-    
+
 Transfer transfer = razorpayClient.Transfers.create(request);
 ```
 
@@ -411,8 +414,8 @@ List<Payment> paymentList = razorpayClient.VirtualAccounts.fetchPayments("virtua
 
 * Make custom requests
 
-You can make custom API requests using clients. For example, here is how to make custom request to `/payments/path` endpoint. 
+You can make custom API requests using clients. For example, here is how to make custom request to `/payments/path` endpoint.
 
 ```java
 Entity response = razorpayClient.Payments.post("path", JSONObject requestBody);
-```
+```

src/main/java/com/razorpay/Constants.java

@@ -38,6 +38,7 @@ public class Constants {
   static final String INVOICE_CREATE = "invoices";
   static final String INVOICE_GET = "invoices/%s";
   static final String INVOICE_LIST = "invoices";
+  static final String INVOICE_CANCEL = "invoices/%s/cancel";
 
   static final String CARD_GET = "cards/%s";
 

src/main/java/com/razorpay/InvoiceClient.java

@@ -25,4 +25,8 @@ public List<Invoice> fetchAll(JSONObject request) throws RazorpayException {
   public Invoice fetch(String id) throws RazorpayException {
     return get(String.format(Constants.INVOICE_GET, id), null);
   }
+
+  public Invoice cancel(String id) throws RazorpayException {
+    return post(String.format(Constants.INVOICE_CANCEL, id), null);
+  }
 }