feat(transaction): add productDetails and customerDetail to MintRequest

Add support for new optional API fields:
- productDetails: override default payment page note (max 255 chars)
- customerDetail: override customer info with firstName, lastName, email (max 50 chars each)

Includes validation and test coverage.

Author: widnyana

examples/mint-redemption/main.go

@@ -53,6 +53,13 @@ func main() {
 		DestinationWalletAddress: "0x61Ba72c10983Def54AA7F93a334837BAA5d93396", // change this to your destination wallet address
 		NetworkChainID:           string(models.ChainPolygon),                  // Polygon
 		ExpiryPeriod:             3600,                                         // 1 hour
+		// Optional fields for customizing payment page
+		ProductDetails: "Custom IDRX Purchase", // Override default "Minting IDRX" note
+		CustomerDetail: &models.CustomerDetail{
+			FirstName: "John",
+			LastName:  "Doe",
+			Email:     "john.doe@example.com",
+		},
 	}
 
 	mintResp, err := client.Transaction.MintRequest(ctx, mintReq)

models/transaction.go

@@ -4,13 +4,22 @@ import (
 	"time"
 )
 
+// CustomerDetail represents optional customer information for mint requests.
+type CustomerDetail struct {
+	FirstName string `json:"firstName,omitempty"`
+	LastName  string `json:"lastName,omitempty"`
+	Email     string `json:"email,omitempty"`
+}
+
 // MintRequest represents the request to mint IDRX or other stablecoins.
 type MintRequest struct {
-	ToBeMinted               string      `json:"toBeMinted" validate:"required"`
-	DestinationWalletAddress string      `json:"destinationWalletAddress" validate:"required"`
-	NetworkChainID           string      `json:"networkChainId" validate:"required"`
-	ExpiryPeriod             int         `json:"expiryPeriod" validate:"required"`
-	RequestType              RequestType `json:"requestType,omitempty"`
+	ToBeMinted               string          `json:"toBeMinted" validate:"required"`
+	DestinationWalletAddress string          `json:"destinationWalletAddress" validate:"required"`
+	NetworkChainID           string          `json:"networkChainId" validate:"required"`
+	ExpiryPeriod             int             `json:"expiryPeriod" validate:"required"`
+	RequestType              RequestType     `json:"requestType,omitempty"`
+	ProductDetails           string          `json:"productDetails,omitempty"`
+	CustomerDetail           *CustomerDetail `json:"customerDetail,omitempty"`
 }
 
 // MintResponse represents the response from a mint request.

transaction_service.go

@@ -198,6 +198,25 @@ func (s *TransactionService) validateMintRequest(req *models.MintRequest) error
 	if req.ExpiryPeriod <= 0 {
 		return fmt.Errorf("expiryPeriod must be greater than 0")
 	}
+
+	// Validate optional productDetails length
+	if len(req.ProductDetails) > 255 {
+		return fmt.Errorf("productDetails must not exceed 255 characters")
+	}
+
+	// Validate optional customerDetail fields
+	if req.CustomerDetail != nil {
+		if len(req.CustomerDetail.FirstName) > 50 {
+			return fmt.Errorf("customerDetail.firstName must not exceed 50 characters")
+		}
+		if len(req.CustomerDetail.LastName) > 50 {
+			return fmt.Errorf("customerDetail.lastName must not exceed 50 characters")
+		}
+		if len(req.CustomerDetail.Email) > 50 {
+			return fmt.Errorf("customerDetail.email must not exceed 50 characters")
+		}
+	}
+
 	return nil
 }
 

transaction_service_test.go

@@ -359,6 +359,56 @@ func TestTransactionService_MintRequestValidation(t *testing.T) {
 			},
 			wantErr: "expiryPeriod must be greater than 0",
 		},
+		{
+			name: "productDetails exceeds 255 characters",
+			request: &models.MintRequest{
+				ToBeMinted:               "1000",
+				DestinationWalletAddress: "0x123",
+				NetworkChainID:           "137",
+				ExpiryPeriod:             3600,
+				ProductDetails:           strings.Repeat("a", 256),
+			},
+			wantErr: "productDetails must not exceed 255 characters",
+		},
+		{
+			name: "customerDetail firstName exceeds 50 characters",
+			request: &models.MintRequest{
+				ToBeMinted:               "1000",
+				DestinationWalletAddress: "0x123",
+				NetworkChainID:           "137",
+				ExpiryPeriod:             3600,
+				CustomerDetail: &models.CustomerDetail{
+					FirstName: strings.Repeat("a", 51),
+				},
+			},
+			wantErr: "customerDetail.firstName must not exceed 50 characters",
+		},
+		{
+			name: "customerDetail lastName exceeds 50 characters",
+			request: &models.MintRequest{
+				ToBeMinted:               "1000",
+				DestinationWalletAddress: "0x123",
+				NetworkChainID:           "137",
+				ExpiryPeriod:             3600,
+				CustomerDetail: &models.CustomerDetail{
+					LastName: strings.Repeat("b", 51),
+				},
+			},
+			wantErr: "customerDetail.lastName must not exceed 50 characters",
+		},
+		{
+			name: "customerDetail email exceeds 50 characters",
+			request: &models.MintRequest{
+				ToBeMinted:               "1000",
+				DestinationWalletAddress: "0x123",
+				NetworkChainID:           "137",
+				ExpiryPeriod:             3600,
+				CustomerDetail: &models.CustomerDetail{
+					Email: strings.Repeat("c", 51) + "@example.com",
+				},
+			},
+			wantErr: "customerDetail.email must not exceed 50 characters",
+		},
 	}
 
 	for _, tt := range tests {