Merge pull request #967 from stripe/richardm-orderreturn-get

Add orderreturn.Get method

order.go

@@ -91,12 +91,6 @@ type OrderUpdateShippingParams struct {
 	TrackingNumber *string `form:"tracking_number"`
 }
 
-// OrderReturnParams is the set of parameters that can be used when returning orders.
-type OrderReturnParams struct {
-	Params `form:"*"`
-	Items  []*OrderItemParams `form:"items"`
-}
-
 // Shipping describes the shipping hash on an order.
 type Shipping struct {
 	Address        *Address `json:"address"`

orderreturn.go

@@ -2,6 +2,13 @@ package stripe
 
 import "encoding/json"
 
+// OrderReturnParams is the set of parameters that can be used when returning orders.
+type OrderReturnParams struct {
+	Params `form:"*"`
+	Items  []*OrderItemParams `form:"items"`
+	Order  *string            `form:"-"` // Included in the URL
+}
+
 // OrderReturn is the resource representing an order return.
 // For more details see https://stripe.com/docs/api#order_returns.
 type OrderReturn struct {

orderreturn/client.go

@@ -13,6 +13,19 @@ type Client struct {
 	Key string
 }
 
+// Get returns the details of an order return
+func Get(id string, params *stripe.OrderReturnParams) (*stripe.OrderReturn, error) {
+	return getC().Get(id, params)
+}
+
+// Get returns the details of an order return
+func (c Client) Get(id string, params *stripe.OrderReturnParams) (*stripe.OrderReturn, error) {
+	path := stripe.FormatURLPath("/v1/order_returns/%s", id)
+	orderReturn := &stripe.OrderReturn{}
+	err := c.B.Call(http.MethodGet, path, c.Key, params, orderReturn)
+	return orderReturn, err
+}
+
 // List returns a list of order returns.
 func List(params *stripe.OrderReturnListParams) *Iter {
 	return getC().List(params)

orderreturn/client_test.go

@@ -8,6 +8,14 @@ import (
 	_ "github.com/stripe/stripe-go/testing"
 )
 
+func TestOrderReturnGet(t *testing.T) {
+	orret, err := Get("orret_123", &stripe.OrderReturnParams{})
+
+	// Verify that we can get an order return
+	assert.Nil(t, err)
+	assert.NotNil(t, orret)
+}
+
 func TestOrderReturnList(t *testing.T) {
 	i := List(&stripe.OrderReturnListParams{})