Feature/refund implementation

examples/apis/payment/cancel/main.go

@@ -20,11 +20,11 @@ func main() {
 	client := payment.NewClient(cfg)
 	var paymentID int64 = 123
 
-	result, err := client.Cancel(context.Background(), paymentID)
+	payment, err := client.Cancel(context.Background(), paymentID)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
-	fmt.Println(result)
+	fmt.Println(payment)
 }

examples/apis/payment/capture/main.go

@@ -30,18 +30,18 @@ func main() {
 	}
 
 	client := payment.NewClient(cfg)
-	pay, err := client.Create(context.Background(), paymentRequest)
+	payment, err := client.Create(context.Background(), paymentRequest)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
 	// Capture.
-	pay, err = client.Capture(context.Background(), pay.ID)
+	payment, err = client.Capture(context.Background(), payment.ID)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
-	fmt.Println(pay)
+	fmt.Println(payment)
 }

examples/apis/payment/capture_amount/main.go

@@ -30,18 +30,18 @@ func main() {
 	}
 
 	client := payment.NewClient(cfg)
-	pay, err := client.Create(context.Background(), paymentRequest)
+	payment, err := client.Create(context.Background(), paymentRequest)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
 	// Capture amount.
-	pay, err = client.CaptureAmount(context.Background(), pay.ID, 100.1)
+	payment, err = client.CaptureAmount(context.Background(), payment.ID, 100.1)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
-	fmt.Println(pay)
+	fmt.Println(payment)
 }

examples/apis/payment/create/main.go

@@ -28,11 +28,11 @@ func main() {
 	}
 
 	client := payment.NewClient(cfg)
-	pay, err := client.Create(context.Background(), paymentRequest)
+	payment, err := client.Create(context.Background(), paymentRequest)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
-	fmt.Println(pay)
+	fmt.Println(payment)
 }

examples/apis/payment/get/main.go

@@ -23,20 +23,19 @@ func main() {
 			Email: "{{EMAIL}}",
 		},
 	}
-
 	client := payment.NewClient(cfg)
 
-	pay, err := client.Create(context.Background(), paymentRequest)
+	payment, err := client.Create(context.Background(), paymentRequest)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
-	pay, err = client.Get(context.Background(), pay.ID)
+	payment, err = client.Get(context.Background(), payment.ID)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
-	fmt.Println(pay)
+	fmt.Println(payment)
 }

examples/apis/payment/search/main.go

@@ -24,11 +24,11 @@ func main() {
 	}
 
 	client := payment.NewClient(cfg)
-	pay, err := client.Search(context.Background(), paymentRequest)
+	payment, err := client.Search(context.Background(), paymentRequest)
 	if err != nil {
 		fmt.Println(err)
 		return
 	}
 
-	fmt.Println(pay)
+	fmt.Println(payment)
 }

examples/apis/paymentmethod/list/main.go

@@ -17,8 +17,8 @@ func main() {
 		return
 	}
 
-	client := paymentmethod.NewClient(cfg)
-	paymentMethods, err := client.List(context.Background())
+	paymentMethodClient := paymentmethod.NewClient(cfg)
+	paymentMethods, err := paymentMethodClient.List(context.Background())
 	if err != nil {
 		fmt.Println(err)
 		return

examples/apis/refund/get/main.go

@@ -0,0 +1,32 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/refund"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	refundClient := refund.NewClient(cfg)
+
+	var paymentID int64 = 12344555
+	var refundID int64 = 12344555
+
+	refund, err := refundClient.Get(context.Background(), paymentID, refundID)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(refund)
+}

examples/apis/refund/list/main.go

@@ -0,0 +1,32 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/refund"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	refundClient := refund.NewClient(cfg)
+
+	var paymentID int64 = 12233344
+
+	refunds, err := refundClient.List(context.Background(), paymentID)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+	for _, v := range refunds {
+		fmt.Println(v)
+	}
+}

examples/apis/refund/partial_refund/main.go

@@ -0,0 +1,50 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+	"github.com/mercadopago/sdk-go/pkg/refund"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	// Create payment.
+	paymentRequest := payment.Request{
+		TransactionAmount: 105.1,
+		PaymentMethodID:   "master",
+		Payer: &payment.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+		Token:        "{{TOKEN}}",
+		Installments: 1,
+		Capture:      false,
+	}
+
+	paymentClient := payment.NewClient(cfg)
+	payment, err := paymentClient.Create(context.Background(), paymentRequest)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	partialAmount := payment.TransactionAmount - 10.0
+
+	refundClient := refund.NewClient(cfg)
+	refund, err := refundClient.CreatePartialRefund(context.Background(), partialAmount, payment.ID)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(refund)
+}

examples/apis/refund/total_refund/main.go

