Merge pull request #102 from anderson-rsantos/feature/orders_3ds

[Feature] Orders 3DS

Author: anderson-rsantos

.gitignore

@@ -19,4 +19,7 @@ go.work
 
 # IDE
 .idea
-.vscode
+.vscode
+ 
+# Local tooling/temp
+tmp-mcp-installer/

examples/apis/cardtoken/create/main.go

@@ -22,15 +22,15 @@ func main() {
 	request := cardtoken.Request{
 		SiteID:          "{{SITE_ID}}",
 		CardNumber:      "{{CARD_NUMBER}}",
-		ExpirationMonth: "11",
-		ExpirationYear:  "2025",
-		SecurityCode:    "123",
+		ExpirationMonth: "{{EXPIRATION_MONTH}}",
+		ExpirationYear:  "{{EXPIRATION_YEAR}}",
+		SecurityCode:    "{{SECURITY_CODE}}",
 		Cardholder: &cardtoken.CardholderRequest{
 			Identification: &cardtoken.IdentificationRequest{
 				Type:   "CPF",
-				Number: "{{CPF_NUMBER}}",
+				Number: "{{NUMBER_CPF}}",
 			},
-			Name: "{{PAYMENT_METHOD}}",
+			Name: "{{NAME}}",
 		},
 	}
 

examples/apis/order/create/main.go

@@ -18,25 +18,25 @@ func main() {
 
 	client := order.NewClient(c)
 	request := order.Request{
-		Type:              "online",
-		TotalAmount:       "1000.00",
-		ExternalReference: "ext_ref_1234",
-		Currency:          "BRL",
+		Type:              "{{TYPE}}",
+		TotalAmount:       "{{TOTAL_AMOUNT}}",
+		ExternalReference: "{{EXTERNAL_REFERENCE}}",
+    Currency:          "BRL",
 		Transactions: &order.TransactionRequest{
 			Payments: []order.PaymentRequest{
 				{
-					Amount: "1000.00",
+					Amount: "{{AMOUNT}}",
 					PaymentMethod: &order.PaymentMethodRequest{
-						ID:           "master",
+						ID:           "{{PAYMENT_METHOD_ID}}",
 						Token:        "{{CARD_TOKEN}}",
-						Type:         "credit_card",
+						Type:         "{{TYPE}}",
 						Installments: 1,
 					},
 				},
 			},
 		},
 		Payer: &order.PayerRequest{
-			Email: "{{PAYER_EMAIL}}",
+			Email: "{{EMAIL}}",
 		},
 	}
 
@@ -45,5 +45,6 @@ func main() {
 		fmt.Println(err)
 		return
 	}
+
 	fmt.Println(resource)
 }

examples/apis/order/create3ds/main.go

@@ -0,0 +1,59 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/order"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+	c, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	client := order.NewClient(c)
+	request := order.Request{
+		Type:              "{{TYPE}}",
+		TotalAmount:       "{{TOTAL_AMOUNT}}",
+		ExternalReference: "{{EXTERNAL_REFERENCE}}",
+		Transactions: &order.TransactionRequest{
+			Payments: []order.PaymentRequest{
+				{
+					Amount: "{{AMOUNT}}",
+					PaymentMethod: &order.PaymentMethodRequest{
+						ID:           "{{PAYMENT_METHOD_ID}}",
+						Token:        "{{CARD_TOKEN}}",
+						Type:         "{{TYPE}}",
+						Installments: 1,
+					},
+				},
+			},
+		},
+		Payer: &order.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+		Config: &order.ConfigRequest{
+			Online: &order.OnlineConfigRequest{
+				TransactionSecurity: &order.TransactionSecurityRequest{
+					Validation:     "always",
+					LiabilityShift: "preferred",
+				},
+			},
+		},
+	}
+
+	resource, err := client.Create(context.Background(), request)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(resource)
+}
+
+

pkg/order/client_test.go

@@ -2,6 +2,7 @@ package order
 
 import (
 	"context"
+	"encoding/json"
 	"fmt"
 	"io"
 	"net/http"
@@ -1160,3 +1161,43 @@ func TestNewClient(t *testing.T) {
 		})
 	}
 }
+
+func TestCreate_TransactionSecurity_Simple(t *testing.T) {
+	reqBody := Request{
+		Config: &ConfigRequest{
+			Online: &OnlineConfigRequest{
+				TransactionSecurity: &TransactionSecurityRequest{
+					Validation:     "always",
+					LiabilityShift: "preferred",
+				},
+			},
+		},
+	}
+
+	cfg := &config.Config{
+		Requester: &httpclient.Mock{
+			DoMock: func(req *http.Request) (*http.Response, error) {
+				var got struct {
+					Config *ConfigRequest `json:"config,omitempty"`
+				}
+				if err := json.NewDecoder(req.Body).Decode(&got); err != nil {
+					return nil, err
+				}
+				expected := struct {
+					Config *ConfigRequest `json:"config,omitempty"`
+				}{
+					Config: reqBody.Config,
+				}
+				if !reflect.DeepEqual(got, expected) {
+					return nil, fmt.Errorf("body mismatch: got=%+v want=%+v", got, expected)
+				}
+				return &http.Response{Body: io.NopCloser(strings.NewReader(`{"id":"ord","status":"processing"}`))}, nil
+			},
+		},
+	}
+
+	c := &client{cfg: cfg}
+	if _, err := c.Create(context.Background(), reqBody); err != nil {
+		t.Fatalf("Create() error: %v", err)
+	}
+}

