Invoices - Add List, Show, Create, Void, Resolve

https://commerce.coinbase.com/docs/api/\#invoices

Author: Rizal Widyarta Gowandy

.golangci.yaml

@@ -135,6 +135,9 @@ issues:
     - path: stub
       linters:
         - funlen
+    - path: api
+      linters:
+        - dupl
 
     # https://github.com/go-critic/go-critic/issues/926
     - linters:

README.md

@@ -140,4 +140,9 @@ Version: 2018-03-22
    - [Show a checkout](https://commerce.coinbase.com/docs/api/#show-a-checkout)
    - [Create a checkout](https://commerce.coinbase.com/docs/api/#create-a-checkout)
    - [Update a checkout](https://commerce.coinbase.com/docs/api/#update-a-checkout)
-   - [Delete a checkout](https://commerce.coinbase.com/docs/api/#delete-a-checkout)
+   - [Delete a checkout](https://commerce.coinbase.com/docs/api/#delete-a-checkout)
+- [Invoices](https://commerce.coinbase.com/docs/api/#invoices)
+   - [Create an invoice](https://commerce.coinbase.com/docs/api/#create-an-invoice)
+   - [Show an invoice](https://commerce.coinbase.com/docs/api/#show-a-invoice)
+   - [List invoices](https://commerce.coinbase.com/docs/api/#list-invoices)
+   - [Cancel an invoice](https://commerce.coinbase.com/docs/api/#cancel-an-invoice)

main.go

@@ -19,6 +19,8 @@ func NewClient(cfg api.Config) (*Client, error) {
 		chargesStub:   stub.NewCharges(),
 		checkouts:     api.NewCheckouts(cfg),
 		checkoutsStub: stub.NewCheckouts(),
+		invoices:      api.NewInvoices(cfg),
+		invoicesStub:  stub.NewInvoices(),
 	}, nil
 }
 
@@ -28,6 +30,8 @@ type Client struct {
 	chargesStub   api.ChargesItf
 	checkouts     api.CheckoutsItf
 	checkoutsStub api.CheckoutsItf
+	invoices      api.InvoicesItf
+	invoicesStub  api.InvoicesItf
 }
 
 // CreateCharge charge a customer with certain amount of currency.
@@ -36,7 +40,7 @@ type Client struct {
 // Once a charge is created a customer must broadcast a payment
 // to the blockchain before the charge expires.
 // Reference: https://commerce.coinbase.com/docs/api/#create-a-charge
-func (c Client) CreateCharge(ctx context.Context, req *entity.CreateChargeReq) (*entity.CreateChargeResp, error) {
+func (c *Client) CreateCharge(ctx context.Context, req *entity.CreateChargeReq) (*entity.CreateChargeResp, error) {
 	if stub.Ok(ctx) {
 		return c.chargesStub.Create(ctx, req)
 	}
@@ -47,7 +51,7 @@ func (c Client) CreateCharge(ctx context.Context, req *entity.CreateChargeReq) (
 // Supply the unique charge code or id that was returned when the charge was created.
 // This information is also returned when a charge is first created.
 // Reference: https://commerce.coinbase.com/docs/api/#show-a-charge
-func (c Client) ShowCharge(ctx context.Context, req *entity.ShowChargeReq) (*entity.ShowChargeResp, error) {
+func (c *Client) ShowCharge(ctx context.Context, req *entity.ShowChargeReq) (*entity.ShowChargeResp, error) {
 	if err := req.Validate(); err != nil {
 		return nil, err
 	}
@@ -59,7 +63,7 @@ func (c Client) ShowCharge(ctx context.Context, req *entity.ShowChargeReq) (*ent
 
 // ListCharges lists all the charges.
 // Reference: https://commerce.coinbase.com/docs/api/#list-charges
-func (c Client) ListCharges(ctx context.Context, req *entity.ListChargesReq) (*entity.ListChargesResp, error) {
+func (c *Client) ListCharges(ctx context.Context, req *entity.ListChargesReq) (*entity.ListChargesResp, error) {
 	if stub.Ok(ctx) {
 		return c.chargesStub.List(ctx, req)
 	}
@@ -75,7 +79,7 @@ func (c Client) ListCharges(ctx context.Context, req *entity.ListChargesReq) (*e
 // Once payment is detected, charge can no longer be canceled.
 //
 // Reference: https://commerce.coinbase.com/docs/api/#cancel-a-charge
-func (c Client) CancelCharge(ctx context.Context, req *entity.CancelChargeReq) (*entity.CancelChargeResp, error) {
+func (c *Client) CancelCharge(ctx context.Context, req *entity.CancelChargeReq) (*entity.CancelChargeResp, error) {
 	if err := req.Validate(); err != nil {
 		return nil, err
 	}
@@ -93,7 +97,7 @@ func (c Client) CancelCharge(ctx context.Context, req *entity.CancelChargeReq) (
 // Only unresolved charges can be successfully resolved
 //
 // Reference: https://commerce.coinbase.com/docs/api/#resolve-a-charge
-func (c Client) ResolveCharge(ctx context.Context, req *entity.ResolveChargeReq) (*entity.ResolveChargeResp, error) {
+func (c *Client) ResolveCharge(ctx context.Context, req *entity.ResolveChargeReq) (*entity.ResolveChargeResp, error) {
 	if err := req.Validate(); err != nil {
 		return nil, err
 	}
@@ -105,7 +109,7 @@ func (c Client) ResolveCharge(ctx context.Context, req *entity.ResolveChargeReq)
 
 // ListCheckouts lists all the checkouts.
 // Reference: https://commerce.coinbase.com/docs/api/#list-checkouts
-func (c Client) ListCheckouts(ctx context.Context, req *entity.ListCheckoutsReq) (*entity.ListCheckoutsResp, error) {
+func (c *Client) ListCheckouts(ctx context.Context, req *entity.ListCheckoutsReq) (*entity.ListCheckoutsResp, error) {
 	if stub.Ok(ctx) {
 		return c.checkoutsStub.List(ctx, req)
 	}
@@ -114,7 +118,7 @@ func (c Client) ListCheckouts(ctx context.Context, req *entity.ListCheckoutsReq)
 
 // ShowCheckout show a single checkout.
 // Reference: https://commerce.coinbase.com/docs/api/#show-a-checkout
-func (c Client) ShowCheckout(ctx context.Context, req *entity.ShowCheckoutReq) (*entity.ShowCheckoutResp, error) {
+func (c *Client) ShowCheckout(ctx context.Context, req *entity.ShowCheckoutReq) (*entity.ShowCheckoutResp, error) {
 	if err := req.Validate(); err != nil {
 		return nil, err
 	}
@@ -126,7 +130,7 @@ func (c Client) ShowCheckout(ctx context.Context, req *entity.ShowCheckoutReq) (
 
 // CreateCheckout create a new checkout.
 // Reference: https://commerce.coinbase.com/docs/api/#create-a-checkout
-func (c Client) CreateCheckout(ctx context.Context, req *entity.CreateCheckoutReq) (*entity.CreateCheckoutResp, error) {
+func (c *Client) CreateCheckout(ctx context.Context, req *entity.CreateCheckoutReq) (*entity.CreateCheckoutResp, error) {
 	if stub.Ok(ctx) {
 		return c.checkoutsStub.Create(ctx, req)
 	}
@@ -135,7 +139,7 @@ func (c Client) CreateCheckout(ctx context.Context, req *entity.CreateCheckoutRe
 
 // UpdateCheckout update a checkout.
 // Reference: https://commerce.coinbase.com/docs/api/#update-a-checkout
-func (c Client) UpdateCheckout(ctx context.Context, req *entity.UpdateCheckoutReq) (*entity.UpdateCheckoutResp, error) {
+func (c *Client) UpdateCheckout(ctx context.Context, req *entity.UpdateCheckoutReq) (*entity.UpdateCheckoutResp, error) {
 	if err := req.Validate(); err != nil {
 		return nil, err
 	}
@@ -147,7 +151,7 @@ func (c Client) UpdateCheckout(ctx context.Context, req *entity.UpdateCheckoutRe
 
 // DeleteCheckout delete a checkout.
 // Reference: https://commerce.coinbase.com/docs/api/#delete-a-checkout
-func (c Client) DeleteCheckout(ctx context.Context, req *entity.DeleteCheckoutReq) (*entity.DeleteCheckoutResp, error) {
+func (c *Client) DeleteCheckout(ctx context.Context, req *entity.DeleteCheckoutReq) (*entity.DeleteCheckoutResp, error) {
 	if err := req.Validate(); err != nil {
 		return nil, err
 	}
@@ -156,3 +160,74 @@ func (c Client) DeleteCheckout(ctx context.Context, req *entity.DeleteCheckoutRe
 	}
 	return c.checkouts.Delete(ctx, req)
 }
+
+// ListInvoices lists all the invoices.
+// Reference: https://commerce.coinbase.com/docs/api/#list-invoices
+func (c *Client) ListInvoices(ctx context.Context, req *entity.ListInvoicesReq) (*entity.ListInvoicesResp, error) {
+	if stub.Ok(ctx) {
+		return c.invoicesStub.List(ctx, req)
+	}
+	return c.invoices.List(ctx, req)
+}
+
+// ShowInvoice retrieves the details of an invoice that has been previously created.
+// Supply the unique invoice code or id that was returned when the charge was created.
+// This information is also returned when an invoice is first created.
+// Reference: https://commerce.coinbase.com/docs/api/#show-an-invoice
+func (c *Client) ShowInvoice(ctx context.Context, req *entity.ShowInvoiceReq) (*entity.ShowInvoiceResp, error) {
+	if err := req.Validate(); err != nil {
+		return nil, err
+	}
+	if stub.Ok(ctx) {
+		return c.invoicesStub.Show(ctx, req)
+	}
+	return c.invoices.Show(ctx, req)
+}
+
+// CreateInvoice to send an invoice in cryptocurrency,
+// you need to create an invoice object and provide the user
+// with the hosted url where they will be able to pay.
+// Once an invoice is viewed at the hosted url,
+// a charge will be generated on the invoice.
+// Reference: https://commerce.coinbase.com/docs/api/#create-an-invoice
+func (c *Client) CreateInvoice(ctx context.Context, req *entity.CreateInvoiceReq) (*entity.CreateInvoiceResp, error) {
+	if stub.Ok(ctx) {
+		return c.invoicesStub.Create(ctx, req)
+	}
+	return c.invoices.Create(ctx, req)
+}
+
+// VoidInvoice voids an invoice that has been previously created.
+// Supply the unique invoice code or id that was returned when the charge was created.
+//
+// Note:
+// Only invoices with OPEN or VIEWED status can be voided.
+// Once a payment is detected, the invoice can no longer be voided.
+//
+// Reference: https://commerce.coinbase.com/docs/api/#void-an-invoice
+func (c *Client) VoidInvoice(ctx context.Context, req *entity.VoidInvoiceReq) (*entity.VoidInvoiceResp, error) {
+	if err := req.Validate(); err != nil {
+		return nil, err
+	}
+	if stub.Ok(ctx) {
+		return c.invoicesStub.Void(ctx, req)
+	}
+	return c.invoices.Void(ctx, req)
+}
+
+// ResolveInvoice resolve an invoice that has been previously marked as unresolved.
+// Supply the unique invoice code or id that was returned when the charge was created.
+//
+// Note:
+// Only invoices with an unresolved charge can be successfully resolved.
+//
+// Reference: https://commerce.coinbase.com/docs/api/#resolve-an-invoice
+func (c *Client) ResolveInvoice(ctx context.Context, req *entity.ResolveInvoiceReq) (*entity.ResolveInvoiceResp, error) {
+	if err := req.Validate(); err != nil {
+		return nil, err
+	}
+	if stub.Ok(ctx) {
+		return c.invoicesStub.Resolve(ctx, req)
+	}
+	return c.invoices.Resolve(ctx, req)
+}