@@ -0,0 +1,48 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+	"github.com/mercadopago/sdk-go/pkg/refund"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	// Create payment.
+	paymentRequest := payment.Request{
+		TransactionAmount: 105.1,
+		PaymentMethodID:   "master",
+		Payer: &payment.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+		Token:        "{{TOKEN}}",
+		Installments: 1,
+		Capture:      false,
+	}
+
+	paymentClient := payment.NewClient(cfg)
+	payment, err := paymentClient.Create(context.Background(), paymentRequest)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	refundClient := refund.NewClient(cfg)
+	refund, err := refundClient.Create(context.Background(), payment.ID)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(refund)
+}

examples/apis/user/get/main.go

@@ -17,8 +17,8 @@ func main() {
 		return
 	}
 
-	client := user.NewClient(cfg)
-	user, err := client.Get(context.Background())
+	userClient := user.NewClient(cfg)
+	user, err := userClient.Get(context.Background())
 	if err != nil {
 		fmt.Println(err)
 		return

pkg/payment/payment.go → pkg/payment/client.go

@@ -12,11 +12,9 @@ import (
 )
 
 const (
-	baseURL   = "https://api.mercadopago.com/v1/"
-	postURL   = baseURL + "payments"
-	searchURL = baseURL + "payments/search"
-	getURL    = baseURL + "payments/{id}"
-	putURL    = baseURL + "payments/{id}"
+	urlBase   = "https://api.mercadopago.com/v1/payments"
+	urlSearch = urlBase + "/search"
+	urlWithID = urlBase + "/{id}"
 )
 
 // Client contains the methods to interact with the Payments API.
@@ -62,7 +60,7 @@ func NewClient(c *config.Config) Client {
 }
 
 func (c *client) Create(ctx context.Context, request Request) (*Response, error) {
-	res, err := httpclient.Post[Response](ctx, c.cfg, postURL, request)
+	res, err := httpclient.Post[Response](ctx, c.cfg, urlBase, request)
 	if err != nil {
 		return nil, err
 	}
@@ -73,7 +71,7 @@ func (c *client) Create(ctx context.Context, request Request) (*Response, error)
 func (c *client) Search(ctx context.Context, dto SearchRequest) (*SearchResponse, error) {
 	params := dto.Parameters()
 
-	url, err := url.Parse(searchURL)
+	url, err := url.Parse(urlSearch)
 	if err != nil {
 		return nil, fmt.Errorf("error parsing url: %w", err)
 	}
@@ -90,7 +88,7 @@ func (c *client) Search(ctx context.Context, dto SearchRequest) (*SearchResponse
 func (c *client) Get(ctx context.Context, id int64) (*Response, error) {
 	conv := strconv.Itoa(int(id))
 
-	res, err := httpclient.Get[Response](ctx, c.cfg, strings.Replace(getURL, "{id}", conv, 1))
+	res, err := httpclient.Get[Response](ctx, c.cfg, strings.Replace(urlWithID, "{id}", conv, 1))
 	if err != nil {
 		return nil, err
 	}
@@ -102,7 +100,7 @@ func (c *client) Cancel(ctx context.Context, id int64) (*Response, error) {
 	dto := &CancelRequest{Status: "cancelled"}
 	conv := strconv.Itoa(int(id))
 
-	res, err := httpclient.Put[Response](ctx, c.cfg, strings.Replace(putURL, "{id}", conv, 1), dto)
+	res, err := httpclient.Put[Response](ctx, c.cfg, strings.Replace(urlWithID, "{id}", conv, 1), dto)
 	if err != nil {
 		return nil, err
 	}
@@ -114,7 +112,7 @@ func (c *client) Capture(ctx context.Context, id int64) (*Response, error) {
 	dto := &CaptureRequest{Capture: true}
 	conv := strconv.Itoa(int(id))
 
-	res, err := httpclient.Put[Response](ctx, c.cfg, strings.Replace(putURL, "{id}", conv, 1), dto)
+	res, err := httpclient.Put[Response](ctx, c.cfg, strings.Replace(urlWithID, "{id}", conv, 1), dto)
 	if err != nil {
 		return nil, err
 	}
@@ -126,7 +124,7 @@ func (c *client) CaptureAmount(ctx context.Context, id int64, amount float64) (*
 	dto := &CaptureRequest{TransactionAmount: amount, Capture: true}
 	conv := strconv.Itoa(int(id))
 
-	res, err := httpclient.Put[Response](ctx, c.cfg, strings.Replace(putURL, "{id}", conv, 1), dto)
+	res, err := httpclient.Put[Response](ctx, c.cfg, strings.Replace(urlWithID, "{id}", conv, 1), dto)
 	if err != nil {
 		return nil, err
 	}