pkg/order/request.go

@@ -228,8 +228,14 @@ type OnlineConfigRequest struct {
 	FailureURL          string                      `json:"failure_url,omitempty"`
 	AutoReturnURL       string                      `json:"auto_return_url,omitempty"`
 	DifferentialPricing *DifferentialPricingRequest `json:"differential_pricing,omitempty"`
+	TransactionSecurity *TransactionSecurityRequest `json:"transaction_security,omitempty"`
 }
 
 type DifferentialPricingRequest struct {
 	ID int `json:"id,omitempty"`
 }
+
+type TransactionSecurityRequest struct {
+	Validation     string `json:"validation,omitempty"`
+	LiabilityShift string `json:"liability_shift,omitempty"`
+}

pkg/order/response.go

@@ -53,21 +53,32 @@ type PaymentResponse struct {
 }
 
 type PaymentMethodResponse struct {
-	ID                   string `json:"id,omitempty"`
-	CardID               string `json:"card_id,omitempty"`
-	Type                 string `json:"type,omitempty"`
-	Token                string `json:"token,omitempty"`
-	StatementDescriptor  string `json:"statement_descriptor,omitempty"`
-	Installments         int    `json:"installments,omitempty"`
-	TicketURL            string `json:"ticket_url,omitempty"`
-	BarcodeContent       string `json:"barcode_content,omitempty"`
-	Reference            string `json:"reference,omitempty"`
-	ReferenceID          string `json:"reference_id,omitempty"`
-	VerificationCode     string `json:"verification_code,omitempty"`
-	FinancialInstitution string `json:"financial_institution,omitempty"`
-	QrCode               string `json:"qr_code,omitempty"`
-	QrCodeBase64         string `json:"qr_code_base64,omitempty"`
-	DigitableLine        string `json:"digitable_line,omitempty"`
+	ID                   string                       `json:"id,omitempty"`
+	CardID               string                       `json:"card_id,omitempty"`
+	Type                 string                       `json:"type,omitempty"`
+	Token                string                       `json:"token,omitempty"`
+	StatementDescriptor  string                       `json:"statement_descriptor,omitempty"`
+	Installments         int                          `json:"installments,omitempty"`
+	TicketURL            string                       `json:"ticket_url,omitempty"`
+	BarcodeContent       string                       `json:"barcode_content,omitempty"`
+	Reference            string                       `json:"reference,omitempty"`
+	ReferenceID          string                       `json:"reference_id,omitempty"`
+	VerificationCode     string                       `json:"verification_code,omitempty"`
+	FinancialInstitution string                       `json:"financial_institution,omitempty"`
+	QrCode               string                       `json:"qr_code,omitempty"`
+	QrCodeBase64         string                       `json:"qr_code_base64,omitempty"`
+	DigitableLine        string                       `json:"digitable_line,omitempty"`
+	TransactionSecurity  *TransactionSecurityResponse `json:"transaction_security,omitempty"`
+}
+
+// TransactionSecurityResponse represents 3DS-related information returned by the API
+// for a payment method when a challenge may be required.
+type TransactionSecurityResponse struct {
+	URL            string `json:"url,omitempty"`
+	Validation     string `json:"validation,omitempty"`
+	LiabilityShift string `json:"liability_shift,omitempty"`
+	Type           string `json:"type,omitempty"`
+	Status         string `json:"status,omitempty"`
 }
 
 type AutomaticPaymentResponse struct {

test/integration/order/order_test.go

@@ -486,3 +486,52 @@ func TestRefundOrder(t *testing.T) {
 		}
 	})
 }
+
+func TestOrderTransactionSecurity(t *testing.T) {
+	t.Run("should_create_order_with_transaction_security", func(t *testing.T) {
+		ctx := context.Background()
+		token, err := test.GenerateCardToken(ctx, cardTokenClient)
+		if err != nil {
+			t.Error("fail to generate card token", err)
+		}
+
+		request := order.Request{
+			Type:              "online",
+			ProcessingMode:    "automatic",
+			TotalAmount:       "100.00",
+			ExternalReference: fmt.Sprintf("ext_ref_ts_%s", uuid.New().String()[:7]),
+			Payer: &order.PayerRequest{
+				Email: fmt.Sprintf("test_user_%s@testuser.com", uuid.New().String()[:7]),
+			},
+			Config: &order.ConfigRequest{
+				Online: &order.OnlineConfigRequest{
+					TransactionSecurity: &order.TransactionSecurityRequest{
+						Validation:     "always",
+						LiabilityShift: "preferred",
+					},
+				},
+			},
+			Transactions: &order.TransactionRequest{
+				Payments: []order.PaymentRequest{
+					{
+						Amount: "100.00",
+						PaymentMethod: &order.PaymentMethodRequest{
+							ID:           "master",
+							Token:        token,
+							Type:         "credit_card",
+							Installments: 1,
+						},
+					},
+				},
+			},
+		}
+
+		resource, err := orderClient.Create(ctx, request)
+		if resource == nil || resource.ID == "" {
+			t.Error("order can't be nil")
+		}
+		if err != nil {
+			t.Errorf(err.Error())
+		}
+	})
+}