Feature/payments implementation

examples/apis/payment/cancel/main.go

@@ -0,0 +1,30 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	client := payment.NewClient(cfg)
+	var paymentID int64 = 123
+
+	result, err := client.Cancel(context.Background(), paymentID)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(result)
+}

examples/apis/payment/capture/main.go

@@ -0,0 +1,47 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+)
+
+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:   "visa",
+		Payer: &payment.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+		Token:        "{{CARD_TOKEN}}",
+		Installments: 1,
+		Capture:      false,
+	}
+
+	client := payment.NewClient(cfg)
+	pay, err := client.Create(context.Background(), paymentRequest)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	// Capture.
+	pay, err = client.Capture(context.Background(), pay.ID)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(pay)
+}

examples/apis/payment/capture_amount/main.go

@@ -0,0 +1,47 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+)
+
+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:   "visa",
+		Payer: &payment.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+		Token:        "{{CARD_TOKEN}}",
+		Installments: 1,
+		Capture:      false,
+	}
+
+	client := payment.NewClient(cfg)
+	pay, 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)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(pay)
+}

examples/apis/payment/create/main.go

@@ -0,0 +1,38 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	paymentRequest := payment.Request{
+		TransactionAmount: 105.1,
+		PaymentMethodID:   "visa",
+		Payer: &payment.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+		Token:        "{{CARD_TOKEN}}",
+		Installments: 1,
+	}
+
+	client := payment.NewClient(cfg)
+	pay, err := client.Create(context.Background(), paymentRequest)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(pay)
+}

examples/apis/payment/get/main.go

@@ -0,0 +1,42 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+	paymentRequest := payment.Request{
+		TransactionAmount: 105.1,
+		PaymentMethodID:   "pix",
+		Payer: &payment.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+	}
+
+	client := payment.NewClient(cfg)
+
+	pay, err := client.Create(context.Background(), paymentRequest)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	pay, err = client.Get(context.Background(), pay.ID)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(pay)
+}

examples/apis/payment/search/main.go

@@ -0,0 +1,34 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	paymentRequest := payment.SearchRequest{
+		Filters: map[string]string{
+			"external_reference": "abc_def_ghi_123_456123",
+		},
+	}
+
+	client := payment.NewClient(cfg)
+	pay, err := client.Search(context.Background(), paymentRequest)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(pay)
+}

pkg/payment/payment.go

@@ -0,0 +1,135 @@
+package payment
+
+import (
+	"context"
+	"fmt"
+	"net/url"
+	"strconv"
+	"strings"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/internal/httpclient"
+)
+
+const (
+	baseURL   = "https://api.mercadopago.com/v1/"
+	postURL   = baseURL + "payments"
+	searchURL = baseURL + "payments/search"
+	getURL    = baseURL + "payments/{id}"
+	putURL    = baseURL + "payments/{id}"
+)
+
+// Client contains the methods to interact with the Payments API.
+type Client interface {
+	// Create creates a new payment.
+	// It is a post request to the endpoint: https://api.mercadopago.com/v1/payments
+	// Reference: https://www.mercadopago.com/developers/en/reference/payments/_payments/post/
+	Create(ctx context.Context, request Request) (*Response, error)
+
+	// Search searches for payments.
+	// It is a get request to the endpoint: https://api.mercadopago.com/v1/payments/search
+	// Reference: https://www.mercadopago.com/developers/en/reference/payments/_payments_search/get/
+	Search(ctx context.Context, request SearchRequest) (*SearchResponse, error)
+
+	// Get gets a payment by its ID.
+	// It is a get request to the endpoint: https://api.mercadopago.com/v1/payments/{id}
+	// Reference: https://www.mercadopago.com/developers/en/reference/payments/_payments_id/get/
+	Get(ctx context.Context, id int64) (*Response, error)
+
+	// Cancel cancels a payment by its ID.
+	// It is a put request to the endpoint: https://api.mercadopago.com/v1/payments/{id}
+	Cancel(ctx context.Context, id int64) (*Response, error)
+
+	// Capture captures a payment by its ID.
+	// It is a put request to the endpoint: https://api.mercadopago.com/v1/payments/{id}
+	Capture(ctx context.Context, id int64) (*Response, error)
+
+	// CaptureAmount captures amount of a payment by its ID.
+	// It is a put request to the endpoint: https://api.mercadopago.com/v1/payments/{id}
+	CaptureAmount(ctx context.Context, id int64, amount float64) (*Response, error)
+}
+
+// client is the implementation of Client.
+type client struct {
+	cfg *config.Config
+}
+
+// NewClient returns a new Payments API Client.
+func NewClient(c *config.Config) Client {
+	return &client{
+		cfg: c,
+	}
+}
+
+func (c *client) Create(ctx context.Context, request Request) (*Response, error) {
+	res, err := httpclient.Post[Response](ctx, c.cfg, postURL, request)
+	if err != nil {
+		return nil, err
+	}
+
+	return res, nil
+}
+
+func (c *client) Search(ctx context.Context, dto SearchRequest) (*SearchResponse, error) {
+	params := dto.Parameters()
+
+	url, err := url.Parse(searchURL)
+	if err != nil {
+		return nil, fmt.Errorf("error parsing url: %w", err)
+	}
+	url.RawQuery = params
+
+	res, err := httpclient.Get[SearchResponse](ctx, c.cfg, url.String())
+	if err != nil {
+		return nil, err
+	}
+
+	return res, nil
+}
+
+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))
+	if err != nil {
+		return nil, err
+	}
+
+	return res, nil
+}
+
+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)
+	if err != nil {
+		return nil, err
+	}
+
+	return res, nil
+}
+
+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)
+	if err != nil {
+		return nil, err
+	}
+
+	return res, nil
+}
+
+func (c *client) CaptureAmount(ctx context.Context, id int64, amount float64) (*Response, error) {
+	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)
+	if err != nil {
+		return nil, err
+	}
+
+	return res, nil
+}