extended aurora scenarios + payment operation amounts

2026-03-11 01:09:11 +01:00
parent e446486b77
commit 9ad2104d7d
46 changed files with 1057 additions and 193 deletions
--- a/.woodpecker/frontend.yml
+++ b/.woodpecker/frontend.yml
@@ -53,9 +53,18 @@ steps:
      - ./ci/vlt kv_get kv registry user > secrets/REGISTRY_USER
      - ./ci/vlt kv_get kv registry password > secrets/REGISTRY_PASSWORD

+  - name: frontend-tests
+    image: ghcr.io/cirruslabs/flutter:stable
+    depends_on: [ version ]
+    commands:
+      - set -euo pipefail 2>/dev/null || set -eu
+      - flutter --version
+      - (cd frontend/pshared && flutter pub get && flutter test)
+      - (cd frontend/pweb && flutter pub get && flutter test)
+
  - name: build-image
    image: gcr.io/kaniko-project/executor:debug
-    depends_on: [ version, secrets ]
+    depends_on: [ frontend-tests, secrets ]
    commands:
      - '[ "$(uname -m)" = "x86_64" ] || { echo "image build requires an amd64 runner"; exit 1; }'
      - sh ci/scripts/frontend/build-image.sh
--- a/104
+++ b/104
@@ -1,12 +1,48 @@
 # Sendico Development Environment - Makefile
 # Docker Compose + Makefile build system

-.PHONY: help init build up down restart logs rebuild clean vault-init proto generate generate-api generate-frontend update update-api update-frontend test test-api test-frontend lint-api backend-up backend-down backend-rebuild
+.PHONY: \
+	help \
+	init \
+	build \
+	build-infra \
+	build-core \
+	build-fx \
+	build-payments \
+	build-gateways \
+	build-backend \
+	build-frontend \
+	up \
+	down \
+	restart \
+	infra-up \
+	services-up \
+	backend-up \
+	backend-down \
+	backend-rebuild \
+	status \
+	list-services \
+	logs \
+	rebuild \
+	clean \
+	health \
+	vault-init \
+	proto \
+	generate \
+	generate-backend \
+	generate-frontend \
+	update \
+	update-backend \
+	update-frontend \
+	test \
+	test-backend \
+	test-frontend \
+	lint-backend

 COMPOSE := docker compose -f docker-compose.dev.yml --env-file .env.dev
 SERVICE ?=
-API_GOCACHE ?= $(CURDIR)/.gocache
-API_GOLANGCI_LINT_CACHE ?= $(CURDIR)/.golangci-cache
+BACKEND_GOCACHE ?= $(CURDIR)/.gocache
+BACKEND_GOLANGCI_LINT_CACHE ?= $(CURDIR)/.golangci-cache
 BACKEND_SERVICES := \
 	dev-discovery \
 	dev-fx-oracle \
@@ -47,8 +83,8 @@ help:
 	@echo "  make down               Stop all services"
 	@echo "  make restart            Restart all services"
 	@echo "  make status             Show service status"
-	@echo "  make logs [SERVICE=x]   View logs (all or specific service)"
-	@echo "  make rebuild SERVICE=x  Rebuild specific service"
+	@echo "  make logs [SERVICE=dev-ledger]    View logs (all or specific service)"
+	@echo "  make rebuild SERVICE=dev-ledger   Rebuild specific service"
 	@echo "  make clean              Remove all containers and volumes"
 	@echo ""
 	@echo "$(YELLOW)Selective Operations:$(NC)"
@@ -62,23 +98,23 @@ help:
 	@echo "$(YELLOW)Build Groups:$(NC)"
 	@echo "  make build-core         Build core services (discovery, ledger, fees, documents)"
 	@echo "  make build-fx           Build FX services (oracle, ingestor)"
-	@echo "  make build-payments     Build payment orchestrator"
+	@echo "  make build-payments     Build payment services (orchestrator, quotation, methods)"
 	@echo "  make build-gateways     Build gateway services (chain, tron, aurora, chsettle)"
-	@echo "  make build-api          Build API services (notification, callbacks, bff)"
+	@echo "  make build-backend      Build backend edge services (notification, callbacks, bff)"
 	@echo "  make build-frontend     Build Flutter web frontend"
 	@echo ""
 	@echo "$(YELLOW)Development:$(NC)"
 	@echo "  make proto              Generate protobuf code"
 	@echo "  make generate           Generate all code (protobuf + Flutter)"
-	@echo "  make generate-api       Generate protobuf code only"
+	@echo "  make generate-backend   Generate protobuf code only"
 	@echo "  make generate-frontend  Generate Flutter code only"
 	@echo "  make update             Update all dependencies (Go + Flutter)"
-	@echo "  make update-api         Update Go dependencies only"
+	@echo "  make update-backend     Update Go dependencies only"
 	@echo "  make update-frontend    Update Flutter dependencies only"
-	@echo "  make test               Run all tests (API + frontend)"
-	@echo "  make test-api           Run Go API tests only"
+	@echo "  make test               Run all tests (backend + frontend)"
+	@echo "  make test-backend       Run Go backend tests only"
 	@echo "  make test-frontend      Run Flutter tests only"
-	@echo "  make lint-api           Run golangci-lint across all API Go modules"
+	@echo "  make lint-backend       Run golangci-lint across all backend Go modules"
 	@echo "  make health             Check service health"
 	@echo ""
 	@echo "Examples:"
@@ -140,7 +176,7 @@ up:
 	@echo "  NATS UI:    http://localhost:8222"
 	@echo "  Vault:      http://localhost:8200 (run 'make vault-init' first)"
 	@echo ""
-	@echo "View logs:    make logs [SERVICE=name]"
+	@echo "View logs:    make logs [SERVICE=dev-ledger]"
 	@echo "Stop:         make down"

 # Stop all services
@@ -164,7 +200,7 @@ endif
 # Rebuild specific service
 rebuild:
 ifndef SERVICE
-	$(error SERVICE is required: make rebuild SERVICE=ledger)
+	$(error SERVICE is required: make rebuild SERVICE=dev-ledger)
 endif
 	@echo "$(GREEN)Rebuilding $(SERVICE)...$(NC)"
 	@$(COMPOSE) build $(SERVICE)
@@ -173,13 +209,13 @@ endif
 	@echo "View logs: make logs SERVICE=$(SERVICE)"

 # Generate protobuf code (alias)
-proto: generate-api
+proto: generate-backend

 # Generate all code
-generate: generate-api generate-frontend
+generate: generate-backend generate-frontend

-# Generate protobuf code
-generate-api:
+# Generate backend protobuf code
+generate-backend:
 	@echo "$(GREEN)Generating protobuf code...$(NC)"
 	@./ci/scripts/proto/generate.sh
 	@echo "$(GREEN)✅ Protobuf generation complete$(NC)"
@@ -327,8 +363,8 @@ build-gateways:
 	@echo "$(GREEN)Building gateway services...$(NC)"
 	@$(COMPOSE) build dev-chain-gateway dev-tron-gateway dev-aurora-gateway dev-chsettle-gateway

-build-api:
-	@echo "$(GREEN)Building API services...$(NC)"
+build-backend:
+	@echo "$(GREEN)Building backend edge services...$(NC)"
 	@$(COMPOSE) build dev-notification dev-callbacks dev-bff

 build-frontend:
@@ -336,10 +372,10 @@ build-frontend:
 	@$(COMPOSE) build dev-frontend

 # Update all dependencies
-update: update-api update-frontend
+update: update-backend update-frontend

-# Update Go API dependencies
-update-api:
+# Update Go backend dependencies
+update-backend:
 	@echo "$(GREEN)Updating Go dependencies...$(NC)"
 	@for dir in $$(find api -name go.mod -exec dirname {} \;); do \
 		echo "Updating $$dir..."; \
@@ -355,11 +391,11 @@ update-frontend:
 	@echo "$(GREEN)✅ Flutter dependencies updated$(NC)"

 # Run all tests
-test: test-api test-frontend
+test: test-backend test-frontend

-# Run Go API tests
-test-api:
-	@echo "$(GREEN)Running API tests...$(NC)"
+# Run Go backend tests
+test-backend:
+	@echo "$(GREEN)Running backend tests...$(NC)"
 	@failed=""; \
 	for dir in $$(find api -name go.mod -exec dirname {} \;); do \
 		echo "Testing $$dir..."; \
@@ -369,7 +405,7 @@ test-api:
 		echo "$(YELLOW)Failed:$$failed$(NC)"; \
 		exit 1; \
 	fi
-	@echo "$(GREEN)✅ All API tests passed$(NC)"
+	@echo "$(GREEN)✅ All backend tests passed$(NC)"

 # Run Flutter tests
 test-frontend:
@@ -378,17 +414,17 @@ test-frontend:
 	@cd frontend/pweb && flutter test
 	@echo "$(GREEN)✅ All frontend tests passed$(NC)"

-# Run Go API linting
-lint-api:
-	@echo "$(GREEN)Running API linting...$(NC)"
-	@mkdir -p "$(API_GOCACHE)" "$(API_GOLANGCI_LINT_CACHE)"
+# Run Go backend linting
+lint-backend:
+	@echo "$(GREEN)Running backend linting...$(NC)"
+	@mkdir -p "$(BACKEND_GOCACHE)" "$(BACKEND_GOLANGCI_LINT_CACHE)"
 	@failed=""; \
 	for dir in $$(find api -name go.mod -exec dirname {} \;); do \
 		echo "Linting $$dir..."; \
-		(cd "$$dir" && GOCACHE="$(API_GOCACHE)" GOLANGCI_LINT_CACHE="$(API_GOLANGCI_LINT_CACHE)" golangci-lint run --allow-serial-runners --allow-parallel-runners ./...) || failed="$$failed $$dir"; \
+		(cd "$$dir" && GOCACHE="$(BACKEND_GOCACHE)" GOLANGCI_LINT_CACHE="$(BACKEND_GOLANGCI_LINT_CACHE)" golangci-lint run --allow-serial-runners --allow-parallel-runners ./...) || failed="$$failed $$dir"; \
 	done; \
 	if [ -n "$$failed" ]; then \
 		echo "$(YELLOW)Lint failed:$$failed$(NC)"; \
 		exit 1; \
 	fi
-	@echo "$(GREEN)✅ All API lint checks passed$(NC)"
+	@echo "$(GREEN)✅ All backend lint checks passed$(NC)"
--- a/README.md
+++ b/README.md
@@ -89,7 +89,7 @@ make build-core       # discovery, ledger, fees, documents
 make build-fx         # oracle, ingestor
 make build-payments   # orchestrator, quotation, methods
 make build-gateways   # chain, tron, aurora, chsettle
-make build-api        # notification, callbacks, bff
+make build-backend    # notification, callbacks, bff
 make build-frontend   # Flutter web UI
 ```

@@ -97,16 +97,16 @@ make build-frontend   # Flutter web UI

 ```bash
 make generate            # Generate all code (protobuf + Flutter)
-make generate-api        # Generate protobuf code only
+make generate-backend    # Generate protobuf code only
 make generate-frontend   # Generate Flutter code only (build_runner)
-make proto               # Alias for generate-api
+make proto               # Alias for generate-backend
 ```

 ### Testing

 ```bash
-make test           # Run all tests (API + frontend)
-make test-api       # Run Go API tests only
+make test           # Run all tests (backend + frontend)
+make test-backend   # Run Go backend tests only
 make test-frontend  # Run Flutter tests only
 ```

@@ -133,7 +133,7 @@ If you intentionally need to bypass checks for a specific commit, include one of

 ```bash
 make update            # Update all Go and Flutter dependencies
-make update-api        # Update Go dependencies only
+make update-backend    # Update Go dependencies only
 make update-frontend   # Update Flutter dependencies only
 ```

--- a/SETUP.md
+++ b/SETUP.md
@@ -137,10 +137,11 @@ make infra-up
 make services-up

 # Or start specific service groups
-make build-core      # discovery, ledger, billing-fees
+make build-core      # discovery, ledger, billing-fees, billing-documents
 make build-fx        # fx-oracle, fx-ingestor
-make build-payments  # payments-orchestrator
-make build-gateways  # chain, mntx, tgsettle
+make build-payments  # payments-orchestrator, payments-quotation, payments-methods
+make build-gateways  # chain, tron, aurora, chsettle
+make build-backend   # notification, callbacks, bff
 ```

 ---
--- a/api/edge/bff/interface/api/sresponse/payment.go
+++ b/api/edge/bff/interface/api/sresponse/payment.go
@@ -302,7 +302,7 @@ func toPayment(p *orchestrationv2.Payment) *Payment {
 		return nil
 	}
 	intent := p.GetIntentSnapshot()
-	operations := toUserVisibleOperations(p.GetStepExecutions(), p.GetQuoteSnapshot())
+	operations := toUserVisibleOperations(p.GetStepExecutions())
 	failureCode, failureReason := firstFailure(operations)
 	return &Payment{
 		PaymentRef:    p.GetPaymentRef(),
@@ -562,7 +562,7 @@ func firstFailure(operations []PaymentOperation) (string, string) {
 	return "", ""
 }

-func toUserVisibleOperations(steps []*orchestrationv2.StepExecution, quote *quotationv2.PaymentQuote) []PaymentOperation {
+func toUserVisibleOperations(steps []*orchestrationv2.StepExecution) []PaymentOperation {
 	if len(steps) == 0 {
 		return nil
 	}
@@ -571,7 +571,7 @@ func toUserVisibleOperations(steps []*orchestrationv2.StepExecution, quote *quot
 		if step == nil || !isUserVisibleStep(step.GetReportVisibility()) {
 			continue
 		}
-		ops = append(ops, toPaymentOperation(step, quote))
+		ops = append(ops, toPaymentOperation(step))
 	}
 	if len(ops) == 0 {
 		return nil
@@ -579,9 +579,10 @@ func toUserVisibleOperations(steps []*orchestrationv2.StepExecution, quote *quot
 	return ops
 }

-func toPaymentOperation(step *orchestrationv2.StepExecution, quote *quotationv2.PaymentQuote) PaymentOperation {
+func toPaymentOperation(step *orchestrationv2.StepExecution) PaymentOperation {
 	operationRef, gateway := operationRefAndGateway(step.GetStepCode(), step.GetRefs())
-	amount, convertedAmount := operationAmounts(step.GetStepCode(), quote)
+	amount := normalizeOperationMoney(toMoney(step.GetExecutedMoney()))
+	convertedAmount := normalizeOperationMoney(toMoney(step.GetConvertedMoney()))
 	op := PaymentOperation{
 		StepRef:         step.GetStepRef(),
 		Code:            step.GetStepCode(),
@@ -606,52 +607,19 @@ func toPaymentOperation(step *orchestrationv2.StepExecution, quote *quotationv2.
 	return op
 }

-func operationAmounts(stepCode string, quote *quotationv2.PaymentQuote) (*paymenttypes.Money, *paymenttypes.Money) {
-	if quote == nil {
-		return nil, nil
+func normalizeOperationMoney(value *paymenttypes.Money) *paymenttypes.Money {
+	if value == nil {
+		return nil
 	}
-	operation := stepOperationToken(stepCode)
-
-	primary := firstValidMoney(
-		toMoney(quote.GetDestinationAmount()),
-		toMoney(quote.GetTransferPrincipalAmount()),
-		toMoney(quote.GetPayerTotalDebitAmount()),
-	)
-	if operation != "fx_convert" {
-		return primary, nil
+	amount := strings.TrimSpace(value.GetAmount())
+	currency := strings.TrimSpace(value.GetCurrency())
+	if amount == "" || currency == "" {
+		return nil
 	}
-
-	base := firstValidMoney(
-		toMoney(quote.GetTransferPrincipalAmount()),
-		toMoney(quote.GetPayerTotalDebitAmount()),
-		toMoney(quote.GetFxQuote().GetBaseAmount()),
-	)
-	quoteAmount := firstValidMoney(
-		toMoney(quote.GetDestinationAmount()),
-		toMoney(quote.GetFxQuote().GetQuoteAmount()),
-	)
-	return base, quoteAmount
-}
-
-func stepOperationToken(stepCode string) string {
-	parts := strings.Split(strings.ToLower(strings.TrimSpace(stepCode)), ".")
-	if len(parts) == 0 {
-		return ""
+	return &paymenttypes.Money{
+		Amount:   amount,
+		Currency: currency,
 	}
-	return strings.TrimSpace(parts[len(parts)-1])
-}
-
-func firstValidMoney(values ...*paymenttypes.Money) *paymenttypes.Money {
-	for _, value := range values {
-		if value == nil {
-			continue
-		}
-		if strings.TrimSpace(value.GetAmount()) == "" || strings.TrimSpace(value.GetCurrency()) == "" {
-			continue
-		}
-		return value
-	}
-	return nil
 }

 const (
--- a/api/edge/bff/interface/api/sresponse/payment_test.go
+++ b/api/edge/bff/interface/api/sresponse/payment_test.go
@@ -37,7 +37,7 @@ func TestToUserVisibleOperationsFiltersByVisibility(t *testing.T) {
 		},
 	}

-	ops := toUserVisibleOperations(steps, nil)
+	ops := toUserVisibleOperations(steps)
 	if len(ops) != 2 {
 		t.Fatalf("operations count mismatch: got=%d want=2", len(ops))
 	}
@@ -288,7 +288,7 @@ func TestToPaymentOperation_MapsOperationRefAndGateway(t *testing.T) {
 				Ref:               "op-123",
 			},
 		},
-	}, nil)
+	})

 	if got, want := op.OperationRef, "op-123"; got != want {
 		t.Fatalf("operation_ref mismatch: got=%q want=%q", got, want)
@@ -303,7 +303,7 @@ func TestToPaymentOperation_InfersGatewayFromStepCode(t *testing.T) {
 		StepRef:  "step-2",
 		StepCode: "edge.1_2.ledger.debit",
 		State:    orchestrationv2.StepExecutionState_STEP_EXECUTION_STATE_COMPLETED,
-	}, nil)
+	})

 	if got := op.OperationRef; got != "" {
 		t.Fatalf("expected empty operation_ref, got=%q", got)
@@ -326,7 +326,7 @@ func TestToPaymentOperation_DoesNotFallbackToCardPayoutRef(t *testing.T) {
 				Ref:               "payout-123",
 			},
 		},
-	}, nil)
+	})

 	if got := op.OperationRef; got != "" {
 		t.Fatalf("expected empty operation_ref, got=%q", got)
@@ -341,15 +341,28 @@ func TestToPaymentOperation_MapsAmount(t *testing.T) {
 		StepRef:  "step-4",
 		StepCode: "hop.4.card_payout.send",
 		State:    orchestrationv2.StepExecutionState_STEP_EXECUTION_STATE_COMPLETED,
-	}, &quotationv2.PaymentQuote{
-		TransferPrincipalAmount: &moneyv1.Money{Amount: "110.00", Currency: "USDT"},
-		DestinationAmount:       &moneyv1.Money{Amount: "100.00", Currency: "EUR"},
+	})
+
+	if got := op.Amount; got != nil {
+		t.Fatalf("expected nil amount without executed_money, got=%+v", got)
+	}
+	if got := op.ConvertedAmount; got != nil {
+		t.Fatalf("expected no converted_amount for non-fx operation, got=%+v", got)
+	}
+}
+
+func TestToPaymentOperation_PrefersExecutedMoney(t *testing.T) {
+	op := toPaymentOperation(&orchestrationv2.StepExecution{
+		StepRef:       "step-4b",
+		StepCode:      "hop.4.card_payout.send",
+		State:         orchestrationv2.StepExecutionState_STEP_EXECUTION_STATE_COMPLETED,
+		ExecutedMoney: &moneyv1.Money{Amount: "99.95", Currency: "EUR"},
 	})

 	if op.Amount == nil {
 		t.Fatal("expected amount to be mapped")
 	}
-	if got, want := op.Amount.Amount, "100.00"; got != want {
+	if got, want := op.Amount.Amount, "99.95"; got != want {
 		t.Fatalf("amount.value mismatch: got=%q want=%q", got, want)
 	}
 	if got, want := op.Amount.Currency, "EUR"; got != want {
@@ -362,22 +375,14 @@ func TestToPaymentOperation_MapsAmount(t *testing.T) {

 func TestToPaymentOperation_MapsFxTwoAmounts(t *testing.T) {
 	op := toPaymentOperation(&orchestrationv2.StepExecution{
-		StepRef:  "step-5",
-		StepCode: "hop.2.settlement.fx_convert",
-		State:    orchestrationv2.StepExecutionState_STEP_EXECUTION_STATE_COMPLETED,
-	}, &quotationv2.PaymentQuote{
-		TransferPrincipalAmount: &moneyv1.Money{Amount: "110.00", Currency: "USDT"},
-		DestinationAmount:       &moneyv1.Money{Amount: "100.00", Currency: "EUR"},
+		StepRef:        "step-5",
+		StepCode:       "hop.2.settlement.fx_convert",
+		State:          orchestrationv2.StepExecutionState_STEP_EXECUTION_STATE_COMPLETED,
+		ConvertedMoney: &moneyv1.Money{Amount: "100.00", Currency: "EUR"},
 	})

-	if op.Amount == nil {
-		t.Fatal("expected fx base amount to be mapped")
-	}
-	if got, want := op.Amount.Amount, "110.00"; got != want {
-		t.Fatalf("base amount.value mismatch: got=%q want=%q", got, want)
-	}
-	if got, want := op.Amount.Currency, "USDT"; got != want {
-		t.Fatalf("base amount.currency mismatch: got=%q want=%q", got, want)
+	if got := op.Amount; got != nil {
+		t.Fatalf("expected nil base amount without executed_money, got=%+v", got)
 	}
 	if op.ConvertedAmount == nil {
 		t.Fatal("expected fx converted amount to be mapped")
@@ -389,3 +394,32 @@ func TestToPaymentOperation_MapsFxTwoAmounts(t *testing.T) {
 		t.Fatalf("converted amount.currency mismatch: got=%q want=%q", got, want)
 	}
 }
+
+func TestToPaymentOperation_FxWithExecutedMoney_StillProvidesTwoAmounts(t *testing.T) {
+	op := toPaymentOperation(&orchestrationv2.StepExecution{
+		StepRef:        "step-6",
+		StepCode:       "hop.2.settlement.fx_convert",
+		State:          orchestrationv2.StepExecutionState_STEP_EXECUTION_STATE_COMPLETED,
+		ExecutedMoney:  &moneyv1.Money{Amount: "109.50", Currency: "USDT"},
+		ConvertedMoney: &moneyv1.Money{Amount: "100.00", Currency: "EUR"},
+	})
+
+	if op.Amount == nil {
+		t.Fatal("expected fx base amount to be mapped")
+	}
+	if got, want := op.Amount.Amount, "109.50"; got != want {
+		t.Fatalf("base amount.value mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := op.Amount.Currency, "USDT"; got != want {
+		t.Fatalf("base amount.currency mismatch: got=%q want=%q", got, want)
+	}
+	if op.ConvertedAmount == nil {
+		t.Fatal("expected fx quote amount to be mapped")
+	}
+	if got, want := op.ConvertedAmount.Amount, "100.00"; got != want {
+		t.Fatalf("converted amount.value mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := op.ConvertedAmount.Currency, "EUR"; got != want {
+		t.Fatalf("converted amount.currency mismatch: got=%q want=%q", got, want)
+	}
+}
--- a/api/fx/storage/go.sum
+++ b/api/fx/storage/go.sum
@@ -152,8 +152,8 @@ golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7w
 golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.41.0 h1:Ivj+2Cp/ylzLiEU89QhWblYnOE9zerudt9Ftecq2C6k=
-golang.org/x/sys v0.41.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/sys v0.42.0 h1:omrd2nAlyT5ESRdCLYdm3+fMfNFE/+Rf4bDIQImRJeo=
+golang.org/x/sys v0.42.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
--- a/api/gateway/aurora/README.md
+++ b/api/gateway/aurora/README.md
@@ -13,14 +13,38 @@ Aurora is a dev/test-only card payout gateway with the same gRPC contract as `mn
 - No outbound payout/tokenization HTTP calls are made.

 ## Built-in test cards
- `2200001111111111`: approved instantly (`success`, code `00`)
- `2200002222222222`: pending issuer review (`waiting`, code `P01`)
- `2200003333333333`: insufficient funds (`failed`, code `51`)
- `2200004444444444`: issuer unavailable retryable (`failed`, code `10101`)
- `2200005555555555`: stolen card (`failed`, code `43`)
- `2200006666666666`: do not honor (`failed`, code `05`)
- `2200007777777777`: expired card (`failed`, code `54`)
- any other PAN: default queued processing (`waiting`, code `P00`)
+- Every scenario has multiple generated PANs (8 per case), all Luhn-valid.
+- PANs are generated from scenario prefixes in [`scenario_simulator.go`](./internal/service/gateway/scenario_simulator.go) via `generatePANSeriesWithLuhn`.
+- Scenario prefixes:
+  - `22000011`: approved instantly (`success`, code `00`)
+  - `22000022`: pending issuer review (`waiting`, code `P01`)
+  - `22000033`: insufficient funds (`failed`, code `51`)
+  - `22000044`: issuer unavailable retryable (`failed`, code `10101`)
+  - `22000055`: stolen card (`failed`, code `43`)
+  - `22000066`: do not honor (`failed`, code `05`)
+  - `22000077`: expired card (`failed`, code `54`)
+  - `22000088`: provider timeout transport error
+  - `22000098`: provider unreachable transport error
+  - `22000097`: provider maintenance (`failed`, code `91`)
+  - `22000096`: provider system malfunction (`failed`, code `96`)
+- Any other valid PAN defaults to queued processing (`waiting`, code `P00`).
+
+### Auxiliary PAN Table (Generated, Luhn-valid)
+
+| Scenario | Prefix | PANs |
+|---|---|---|
+| approved_instant | `22000011` | `2200001100000001`<br>`2200001100000019`<br>`2200001100000027`<br>`2200001100000035`<br>`2200001100000043`<br>`2200001100000050`<br>`2200001100000068`<br>`2200001100000076` |
+| pending_issuer_review | `22000022` | `2200002200000008`<br>`2200002200000016`<br>`2200002200000024`<br>`2200002200000032`<br>`2200002200000040`<br>`2200002200000057`<br>`2200002200000065`<br>`2200002200000073` |
+| insufficient_funds | `22000033` | `2200003300000005`<br>`2200003300000013`<br>`2200003300000021`<br>`2200003300000039`<br>`2200003300000047`<br>`2200003300000054`<br>`2200003300000062`<br>`2200003300000070` |
+| issuer_unavailable_retryable | `22000044` | `2200004400000002`<br>`2200004400000010`<br>`2200004400000028`<br>`2200004400000036`<br>`2200004400000044`<br>`2200004400000051`<br>`2200004400000069`<br>`2200004400000077` |
+| stolen_card | `22000055` | `2200005500000008`<br>`2200005500000016`<br>`2200005500000024`<br>`2200005500000032`<br>`2200005500000040`<br>`2200005500000057`<br>`2200005500000065`<br>`2200005500000073` |
+| do_not_honor | `22000066` | `2200006600000005`<br>`2200006600000013`<br>`2200006600000021`<br>`2200006600000039`<br>`2200006600000047`<br>`2200006600000054`<br>`2200006600000062`<br>`2200006600000070` |
+| expired_card | `22000077` | `2200007700000002`<br>`2200007700000010`<br>`2200007700000028`<br>`2200007700000036`<br>`2200007700000044`<br>`2200007700000051`<br>`2200007700000069`<br>`2200007700000077` |
+| provider_timeout_transport | `22000088` | `2200008800000009`<br>`2200008800000017`<br>`2200008800000025`<br>`2200008800000033`<br>`2200008800000041`<br>`2200008800000058`<br>`2200008800000066`<br>`2200008800000074` |
+| provider_unreachable_transport | `22000098` | `2200009800000007`<br>`2200009800000015`<br>`2200009800000023`<br>`2200009800000031`<br>`2200009800000049`<br>`2200009800000056`<br>`2200009800000064`<br>`2200009800000072` |
+| provider_maintenance | `22000097` | `2200009700000008`<br>`2200009700000016`<br>`2200009700000024`<br>`2200009700000032`<br>`2200009700000040`<br>`2200009700000057`<br>`2200009700000065`<br>`2200009700000073` |
+| provider_system_malfunction | `22000096` | `2200009600000009`<br>`2200009600000017`<br>`2200009600000025`<br>`2200009600000033`<br>`2200009600000041`<br>`2200009600000058`<br>`2200009600000066`<br>`2200009600000074` |
+| default_processing (example) | `22000999` | `2200099900000007` |

 ## Notes
 - PAN is masked in logs.
--- a/api/gateway/aurora/internal/service/gateway/aurora_scenarios_test.go
+++ b/api/gateway/aurora/internal/service/gateway/aurora_scenarios_test.go
@@ -33,7 +33,7 @@ func TestAuroraCardPayoutScenarios(t *testing.T) {
 	}{
 		{
 			name:              "approved_instant",
-			pan:               "2200001111111111",
+			pan:               scenarioPAN("approved_instant", 0),
 			wantAccepted:      true,
 			wantStatus:        mntxv1.PayoutStatus_PAYOUT_STATUS_SUCCESS,
 			wantErrorCode:     "00",
@@ -42,7 +42,7 @@ func TestAuroraCardPayoutScenarios(t *testing.T) {
 		},
 		{
 			name:              "pending_issuer_review",
-			pan:               "2200002222222222",
+			pan:               scenarioPAN("pending_issuer_review", 0),
 			wantAccepted:      true,
 			wantStatus:        mntxv1.PayoutStatus_PAYOUT_STATUS_WAITING,
 			wantErrorCode:     "P01",
@@ -51,7 +51,7 @@ func TestAuroraCardPayoutScenarios(t *testing.T) {
 		},
 		{
 			name:              "insufficient_funds",
-			pan:               "2200003333333333",
+			pan:               scenarioPAN("insufficient_funds", 0),
 			wantAccepted:      false,
 			wantStatus:        mntxv1.PayoutStatus_PAYOUT_STATUS_FAILED,
 			wantErrorCode:     "51",
@@ -60,7 +60,7 @@ func TestAuroraCardPayoutScenarios(t *testing.T) {
 		},
 		{
 			name:              "unknown_card_default_queue",
-			pan:               "2200009999999999",
+			pan:               defaultScenarioPAN(),
 			wantAccepted:      true,
 			wantStatus:        mntxv1.PayoutStatus_PAYOUT_STATUS_WAITING,
 			wantErrorCode:     "P00",
@@ -69,7 +69,7 @@ func TestAuroraCardPayoutScenarios(t *testing.T) {
 		},
 		{
 			name:              "provider_maintenance",
-			pan:               "2200009999999997",
+			pan:               scenarioPAN("provider_maintenance", 0),
 			wantAccepted:      false,
 			wantStatus:        mntxv1.PayoutStatus_PAYOUT_STATUS_FAILED,
 			wantErrorCode:     "91",
@@ -78,7 +78,7 @@ func TestAuroraCardPayoutScenarios(t *testing.T) {
 		},
 		{
 			name:              "provider_system_malfunction",
-			pan:               "2200009999999996",
+			pan:               scenarioPAN("provider_system_malfunction", 0),
 			wantAccepted:      false,
 			wantStatus:        mntxv1.PayoutStatus_PAYOUT_STATUS_FAILED,
 			wantErrorCode:     "96",
@@ -148,7 +148,7 @@ func TestAuroraTransportFailureScenarioEventuallyFails(t *testing.T) {
 	req.OperationRef = "op-transport-timeout"
 	req.ParentPaymentRef = "parent-transport-timeout"
 	req.IdempotencyKey = "idem-transport-timeout"
-	req.CardPan = "2200008888888888"
+	req.CardPan = scenarioPAN("provider_timeout_transport", 0)

 	resp, err := processor.Submit(context.Background(), req)
 	if err != nil {
@@ -201,7 +201,7 @@ func TestAuroraRetryableScenarioEventuallyFails(t *testing.T) {
 	req.OperationRef = "op-retryable-issuer-unavailable"
 	req.ParentPaymentRef = "parent-retryable-issuer-unavailable"
 	req.IdempotencyKey = "idem-retryable-issuer-unavailable"
-	req.CardPan = "2200004444444444"
+	req.CardPan = scenarioPAN("issuer_unavailable_retryable", 0)

 	resp, err := processor.Submit(context.Background(), req)
 	if err != nil {
@@ -248,7 +248,7 @@ func TestAuroraTokenPayoutUsesTokenizedPANScenario(t *testing.T) {

 	tokenizeReq := validCardTokenizeRequest()
 	tokenizeReq.RequestId = "tok-req-insufficient"
-	tokenizeReq.CardPan = "2200003333333333"
+	tokenizeReq.CardPan = scenarioPAN("insufficient_funds", 0)

 	tokenizeResp, err := processor.Tokenize(context.Background(), tokenizeReq)
 	if err != nil {
--- a/api/gateway/aurora/internal/service/gateway/card_pan.go
+++ b/api/gateway/aurora/internal/service/gateway/card_pan.go
@@ -0,0 +1,149 @@
+package gateway
+
+import (
+	"fmt"
+	"strconv"
+	"strings"
+
+	"github.com/tech/sendico/pkg/merrors"
+)
+
+const (
+	minCardPANLength = 12
+	maxCardPANLength = 19
+)
+
+func normalizeCardNumber(value string) string {
+	value = strings.TrimSpace(value)
+	if value == "" {
+		return ""
+	}
+	var b strings.Builder
+	b.Grow(len(value))
+	for _, r := range value {
+		if r >= '0' && r <= '9' {
+			b.WriteRune(r)
+		}
+	}
+	return b.String()
+}
+
+func validateCardPAN(pan string, field string) error {
+	normalized, err := normalizedPANForValidation(pan, field)
+	if err != nil {
+		return err
+	}
+	if !isValidPANLuhn(normalized) {
+		return merrors.InvalidArgument("card_pan checksum is invalid", field)
+	}
+	return nil
+}
+
+func normalizedPANForValidation(pan string, field string) (string, error) {
+	field = strings.TrimSpace(field)
+	if field == "" {
+		field = "card_pan"
+	}
+
+	clean := strings.TrimSpace(pan)
+	if clean == "" {
+		return "", merrors.InvalidArgument("card_pan is required", field)
+	}
+
+	compact := strings.NewReplacer(" ", "", "-", "").Replace(clean)
+	if compact == "" {
+		return "", merrors.InvalidArgument("card_pan must contain only digits (spaces/hyphens allowed)", field)
+	}
+
+	normalized := normalizeCardNumber(compact)
+	if normalized != compact {
+		return "", merrors.InvalidArgument("card_pan must contain only digits (spaces/hyphens allowed)", field)
+	}
+	if len(normalized) < minCardPANLength || len(normalized) > maxCardPANLength {
+		return "", merrors.InvalidArgument(
+			fmt.Sprintf("card_pan length must be between %d and %d", minCardPANLength, maxCardPANLength),
+			field,
+		)
+	}
+	return normalized, nil
+}
+
+func isValidPANLuhn(number string) bool {
+	if len(number) < minCardPANLength || len(number) > maxCardPANLength {
+		return false
+	}
+
+	sum := 0
+	double := false
+	for i := len(number) - 1; i >= 0; i-- {
+		d := int(number[i] - '0')
+		if d < 0 || d > 9 {
+			return false
+		}
+		if double {
+			d *= 2
+			if d > 9 {
+				d -= 9
+			}
+		}
+		sum += d
+		double = !double
+	}
+	return sum%10 == 0
+}
+
+func generatePANWithLuhn(prefix string, sequence uint64, panLength int) (string, error) {
+	prefix = normalizeCardNumber(prefix)
+	if prefix == "" {
+		return "", merrors.InvalidArgument("prefix is required", "prefix")
+	}
+	if panLength < minCardPANLength || panLength > maxCardPANLength {
+		return "", merrors.InvalidArgument(
+			fmt.Sprintf("pan_length must be between %d and %d", minCardPANLength, maxCardPANLength),
+			"pan_length",
+		)
+	}
+
+	bodyLen := panLength - 1
+	if len(prefix) > bodyLen {
+		return "", merrors.InvalidArgument("prefix is too long for selected pan_length", "prefix")
+	}
+
+	seqWidth := bodyLen - len(prefix)
+	seqMod := pow10(seqWidth)
+	body := prefix + fmt.Sprintf("%0*d", seqWidth, sequence%seqMod)
+
+	for checksum := 0; checksum <= 9; checksum++ {
+		candidate := body + strconv.Itoa(checksum)
+		if isValidPANLuhn(candidate) {
+			return candidate, nil
+		}
+	}
+	return "", merrors.Internal("failed to generate PAN checksum digit")
+}
+
+func generatePANSeriesWithLuhn(prefix string, count int, panLength int) ([]string, error) {
+	if count <= 0 {
+		return nil, nil
+	}
+	out := make([]string, 0, count)
+	for i := 0; i < count; i++ {
+		pan, err := generatePANWithLuhn(prefix, uint64(i), panLength)
+		if err != nil {
+			return nil, err
+		}
+		out = append(out, pan)
+	}
+	return out, nil
+}
+
+func pow10(n int) uint64 {
+	if n <= 0 {
+		return 1
+	}
+	p := uint64(1)
+	for i := 0; i < n; i++ {
+		p *= 10
+	}
+	return p
+}
--- a/api/gateway/aurora/internal/service/gateway/card_pan_test.go
+++ b/api/gateway/aurora/internal/service/gateway/card_pan_test.go
@@ -0,0 +1,36 @@
+package gateway
+
+import "testing"
+
+func TestValidateCardPAN_AllowsFormattedInput(t *testing.T) {
+	if err := validateCardPAN("4111 1111-1111 1111", "card_pan"); err != nil {
+		t.Fatalf("expected formatted PAN to pass validation, got %v", err)
+	}
+}
+
+func TestValidateCardPAN_RejectsInvalidChecksum(t *testing.T) {
+	if err := validateCardPAN("4111111111111112", "card_pan"); err == nil {
+		t.Fatal("expected invalid checksum to fail validation")
+	}
+}
+
+func TestGeneratePANSeriesWithLuhn_ProducesValidUniquePANs(t *testing.T) {
+	pans, err := generatePANSeriesWithLuhn("22000033", 6, 16)
+	if err != nil {
+		t.Fatalf("generatePANSeriesWithLuhn returned error: %v", err)
+	}
+	if len(pans) != 6 {
+		t.Fatalf("unexpected PAN count: got=%d want=6", len(pans))
+	}
+
+	seen := map[string]struct{}{}
+	for _, pan := range pans {
+		if !isValidPANLuhn(pan) {
+			t.Fatalf("generated PAN is not Luhn-valid: %q", pan)
+		}
+		if _, ok := seen[pan]; ok {
+			t.Fatalf("duplicate PAN generated: %q", pan)
+		}
+		seen[pan] = struct{}{}
+	}
+}
--- a/api/gateway/aurora/internal/service/gateway/card_payout_validation.go
+++ b/api/gateway/aurora/internal/service/gateway/card_payout_validation.go
@@ -49,6 +49,9 @@ func validateCardPayoutRequest(req *mntxv1.CardPayoutRequest, cfg provider.Confi
 	if pan == "" {
 		return newPayoutError("missing_card_pan", merrors.InvalidArgument("card_pan is required", "card_pan"))
 	}
+	if err := validateCardPAN(pan, "card_pan"); err != nil {
+		return newPayoutError("invalid_card_pan_crc", err)
+	}
 	if strings.TrimSpace(req.GetCardHolder()) == "" {
 		return newPayoutError("missing_card_holder", merrors.InvalidArgument("card_holder is required", "card_holder"))
 	}
--- a/api/gateway/aurora/internal/service/gateway/card_payout_validation_test.go
+++ b/api/gateway/aurora/internal/service/gateway/card_payout_validation_test.go
@@ -75,6 +75,11 @@ func TestValidateCardPayoutRequest_Errors(t *testing.T) {
 			mutate:   func(r *mntxv1.CardPayoutRequest) { r.CardPan = "" },
 			expected: "missing_card_pan",
 		},
+		{
+			name:     "invalid_card_pan_crc",
+			mutate:   func(r *mntxv1.CardPayoutRequest) { r.CardPan = "4111111111111112" },
+			expected: "invalid_card_pan_crc",
+		},
 		{
 			name:     "missing_card_holder",
 			mutate:   func(r *mntxv1.CardPayoutRequest) { r.CardHolder = "" },
--- a/api/gateway/aurora/internal/service/gateway/card_processor_test.go
+++ b/api/gateway/aurora/internal/service/gateway/card_processor_test.go
@@ -295,14 +295,14 @@ func TestCardPayoutProcessor_Submit_SameParentDifferentOperationsStoredSeparatel
 	req1.OperationRef = op1
 	req1.IdempotencyKey = "idem-1"
 	req1.ParentPaymentRef = parentPaymentRef
-	req1.CardPan = "2204310000002456"
+	req1.CardPan = scenarioPAN("approved_instant", 1)

 	req2 := validCardPayoutRequest()
 	req2.PayoutId = ""
 	req2.OperationRef = op2
 	req2.IdempotencyKey = "idem-2"
 	req2.ParentPaymentRef = parentPaymentRef
-	req2.CardPan = "2204320000009754"
+	req2.CardPan = scenarioPAN("pending_issuer_review", 1)

 	if _, err := processor.Submit(context.Background(), req1); err != nil {
 		t.Fatalf("first submit failed: %v", err)
@@ -385,14 +385,14 @@ func TestCardPayoutProcessor_StrictMode_BlocksSecondOperationUntilFirstFinalCall
 	req1.OperationRef = "op-strict-1"
 	req1.ParentPaymentRef = "payment-strict-1"
 	req1.IdempotencyKey = "idem-strict-1"
-	req1.CardPan = "2204310000002456"
+	req1.CardPan = scenarioPAN("approved_instant", 2)

 	req2 := validCardPayoutRequest()
 	req2.PayoutId = ""
 	req2.OperationRef = "op-strict-2"
 	req2.ParentPaymentRef = "payment-strict-2"
 	req2.IdempotencyKey = "idem-strict-2"
-	req2.CardPan = "2204320000009754"
+	req2.CardPan = scenarioPAN("pending_issuer_review", 2)

 	if _, err := processor.Submit(context.Background(), req1); err != nil {
 		t.Fatalf("first submit failed: %v", err)
--- a/api/gateway/aurora/internal/service/gateway/card_tokenize_validation.go
+++ b/api/gateway/aurora/internal/service/gateway/card_tokenize_validation.go
@@ -41,6 +41,9 @@ func validateCardTokenizeRequest(req *mntxv1.CardTokenizeRequest, cfg provider.C
 	if card.pan == "" {
 		return nil, newPayoutError("missing_card_pan", merrors.InvalidArgument("card_pan is required", "card.pan"))
 	}
+	if err := validateCardPAN(card.pan, "card.pan"); err != nil {
+		return nil, newPayoutError("invalid_card_pan_crc", err)
+	}
 	if card.holder == "" {
 		return nil, newPayoutError("missing_card_holder", merrors.InvalidArgument("card_holder is required", "card.holder"))
 	}
--- a/api/gateway/aurora/internal/service/gateway/card_tokenize_validation_test.go
+++ b/api/gateway/aurora/internal/service/gateway/card_tokenize_validation_test.go
@@ -65,6 +65,15 @@ func TestValidateCardTokenizeRequest_MissingCardPan(t *testing.T) {
 	requireReason(t, err, "missing_card_pan")
 }

+func TestValidateCardTokenizeRequest_InvalidCardPanCRC(t *testing.T) {
+	cfg := testProviderConfig()
+	req := validCardTokenizeRequest()
+	req.CardPan = "4111111111111112"
+
+	_, err := validateCardTokenizeRequest(req, cfg)
+	requireReason(t, err, "invalid_card_pan_crc")
+}
+
 func TestValidateCardTokenizeRequest_AddressRequired(t *testing.T) {
 	cfg := testProviderConfig()
 	cfg.RequireCustomerAddress = true
--- a/api/gateway/aurora/internal/service/gateway/scenario_simulator.go
+++ b/api/gateway/aurora/internal/service/gateway/scenario_simulator.go
@@ -28,12 +28,31 @@ type payoutSimulator struct {
 	seq             atomic.Uint64
 }

+const (
+	scenarioPANLength   = 16
+	scenarioPANVariants = 8
+)
+
+var scenarioPANPrefixes = map[string]string{
+	"approved_instant":               "22000011",
+	"pending_issuer_review":          "22000022",
+	"insufficient_funds":             "22000033",
+	"issuer_unavailable_retryable":   "22000044",
+	"stolen_card":                    "22000055",
+	"do_not_honor":                   "22000066",
+	"expired_card":                   "22000077",
+	"provider_timeout_transport":     "22000088",
+	"provider_unreachable_transport": "22000098",
+	"provider_maintenance":           "22000097",
+	"provider_system_malfunction":    "22000096",
+}
+
 func newPayoutSimulator() *payoutSimulator {
 	return &payoutSimulator{
 		scenarios: []simulatedCardScenario{
 			{
 				Name:           "approved_instant",
-				CardNumbers:    []string{"2200001111111111"},
+				CardNumbers:    mustScenarioPANs("approved_instant"),
 				Accepted:       true,
 				ProviderStatus: "success",
 				ErrorCode:      "00",
@@ -41,7 +60,7 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:           "pending_issuer_review",
-				CardNumbers:    []string{"2200002222222222"},
+				CardNumbers:    mustScenarioPANs("pending_issuer_review"),
 				Accepted:       true,
 				ProviderStatus: "processing",
 				ErrorCode:      "P01",
@@ -49,7 +68,7 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:         "insufficient_funds",
-				CardNumbers:  []string{"2200003333333333"},
+				CardNumbers:  mustScenarioPANs("insufficient_funds"),
 				CardLast4:    []string{"3333"},
 				Accepted:     false,
 				ErrorCode:    "51",
@@ -57,7 +76,7 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:         "issuer_unavailable_retryable",
-				CardNumbers:  []string{"2200004444444444"},
+				CardNumbers:  mustScenarioPANs("issuer_unavailable_retryable"),
 				CardLast4:    []string{"4444"},
 				Accepted:     false,
 				ErrorCode:    "10101",
@@ -65,7 +84,7 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:         "stolen_card",
-				CardNumbers:  []string{"2200005555555555"},
+				CardNumbers:  mustScenarioPANs("stolen_card"),
 				CardLast4:    []string{"5555"},
 				Accepted:     false,
 				ErrorCode:    "43",
@@ -73,7 +92,7 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:         "do_not_honor",
-				CardNumbers:  []string{"2200006666666666"},
+				CardNumbers:  mustScenarioPANs("do_not_honor"),
 				CardLast4:    []string{"6666"},
 				Accepted:     false,
 				ErrorCode:    "05",
@@ -81,7 +100,7 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:         "expired_card",
-				CardNumbers:  []string{"2200007777777777"},
+				CardNumbers:  mustScenarioPANs("expired_card"),
 				CardLast4:    []string{"7777"},
 				Accepted:     false,
 				ErrorCode:    "54",
@@ -89,19 +108,19 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:          "provider_timeout_transport",
-				CardNumbers:   []string{"2200008888888888"},
+				CardNumbers:   mustScenarioPANs("provider_timeout_transport"),
 				CardLast4:     []string{"8888"},
 				DispatchError: "provider timeout while calling payout endpoint",
 			},
 			{
 				Name:          "provider_unreachable_transport",
-				CardNumbers:   []string{"2200009999999998"},
+				CardNumbers:   mustScenarioPANs("provider_unreachable_transport"),
 				CardLast4:     []string{"9998"},
 				DispatchError: "provider host unreachable",
 			},
 			{
 				Name:         "provider_maintenance",
-				CardNumbers:  []string{"2200009999999997"},
+				CardNumbers:  mustScenarioPANs("provider_maintenance"),
 				CardLast4:    []string{"9997"},
 				Accepted:     false,
 				ErrorCode:    "91",
@@ -109,7 +128,7 @@ func newPayoutSimulator() *payoutSimulator {
 			},
 			{
 				Name:         "provider_system_malfunction",
-				CardNumbers:  []string{"2200009999999996"},
+				CardNumbers:  mustScenarioPANs("provider_system_malfunction"),
 				CardLast4:    []string{"9996"},
 				Accepted:     false,
 				ErrorCode:    "96",
@@ -126,6 +145,45 @@ func newPayoutSimulator() *payoutSimulator {
 	}
 }

+func mustScenarioPANs(name string) []string {
+	pans := scenarioPANs(name)
+	if len(pans) == 0 {
+		panic("aurora simulator scenario pan generation failed for " + name)
+	}
+	return pans
+}
+
+func scenarioPANs(name string) []string {
+	prefix := strings.TrimSpace(scenarioPANPrefixes[name])
+	if prefix == "" {
+		return nil
+	}
+	pans, err := generatePANSeriesWithLuhn(prefix, scenarioPANVariants, scenarioPANLength)
+	if err != nil {
+		return nil
+	}
+	return pans
+}
+
+func scenarioPAN(name string, index int) string {
+	pans := scenarioPANs(name)
+	if len(pans) == 0 {
+		return ""
+	}
+	if index < 0 {
+		index = 0
+	}
+	return pans[index%len(pans)]
+}
+
+func defaultScenarioPAN() string {
+	pan, err := generatePANWithLuhn("22000999", 0, scenarioPANLength)
+	if err != nil {
+		return ""
+	}
+	return pan
+}
+
 func (s *payoutSimulator) resolveByPAN(pan string) simulatedCardScenario {
 	return s.resolve(normalizeCardNumber(pan), "")
 }
@@ -210,21 +268,6 @@ func scenarioMatchesLast4(scenario simulatedCardScenario, last4 string) bool {
 	return false
 }

-func normalizeCardNumber(value string) string {
-	value = strings.TrimSpace(value)
-	if value == "" {
-		return ""
-	}
-	var b strings.Builder
-	b.Grow(len(value))
-	for _, r := range value {
-		if r >= '0' && r <= '9' {
-			b.WriteRune(r)
-		}
-	}
-	return b.String()
-}
-
 func normalizeExpiryYear(year uint32) string {
 	if year == 0 {
 		return ""
--- a/api/gateway/aurora/internal/service/gateway/scenario_simulator_test.go
+++ b/api/gateway/aurora/internal/service/gateway/scenario_simulator_test.go
@@ -10,7 +10,7 @@ import (
 func TestPayoutSimulatorResolveByPAN_KnownCard(t *testing.T) {
 	sim := newPayoutSimulator()

-	scenario := sim.resolveByPAN("2200003333333333")
+	scenario := sim.resolveByPAN(scenarioPAN("insufficient_funds", 0))
 	if scenario.Name != "insufficient_funds" {
 		t.Fatalf("unexpected scenario: got=%q", scenario.Name)
 	}
@@ -22,7 +22,7 @@ func TestPayoutSimulatorResolveByPAN_KnownCard(t *testing.T) {
 func TestPayoutSimulatorResolveByPAN_Default(t *testing.T) {
 	sim := newPayoutSimulator()

-	scenario := sim.resolveByPAN("2200009999999999")
+	scenario := sim.resolveByPAN(defaultScenarioPAN())
 	if scenario.Name != "default_processing" {
 		t.Fatalf("unexpected default scenario: got=%q", scenario.Name)
 	}
@@ -31,6 +31,21 @@ func TestPayoutSimulatorResolveByPAN_Default(t *testing.T) {
 	}
 }

+func TestPayoutSimulatorScenarioPANs_AreLuhnValidAndExpanded(t *testing.T) {
+	sim := newPayoutSimulator()
+
+	for _, scenario := range sim.scenarios {
+		if got, want := len(scenario.CardNumbers), scenarioPANVariants; got != want {
+			t.Fatalf("expected %d PANs for scenario %q, got=%d", want, scenario.Name, got)
+		}
+		for _, pan := range scenario.CardNumbers {
+			if !isValidPANLuhn(pan) {
+				t.Fatalf("scenario %q has invalid Luhn PAN %q", scenario.Name, pan)
+			}
+		}
+	}
+}
+
 func TestApplyCardPayoutSendResult_AcceptedSuccessStatus(t *testing.T) {
 	state := &model.CardPayout{}
 	result := &provider.CardPayoutSendResult{
--- a/api/payments/orchestrator/go.sum
+++ b/api/payments/orchestrator/go.sum
@@ -155,16 +155,16 @@ go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ
 go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=
 go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.56.0 h1:UP6IpuHFkUgOQL9FFQFrZ+5LiwhhYRbi7VZSIx6Nj5s=
 go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.56.0/go.mod h1:qxuZLtbq5QDtdeSHsS7bcf6EH6uO6jUAgk764zd3rhM=
-go.opentelemetry.io/otel v1.41.0 h1:YlEwVsGAlCvczDILpUXpIpPSL/VPugt7zHThEMLce1c=
-go.opentelemetry.io/otel v1.41.0/go.mod h1:Yt4UwgEKeT05QbLwbyHXEwhnjxNO6D8L5PQP51/46dE=
-go.opentelemetry.io/otel/metric v1.41.0 h1:rFnDcs4gRzBcsO9tS8LCpgR0dxg4aaxWlJxCno7JlTQ=
-go.opentelemetry.io/otel/metric v1.41.0/go.mod h1:xPvCwd9pU0VN8tPZYzDZV/BMj9CM9vs00GuBjeKhJps=
+go.opentelemetry.io/otel v1.42.0 h1:lSQGzTgVR3+sgJDAU/7/ZMjN9Z+vUip7leaqBKy4sho=
+go.opentelemetry.io/otel v1.42.0/go.mod h1:lJNsdRMxCUIWuMlVJWzecSMuNjE7dOYyWlqOXWkdqCc=
+go.opentelemetry.io/otel/metric v1.42.0 h1:2jXG+3oZLNXEPfNmnpxKDeZsFI5o4J+nz6xUlaFdF/4=
+go.opentelemetry.io/otel/metric v1.42.0/go.mod h1:RlUN/7vTU7Ao/diDkEpQpnz3/92J9ko05BIwxYa2SSI=
 go.opentelemetry.io/otel/sdk v1.39.0 h1:nMLYcjVsvdui1B/4FRkwjzoRVsMK8uL/cj0OyhKzt18=
 go.opentelemetry.io/otel/sdk v1.39.0/go.mod h1:vDojkC4/jsTJsE+kh+LXYQlbL8CgrEcwmt1ENZszdJE=
 go.opentelemetry.io/otel/sdk/metric v1.39.0 h1:cXMVVFVgsIf2YL6QkRF4Urbr/aMInf+2WKg+sEJTtB8=
 go.opentelemetry.io/otel/sdk/metric v1.39.0/go.mod h1:xq9HEVH7qeX69/JnwEfp6fVq5wosJsY1mt4lLfYdVew=
-go.opentelemetry.io/otel/trace v1.41.0 h1:Vbk2co6bhj8L59ZJ6/xFTskY+tGAbOnCtQGVVa9TIN0=
-go.opentelemetry.io/otel/trace v1.41.0/go.mod h1:U1NU4ULCoxeDKc09yCWdWe+3QoyweJcISEVa1RBzOis=
+go.opentelemetry.io/otel/trace v1.42.0 h1:OUCgIPt+mzOnaUTpOQcBiM/PLQ/Op7oq6g4LenLmOYY=
+go.opentelemetry.io/otel/trace v1.42.0/go.mod h1:f3K9S+IFqnumBkKhRJMeaZeNk9epyhnCmQh/EysQCdc=
 go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
 go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
 go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
--- a/api/payments/orchestrator/internal/service/orchestrationv2/agg/module.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/agg/module.go
@@ -7,6 +7,7 @@ import (
 	"github.com/tech/sendico/pkg/db/storable"
 	"github.com/tech/sendico/pkg/mlogger"
 	pm "github.com/tech/sendico/pkg/model"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 	"go.mongodb.org/mongo-driver/v2/bson"
 	"go.uber.org/zap"
 )
@@ -68,6 +69,8 @@ type StepExecution struct {
 	FailureCode      string                 `bson:"failureCode,omitempty" json:"failureCode,omitempty"`
 	FailureMsg       string                 `bson:"failureMsg,omitempty" json:"failureMsg,omitempty"`
 	ExternalRefs     []ExternalRef          `bson:"externalRefs,omitempty" json:"externalRefs,omitempty"`
+	ExecutedMoney    *paymenttypes.Money    `bson:"executedMoney,omitempty" json:"executedMoney,omitempty"`
+	ConvertedMoney   *paymenttypes.Money    `bson:"convertedMoney,omitempty" json:"convertedMoney,omitempty"`
 }

 // ExternalRef links step execution to an external operation.
--- a/api/payments/orchestrator/internal/service/orchestrationv2/erecon/event.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/erecon/event.go
@@ -6,6 +6,7 @@ import (

 	"github.com/tech/sendico/payments/orchestrator/internal/service/orchestrationv2/agg"
 	"github.com/tech/sendico/pkg/merrors"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 )

 type normalizedEvent struct {
@@ -15,6 +16,7 @@ type normalizedEvent struct {
 	targetState    agg.StepState     `bson:"targetState"`
 	failureInfo    *failureInfo      `bson:"failure,omitempty"`
 	forceAggregate *forceAggregate   `bson:"forceAggregate,omitempty"`
+	executedMoney  *paymenttypes.Money
 }

 type failureInfo struct {
@@ -123,6 +125,7 @@ func normalizeGatewayEvent(src GatewayEvent) (*normalizedEvent, error) {
 		targetState:    target,
 		failureInfo:    buildFailureInfo(failureCode, failureMsg, normalizeTimePtr(src.OccurredAt)),
 		forceAggregate: buildForceAggregate(src.TerminalFailure, needsAttention),
+		executedMoney:  normalizeEventMoney(src.ExecutedMoney),
 	}
 	ev.matchRefs = normalizeRefList([]agg.ExternalRef{
 		{
@@ -264,6 +267,21 @@ func normalizeCardStatus(status CardStatus) (CardStatus, bool) {
 	}
 }

+func normalizeEventMoney(money *paymenttypes.Money) *paymenttypes.Money {
+	if money == nil {
+		return nil
+	}
+	amount := strings.TrimSpace(money.GetAmount())
+	currency := strings.TrimSpace(money.GetCurrency())
+	if amount == "" || currency == "" {
+		return nil
+	}
+	return &paymenttypes.Money{
+		Amount:   amount,
+		Currency: currency,
+	}
+}
+
 func mapFailureTarget(status any, retryable *bool) (agg.StepState, bool) {
 	switch status {
 	case GatewayStatusCreated, GatewayStatusProcessing, GatewayStatusWaiting:
--- a/api/payments/orchestrator/internal/service/orchestrationv2/erecon/module.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/erecon/module.go
@@ -6,6 +6,7 @@ import (
 	"github.com/tech/sendico/payments/orchestrator/internal/service/orchestrationv2/agg"

 	"github.com/tech/sendico/pkg/mlogger"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 	"go.uber.org/zap"
 )

@@ -81,6 +82,7 @@ type GatewayEvent struct {
 	TransferRef       string
 	GatewayInstanceID string
 	Status            GatewayStatus
+	ExecutedMoney     *paymenttypes.Money
 	FailureCode       string
 	FailureMsg        string
 	Retryable         *bool
--- a/api/payments/orchestrator/internal/service/orchestrationv2/erecon/service.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/erecon/service.go
@@ -10,6 +10,7 @@ import (
 	"github.com/tech/sendico/payments/orchestrator/internal/service/orchestrationv2/xerr"
 	"github.com/tech/sendico/pkg/merrors"
 	"github.com/tech/sendico/pkg/mlogger"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 	"go.mongodb.org/mongo-driver/v2/bson"
 	"go.uber.org/zap"
 )
@@ -124,6 +125,7 @@ func (s *svc) applyStepEvent(step *agg.StepExecution, event *normalizedEvent, sm

 	if out.State == target {
 		changed = s.applyStepDiagnostics(&out, event) || changed
+		changed = applyExecutedMoney(&out, event) || changed
 		*step = out
 		return changed, nil
 	}
@@ -140,11 +142,43 @@ func (s *svc) applyStepEvent(step *agg.StepExecution, event *normalizedEvent, sm
 	out = next
 	changed = changed || transitionChanged
 	changed = s.applyStepDiagnostics(&out, event) || changed
+	changed = applyExecutedMoney(&out, event) || changed

 	*step = out
 	return changed, nil
 }

+func applyExecutedMoney(step *agg.StepExecution, event *normalizedEvent) bool {
+	if step == nil || event == nil {
+		return false
+	}
+	money := normalizeEventMoney(event.executedMoney)
+	if money == nil {
+		return false
+	}
+	if normalizeEventMoney(step.ExecutedMoney) != nil {
+		return false
+	}
+	if stepMoneyEqual(step.ExecutedMoney, money) {
+		return false
+	}
+	step.ExecutedMoney = money
+	return true
+}
+
+func stepMoneyEqual(left, right *paymenttypes.Money) bool {
+	left = normalizeEventMoney(left)
+	right = normalizeEventMoney(right)
+	switch {
+	case left == nil && right == nil:
+		return true
+	case left == nil || right == nil:
+		return false
+	default:
+		return left.Amount == right.Amount && left.Currency == right.Currency
+	}
+}
+
 func transitionStepState(step agg.StepExecution, target agg.StepState, sm ostate.StateMachine) (agg.StepExecution, bool, error) {
 	if step.State == target {
 		return step, false, nil
--- a/api/payments/orchestrator/internal/service/orchestrationv2/erecon/service_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/erecon/service_test.go
@@ -7,6 +7,7 @@ import (

 	"github.com/tech/sendico/payments/orchestrator/internal/service/orchestrationv2/agg"
 	"github.com/tech/sendico/pkg/merrors"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 	"go.uber.org/zap"
 )

@@ -32,6 +33,7 @@ func TestReconcile_GatewayWaiting_UpdatesRunningAndRefs(t *testing.T) {
 				TransferRef:       "tx-1",
 				GatewayInstanceID: "gw-1",
 				Status:            GatewayStatusWaiting,
+				ExecutedMoney:     &paymenttypes.Money{Amount: "5.84", Currency: "USDT"},
 			},
 		},
 	})
@@ -61,6 +63,15 @@ func TestReconcile_GatewayWaiting_UpdatesRunningAndRefs(t *testing.T) {
 	if !hasRef(got.ExternalRefs, agg.ExternalRef{GatewayInstanceID: "gw-1", Kind: ExternalRefKindTransfer, Ref: "tx-1"}) {
 		t.Fatalf("expected transfer_ref external reference")
 	}
+	if got.ExecutedMoney == nil {
+		t.Fatal("expected executed money to be mapped")
+	}
+	if gotAmt, want := got.ExecutedMoney.Amount, "5.84"; gotAmt != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", gotAmt, want)
+	}
+	if gotCur, want := got.ExecutedMoney.Currency, "USDT"; gotCur != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", gotCur, want)
+	}
 	if out.Payment.State != agg.StateExecuting {
 		t.Fatalf("aggregate state mismatch: got=%q want=%q", out.Payment.State, agg.StateExecuting)
 	}
@@ -109,6 +120,54 @@ func TestReconcile_GatewaySuccess_SettlesPayment(t *testing.T) {
 	}
 }

+func TestReconcile_GatewayExecutedMoney_DoesNotOverrideExisting(t *testing.T) {
+	now := time.Date(2026, time.January, 10, 11, 12, 13, 0, time.UTC)
+	reconciler := New(Dependencies{Logger: zap.NewNop(), Now: func() time.Time { return now }})
+
+	out, err := reconciler.Reconcile(Input{
+		Payment: &agg.Payment{
+			PaymentRef: "p1",
+			State:      agg.StateCreated,
+			Version:    1,
+			StepExecutions: []agg.StepExecution{
+				{
+					StepRef:  "s1",
+					StepCode: "observe",
+					State:    agg.StepStatePending,
+					Attempt:  1,
+					ExecutedMoney: &paymenttypes.Money{
+						Amount:   "76.50",
+						Currency: "RUB",
+					},
+				},
+			},
+		},
+		Event: Event{
+			Gateway: &GatewayEvent{
+				StepRef: "s1",
+				Status:  GatewayStatusSuccess,
+				ExecutedMoney: &paymenttypes.Money{
+					Amount:   "7650",
+					Currency: "RUB",
+				},
+			},
+		},
+	})
+	if err != nil {
+		t.Fatalf("Reconcile returned error: %v", err)
+	}
+	step := out.Payment.StepExecutions[0]
+	if step.ExecutedMoney == nil {
+		t.Fatal("expected executed money")
+	}
+	if got, want := step.ExecutedMoney.Amount, "76.50"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := step.ExecutedMoney.Currency, "RUB"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
+}
+
 func TestReconcile_GatewayFailureMapping(t *testing.T) {
 	now := time.Date(2026, time.January, 10, 11, 12, 13, 0, time.UTC)
 	reconciler := New(Dependencies{Logger: zap.NewNop(), Now: func() time.Time { return now }})
--- a/api/payments/orchestrator/internal/service/orchestrationv2/prepo/document.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/prepo/document.go
@@ -9,6 +9,7 @@ import (
 	"github.com/tech/sendico/pkg/db/storable"
 	pm "github.com/tech/sendico/pkg/model"
 	"github.com/tech/sendico/pkg/mservice"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 	"go.mongodb.org/mongo-driver/v2/bson"
 )

@@ -108,6 +109,8 @@ func cloneStepExecutions(src []agg.StepExecution) []agg.StepExecution {
 			step.Attempt = 1
 		}
 		step.ExternalRefs = cloneExternalRefs(step.ExternalRefs)
+		step.ExecutedMoney = cloneStepMoney(step.ExecutedMoney)
+		step.ConvertedMoney = cloneStepMoney(step.ConvertedMoney)
 		step.StartedAt = cloneTime(step.StartedAt)
 		step.CompletedAt = cloneTime(step.CompletedAt)
 		out = append(out, step)
@@ -115,6 +118,21 @@ func cloneStepExecutions(src []agg.StepExecution) []agg.StepExecution {
 	return out
 }

+func cloneStepMoney(money *paymenttypes.Money) *paymenttypes.Money {
+	if money == nil {
+		return nil
+	}
+	amount := strings.TrimSpace(money.GetAmount())
+	currency := strings.TrimSpace(money.GetCurrency())
+	if amount == "" || currency == "" {
+		return nil
+	}
+	return &paymenttypes.Money{
+		Amount:   amount,
+		Currency: currency,
+	}
+}
+
 func cloneExternalRefs(refs []agg.ExternalRef) []agg.ExternalRef {
 	if len(refs) == 0 {
 		return nil
--- a/api/payments/orchestrator/internal/service/orchestrationv2/prmap/service_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/prmap/service_test.go
@@ -118,6 +118,24 @@ func TestMap_Success(t *testing.T) {
 	if got, want := steps[0].GetUserLabel(), "Card payout"; got != want {
 		t.Fatalf("user_label mismatch: got=%q want=%q", got, want)
 	}
+	if steps[0].GetExecutedMoney() == nil {
+		t.Fatal("expected executed_money to be mapped")
+	}
+	if got, want := steps[0].GetExecutedMoney().GetAmount(), "95"; got != want {
+		t.Fatalf("executed_money.amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := steps[0].GetExecutedMoney().GetCurrency(), "USD"; got != want {
+		t.Fatalf("executed_money.currency mismatch: got=%q want=%q", got, want)
+	}
+	if steps[0].GetConvertedMoney() == nil {
+		t.Fatal("expected converted_money to be mapped")
+	}
+	if got, want := steps[0].GetConvertedMoney().GetAmount(), "90"; got != want {
+		t.Fatalf("converted_money.amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := steps[0].GetConvertedMoney().GetCurrency(), "EUR"; got != want {
+		t.Fatalf("converted_money.currency mismatch: got=%q want=%q", got, want)
+	}
 	if got, want := steps[1].GetReportVisibility(), orchestrationv2.ReportVisibility_REPORT_VISIBILITY_HIDDEN; got != want {
 		t.Fatalf("report_visibility mismatch: got=%s want=%s", got.String(), want.String())
 	}
@@ -363,7 +381,15 @@ func newPaymentFixture() *agg.Payment {
 				UserLabel:        " Card payout ",
 				State:            agg.StepStateRunning,
 				Attempt:          0,
-				StartedAt:        &startedAt,
+				ExecutedMoney: &paymenttypes.Money{
+					Amount:   "95",
+					Currency: "USD",
+				},
+				ConvertedMoney: &paymenttypes.Money{
+					Amount:   "90",
+					Currency: "EUR",
+				},
+				StartedAt: &startedAt,
 			},
 			{
 				StepRef:          "s2",
--- a/api/payments/orchestrator/internal/service/orchestrationv2/prmap/step_mapping.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/prmap/step_mapping.go
@@ -46,6 +46,8 @@ func mapStepExecution(step agg.StepExecution, index int) (*orchestrationv2.StepE
 		Refs:             mapExternalRefs(step.StepCode, step.ExternalRefs),
 		ReportVisibility: mapReportVisibility(step.ReportVisibility),
 		UserLabel:        strings.TrimSpace(step.UserLabel),
+		ExecutedMoney:    moneyToProto(step.ExecutedMoney),
+		ConvertedMoney:   moneyToProto(step.ConvertedMoney),
 	}, nil
 }

--- a/api/payments/orchestrator/internal/service/orchestrationv2/psvc/default_executors.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/psvc/default_executors.go
@@ -85,6 +85,8 @@ func (defaultObserveConfirmExecutor) ExecuteObserveConfirm(_ context.Context, re
 	step := req.StepExecution
 	step.State = agg.StepStateRunning
 	step.ExternalRefs = refs
+	step.ExecutedMoney = inheritedExecutedMoney(req.Payment, req.Step, req.StepExecution)
+	step.ConvertedMoney = inheritedConvertedMoney(req.Payment, req.Step, req.StepExecution)
 	step.FailureCode = ""
 	step.FailureMsg = ""
 	return &sexec.ExecuteOutput{
@@ -198,6 +200,46 @@ func inheritedExternalRefs(payment *agg.Payment, step xplan.Step, current agg.St
 	return refs
 }

+func inheritedExecutedMoney(payment *agg.Payment, step xplan.Step, current agg.StepExecution) *paymenttypes.Money {
+	if money := cloneStepMoney(current.ExecutedMoney); money != nil {
+		return money
+	}
+	if payment == nil || len(step.DependsOn) == 0 {
+		return nil
+	}
+	index := stepIndexByRef(payment.StepExecutions)
+	for i := range step.DependsOn {
+		idx, ok := index[strings.TrimSpace(step.DependsOn[i])]
+		if !ok || idx < 0 || idx >= len(payment.StepExecutions) {
+			continue
+		}
+		if money := cloneStepMoney(payment.StepExecutions[idx].ExecutedMoney); money != nil {
+			return money
+		}
+	}
+	return nil
+}
+
+func inheritedConvertedMoney(payment *agg.Payment, step xplan.Step, current agg.StepExecution) *paymenttypes.Money {
+	if money := cloneStepMoney(current.ConvertedMoney); money != nil {
+		return money
+	}
+	if payment == nil || len(step.DependsOn) == 0 {
+		return nil
+	}
+	index := stepIndexByRef(payment.StepExecutions)
+	for i := range step.DependsOn {
+		idx, ok := index[strings.TrimSpace(step.DependsOn[i])]
+		if !ok || idx < 0 || idx >= len(payment.StepExecutions) {
+			continue
+		}
+		if money := cloneStepMoney(payment.StepExecutions[idx].ConvertedMoney); money != nil {
+			return money
+		}
+	}
+	return nil
+}
+
 func appendExternalRefs(existing []agg.ExternalRef, additions ...agg.ExternalRef) []agg.ExternalRef {
 	out := append([]agg.ExternalRef{}, existing...)
 	seen := map[string]struct{}{}
--- a/api/payments/orchestrator/internal/service/orchestrationv2/psvc/default_executors_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/psvc/default_executors_test.go
@@ -122,6 +122,14 @@ func TestDefaultObserveConfirmExecutor_InheritsDependencyRefs(t *testing.T) {
 			StepExecutions: []agg.StepExecution{
 				{
 					StepRef: "hop_1_crypto_send",
+					ExecutedMoney: &paymenttypes.Money{
+						Amount:   "1.000000",
+						Currency: "USDT",
+					},
+					ConvertedMoney: &paymenttypes.Money{
+						Amount:   "95.00",
+						Currency: "EUR",
+					},
 					ExternalRefs: []agg.ExternalRef{
 						{GatewayInstanceID: "crypto-gw", Kind: "operation_ref", Ref: "op-1"},
 						{GatewayInstanceID: "crypto-gw", Kind: "transfer_ref", Ref: "trf-1"},
@@ -161,4 +169,22 @@ func TestDefaultObserveConfirmExecutor_InheritsDependencyRefs(t *testing.T) {
 	if got, want := out.StepExecution.ExternalRefs[0].Ref, "op-1"; got != want {
 		t.Fatalf("first external ref value mismatch: got=%q want=%q", got, want)
 	}
+	if out.StepExecution.ExecutedMoney == nil {
+		t.Fatal("expected executed money to be inherited from dependency")
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Amount, "1.000000"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Currency, "USDT"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
+	if out.StepExecution.ConvertedMoney == nil {
+		t.Fatal("expected converted money to be inherited from dependency")
+	}
+	if got, want := out.StepExecution.ConvertedMoney.Amount, "95.00"; got != want {
+		t.Fatalf("converted money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := out.StepExecution.ConvertedMoney.Currency, "EUR"; got != want {
+		t.Fatalf("converted money currency mismatch: got=%q want=%q", got, want)
+	}
 }
--- a/api/payments/orchestrator/internal/service/orchestrationv2/psvc/runtime.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/psvc/runtime.go
@@ -325,6 +325,8 @@ func normalizeExecutorOutput(current agg.StepExecution, out *sexec.ExecuteOutput
 		next.Attempt = out.StepExecution.Attempt
 	}
 	next.ExternalRefs = out.StepExecution.ExternalRefs
+	next.ExecutedMoney = cloneStepMoney(out.StepExecution.ExecutedMoney)
+	next.ConvertedMoney = cloneStepMoney(out.StepExecution.ConvertedMoney)
 	next.FailureCode = strings.TrimSpace(out.StepExecution.FailureCode)
 	next.FailureMsg = strings.TrimSpace(out.StepExecution.FailureMsg)

@@ -437,6 +439,12 @@ func stepExecutionEqual(left, right agg.StepExecution) bool {
 			return false
 		}
 	}
+	if !stepMoneyEqual(left.ExecutedMoney, right.ExecutedMoney) {
+		return false
+	}
+	if !stepMoneyEqual(left.ConvertedMoney, right.ConvertedMoney) {
+		return false
+	}
 	return true
 }

--- a/api/payments/orchestrator/internal/service/orchestrationv2/psvc/step_money.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/psvc/step_money.go
@@ -0,0 +1,35 @@
+package psvc
+
+import (
+	"strings"
+
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
+)
+
+func cloneStepMoney(src *paymenttypes.Money) *paymenttypes.Money {
+	if src == nil {
+		return nil
+	}
+	amount := strings.TrimSpace(src.GetAmount())
+	currency := strings.TrimSpace(src.GetCurrency())
+	if amount == "" || currency == "" {
+		return nil
+	}
+	return &paymenttypes.Money{
+		Amount:   amount,
+		Currency: currency,
+	}
+}
+
+func stepMoneyEqual(left, right *paymenttypes.Money) bool {
+	left = cloneStepMoney(left)
+	right = cloneStepMoney(right)
+	switch {
+	case left == nil && right == nil:
+		return true
+	case left == nil || right == nil:
+		return false
+	default:
+		return left.Amount == right.Amount && left.Currency == right.Currency
+	}
+}
--- a/api/payments/orchestrator/internal/service/orchestrationv2/ssched/input.go
+++ b/api/payments/orchestrator/internal/service/orchestrationv2/ssched/input.go
@@ -8,6 +8,7 @@ import (
 	"github.com/tech/sendico/payments/storage/model"
 	"github.com/tech/sendico/pkg/discovery"
 	"github.com/tech/sendico/pkg/merrors"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 )

 func (s *svc) prepareInput(in Input) (*preparedInput, error) {
@@ -174,6 +175,8 @@ func (s *svc) normalizeStepExecution(exec agg.StepExecution, index int) (agg.Ste
 	exec.Rail = model.ParseRail(string(exec.Rail))
 	exec.ReportVisibility = model.NormalizeReportVisibility(exec.ReportVisibility)
 	exec.ExternalRefs = cloneExternalRefs(exec.ExternalRefs)
+	exec.ExecutedMoney = cloneStepMoney(exec.ExecutedMoney)
+	exec.ConvertedMoney = cloneStepMoney(exec.ConvertedMoney)
 	if exec.StepRef == "" {
 		return agg.StepExecution{}, merrors.InvalidArgument("stepExecutions[" + itoa(index) + "].step_ref is required")
 	}
@@ -257,9 +260,26 @@ func normalizeStepState(state agg.StepState) (agg.StepState, bool) {
 func cloneStepExecution(exec agg.StepExecution) agg.StepExecution {
 	out := exec
 	out.ExternalRefs = cloneExternalRefs(exec.ExternalRefs)
+	out.ExecutedMoney = cloneStepMoney(exec.ExecutedMoney)
+	out.ConvertedMoney = cloneStepMoney(exec.ConvertedMoney)
 	return out
 }

+func cloneStepMoney(money *paymenttypes.Money) *paymenttypes.Money {
+	if money == nil {
+		return nil
+	}
+	amount := strings.TrimSpace(money.GetAmount())
+	currency := strings.TrimSpace(money.GetCurrency())
+	if amount == "" || currency == "" {
+		return nil
+	}
+	return &paymenttypes.Money{
+		Amount:   amount,
+		Currency: currency,
+	}
+}
+
 func cloneExternalRefs(refs []agg.ExternalRef) []agg.ExternalRef {
 	if len(refs) == 0 {
 		return nil
--- a/api/payments/orchestrator/internal/service/orchestrator/card_payout_executor.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/card_payout_executor.go
@@ -170,6 +170,11 @@ func (e *gatewayCardPayoutExecutor) ExecuteCardPayout(ctx context.Context, req s
 	step := req.StepExecution
 	step.State = agg.StepStateCompleted
 	step.ExternalRefs = externalRefs
+	step.ExecutedMoney = cardMinorToMoney(responsePayout.GetAmountMinor(), responsePayout.GetCurrency())
+	if step.ExecutedMoney == nil {
+		step.ExecutedMoney = cardMinorToMoney(amountMinor, currency)
+	}
+	step.ConvertedMoney = nil
 	step.FailureCode = ""
 	step.FailureMsg = ""
 	return &sexec.ExecuteOutput{StepExecution: step}, nil
--- a/api/payments/orchestrator/internal/service/orchestrator/card_payout_executor_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/card_payout_executor_test.go
@@ -100,9 +100,10 @@ func TestGatewayCardPayoutExecutor_ExecuteCardPayout_SubmitsCardPayout(t *testin
 			InstanceID: paymenttypes.DefaultCardsGatewayID,
 		},
 		StepExecution: agg.StepExecution{
-			StepRef:  "hop_4_card_payout_send",
-			StepCode: "hop.4.card_payout.send",
-			Attempt:  1,
+			StepRef:        "hop_4_card_payout_send",
+			StepCode:       "hop.4.card_payout.send",
+			Attempt:        1,
+			ConvertedMoney: &paymenttypes.Money{Amount: "1.00", Currency: "USD"},
 		},
 	}

@@ -116,6 +117,18 @@ func TestGatewayCardPayoutExecutor_ExecuteCardPayout_SubmitsCardPayout(t *testin
 	if out.StepExecution.State != agg.StepStateCompleted {
 		t.Fatalf("expected completed state, got=%q", out.StepExecution.State)
 	}
+	if out.StepExecution.ExecutedMoney == nil {
+		t.Fatal("expected executed money to be recorded")
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Amount, "76.50"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Currency, "RUB"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
+	if got := out.StepExecution.ConvertedMoney; got != nil {
+		t.Fatalf("expected converted money to be cleared for card payout step, got=%+v", got)
+	}
 	if payoutReq == nil {
 		t.Fatal("expected payout request to be submitted")
 	}
--- a/api/payments/orchestrator/internal/service/orchestrator/crypto_executor.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/crypto_executor.go
@@ -93,6 +93,11 @@ func (e *gatewayCryptoExecutor) ExecuteCrypto(ctx context.Context, req sexec.Ste
 		return nil, refsErr
 	}
 	step.ExternalRefs = refs
+	step.ExecutedMoney = transferExecutedMoney(resp.GetTransfer())
+	if step.ExecutedMoney == nil {
+		step.ExecutedMoney = protoMoneyToPaymentMoney(amount)
+	}
+	step.ConvertedMoney = nil

 	if action == discovery.RailOperationSend {
 		if err := e.submitWalletFeeTransfer(ctx, req, client, gateway, sourceWalletRef, operationRef, idempotencyKey); err != nil {
--- a/api/payments/orchestrator/internal/service/orchestrator/crypto_executor_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/crypto_executor_test.go
@@ -106,6 +106,15 @@ func TestGatewayCryptoExecutor_ExecuteCrypto_SubmitsTransfer(t *testing.T) {
 	if out.StepExecution.State != agg.StepStateCompleted {
 		t.Fatalf("expected completed state, got=%q", out.StepExecution.State)
 	}
+	if out.StepExecution.ExecutedMoney == nil {
+		t.Fatal("expected executed money to be recorded")
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Amount, "1.000000"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Currency, "USDT"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
 	if submitReq == nil {
 		t.Fatal("expected transfer submission request")
 	}
--- a/api/payments/orchestrator/internal/service/orchestrator/external_runtime.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/external_runtime.go
@@ -159,6 +159,7 @@ func buildGatewayExecutionEvent(payment *agg.Payment, msg *pmodel.PaymentGateway
 		TransferRef:       transferRef,
 		GatewayInstanceID: gatewayInstanceID,
 		Status:            status,
+		ExecutedMoney:     clonePaymentMoney(msg.ExecutedMoney),
 	}

 	switch status {
@@ -479,6 +480,7 @@ func (s *Service) pollObserveCandidate(ctx context.Context, payment *agg.Payment
 		TransferRef:       strings.TrimSpace(candidate.transferRef),
 		GatewayInstanceID: resolvedObserveGatewayID(candidate.gatewayInstanceID, gateway),
 		Status:            status,
+		ExecutedMoney:     transferExecutedMoney(transfer),
 	}
 	switch status {
 	case erecon.GatewayStatusFailed:
@@ -544,6 +546,10 @@ func (s *Service) resolveObserveGateway(ctx context.Context, payment *agg.Paymen
 			return item, nil
 		}
 	}
+	if s.logger != nil {
+		s.logger.Debug("Gateway for polling not found", zap.String("instance_id", hint.instanceID),
+			zap.String("expected_rail", string(expectedRail)), zap.String("hint_rail", string(hint.rail)))
+	}
 	return nil, errors.New("observe polling: gateway instance not found")
 }

--- a/api/payments/orchestrator/internal/service/orchestrator/external_runtime_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/external_runtime_test.go
@@ -15,6 +15,7 @@ import (
 	pm "github.com/tech/sendico/pkg/model"
 	"github.com/tech/sendico/pkg/payments/rail"
 	paymenttypes "github.com/tech/sendico/pkg/payments/types"
+	moneyv1 "github.com/tech/sendico/pkg/proto/common/money/v1"
 	chainv1 "github.com/tech/sendico/pkg/proto/gateway/chain/v1"
 	orchestrationv2 "github.com/tech/sendico/pkg/proto/payments/orchestration/v2"
 	"go.mongodb.org/mongo-driver/v2/bson"
@@ -43,9 +44,10 @@ func TestBuildGatewayExecutionEvent_MapsStatusAndMatchedStep(t *testing.T) {
 	}

 	event, ok := buildGatewayExecutionEvent(payment, &pm.PaymentGatewayExecution{
-		PaymentRef:  payment.PaymentRef,
-		Status:      rail.OperationResultSuccess,
-		TransferRef: "trf-1",
+		PaymentRef:    payment.PaymentRef,
+		Status:        rail.OperationResultSuccess,
+		TransferRef:   "trf-1",
+		ExecutedMoney: &paymenttypes.Money{Amount: "5.84", Currency: "USDT"},
 	})
 	if !ok {
 		t.Fatal("expected gateway execution event to be accepted")
@@ -59,6 +61,15 @@ func TestBuildGatewayExecutionEvent_MapsStatusAndMatchedStep(t *testing.T) {
 	if got, want := event.Status, erecon.GatewayStatusSuccess; got != want {
 		t.Fatalf("status mismatch: got=%q want=%q", got, want)
 	}
+	if event.ExecutedMoney == nil {
+		t.Fatal("expected executed money to be mapped")
+	}
+	if got, want := event.ExecutedMoney.Amount, "5.84"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := event.ExecutedMoney.Currency, "USDT"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
 }

 func TestBuildGatewayExecutionEvent_FailedSetsTerminalNeedsAttentionHint(t *testing.T) {
@@ -602,6 +613,7 @@ func TestPollObserveCandidate_UsesResolvedGatewayAfterInstanceRotation(t *testin
 					TransferRef:  req.GetTransferRef(),
 					OperationRef: operationRef,
 					Status:       chainv1.TransferStatus_TRANSFER_SUCCESS,
+					NetAmount:    &moneyv1.Money{Amount: "460.00", Currency: "RUB"},
 				},
 			}, nil
 		},
@@ -676,6 +688,15 @@ func TestPollObserveCandidate_UsesResolvedGatewayAfterInstanceRotation(t *testin
 	if got, want := gw.GatewayInstanceID, "ea2600ce-3de6-4cc5-bd1e-e26ebaceb6b4"; got != want {
 		t.Fatalf("gateway_instance_id mismatch: got=%q want=%q", got, want)
 	}
+	if gw.ExecutedMoney == nil {
+		t.Fatal("expected executed money in reconciled gateway event")
+	}
+	if got, want := gw.ExecutedMoney.Amount, "460.00"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := gw.ExecutedMoney.Currency, "RUB"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
 }

 var _ prepo.Repository = (*fakeExternalRuntimeRepo)(nil)
--- a/api/payments/orchestrator/internal/service/orchestrator/ledger_executor.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/ledger_executor.go
@@ -118,6 +118,8 @@ func (e *gatewayLedgerExecutor) ExecuteLedger(ctx context.Context, req sexec.Ste
 	step.State = agg.StepStateCompleted
 	step.FailureCode = ""
 	step.FailureMsg = ""
+	step.ExecutedMoney = protoMoneyToPaymentMoney(amount)
+	step.ConvertedMoney = nil
 	step.ExternalRefs = appendLedgerExternalRef(step.ExternalRefs, agg.ExternalRef{
 		GatewayInstanceID: firstNonEmpty(strings.TrimSpace(req.Step.InstanceID), strings.TrimSpace(req.Step.Gateway)),
 		Kind:              erecon.ExternalRefKindLedger,
--- a/api/payments/orchestrator/internal/service/orchestrator/ledger_executor_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/ledger_executor_test.go
@@ -42,9 +42,10 @@ func TestGatewayLedgerExecutor_ExecuteLedger_CreditUsesSourceAmountAndDefaultRol
 			Rail:     discovery.RailLedger,
 		},
 		StepExecution: agg.StepExecution{
-			StepRef:  "edge_1_2_ledger_credit",
-			StepCode: "edge.1_2.ledger.credit",
-			Attempt:  1,
+			StepRef:        "edge_1_2_ledger_credit",
+			StepCode:       "edge.1_2.ledger.credit",
+			Attempt:        1,
+			ConvertedMoney: &paymenttypes.Money{Amount: "42", Currency: "EUR"},
 		},
 	})
 	if err != nil {
@@ -71,6 +72,18 @@ func TestGatewayLedgerExecutor_ExecuteLedger_CreditUsesSourceAmountAndDefaultRol
 	if got, want := out.StepExecution.State, agg.StepStateCompleted; got != want {
 		t.Fatalf("state mismatch: got=%q want=%q", got, want)
 	}
+	if out.StepExecution.ExecutedMoney == nil {
+		t.Fatal("expected executed money to be recorded")
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Amount, "1.000000"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Currency, "USDT"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
+	if got := out.StepExecution.ConvertedMoney; got != nil {
+		t.Fatalf("expected converted money to be cleared for ledger step, got=%+v", got)
+	}
 	if len(out.StepExecution.ExternalRefs) != 1 {
 		t.Fatalf("expected one external ref, got=%d", len(out.StepExecution.ExternalRefs))
 	}
--- a/api/payments/orchestrator/internal/service/orchestrator/settlement_executor.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/settlement_executor.go
@@ -10,6 +10,7 @@ import (
 	"github.com/tech/sendico/payments/orchestrator/internal/service/orchestrationv2/xplan"
 	"github.com/tech/sendico/payments/storage/model"
 	"github.com/tech/sendico/pkg/merrors"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
 	moneyv1 "github.com/tech/sendico/pkg/proto/common/money/v1"
 	chainv1 "github.com/tech/sendico/pkg/proto/gateway/chain/v1"
 )
@@ -55,6 +56,10 @@ func (e *gatewayProviderSettlementExecutor) ExecuteProviderSettlement(ctx contex
 	if err != nil {
 		return nil, err
 	}
+	convertedAmount := settlementConvertedMoney(req.Payment)
+	if convertedAmount == nil {
+		return nil, merrors.InvalidArgument("settlement fx_convert: converted amount is required")
+	}

 	stepRef := strings.TrimSpace(req.Step.StepRef)
 	operationRef := strings.TrimSpace(req.Payment.PaymentRef) + ":" + stepRef
@@ -93,12 +98,21 @@ func (e *gatewayProviderSettlementExecutor) ExecuteProviderSettlement(ctx contex
 		return nil, refsErr
 	}
 	step.ExternalRefs = refs
+	step.ExecutedMoney = protoMoneyToPaymentMoney(amount)
+	step.ConvertedMoney = convertedAmount
 	step.State = agg.StepStateCompleted
 	step.FailureCode = ""
 	step.FailureMsg = ""
 	return &sexec.ExecuteOutput{StepExecution: step}, nil
 }

+func settlementConvertedMoney(payment *agg.Payment) *paymenttypes.Money {
+	if payment == nil || payment.QuoteSnapshot == nil {
+		return nil
+	}
+	return clonePaymentMoney(payment.QuoteSnapshot.ExpectedSettlementAmount)
+}
+
 func (e *gatewayProviderSettlementExecutor) resolveGateway(ctx context.Context, step xplan.Step) (*model.GatewayInstanceDescriptor, error) {
 	if e.gatewayRegistry == nil {
 		return nil, merrors.InvalidArgument("settlement fx_convert: gateway registry is required")
--- a/api/payments/orchestrator/internal/service/orchestrator/settlement_executor_test.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/settlement_executor_test.go
@@ -101,6 +101,24 @@ func TestGatewayProviderSettlementExecutor_ExecuteProviderSettlement_SubmitsTran
 	if out.StepExecution.State != agg.StepStateCompleted {
 		t.Fatalf("expected completed state, got=%q", out.StepExecution.State)
 	}
+	if out.StepExecution.ExecutedMoney == nil {
+		t.Fatal("expected executed money to be recorded")
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Amount, "1.000000"; got != want {
+		t.Fatalf("executed money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := out.StepExecution.ExecutedMoney.Currency, "USDT"; got != want {
+		t.Fatalf("executed money currency mismatch: got=%q want=%q", got, want)
+	}
+	if out.StepExecution.ConvertedMoney == nil {
+		t.Fatal("expected converted money to be recorded for settlement fx_convert")
+	}
+	if got, want := out.StepExecution.ConvertedMoney.Amount, "76.63"; got != want {
+		t.Fatalf("converted money amount mismatch: got=%q want=%q", got, want)
+	}
+	if got, want := out.StepExecution.ConvertedMoney.Currency, "RUB"; got != want {
+		t.Fatalf("converted money currency mismatch: got=%q want=%q", got, want)
+	}
 	if submitReq == nil {
 		t.Fatal("expected transfer submission request")
 	}
@@ -190,3 +208,64 @@ func TestGatewayProviderSettlementExecutor_ExecuteProviderSettlement_MissingSett
 		t.Fatalf("unexpected error: %v", err)
 	}
 }
+
+func TestGatewayProviderSettlementExecutor_ExecuteProviderSettlement_MissingConvertedAmount(t *testing.T) {
+	orgID := bson.NewObjectID()
+
+	executor := &gatewayProviderSettlementExecutor{
+		gatewayInvokeResolver: &fakeGatewayInvokeResolver{
+			client: &chainclient.Fake{},
+		},
+		gatewayRegistry: &fakeGatewayRegistry{
+			items: []*model.GatewayInstanceDescriptor{
+				{
+					ID:         "payment_gateway_settlement",
+					InstanceID: "payment_gateway_settlement",
+					Rail:       discovery.RailProviderSettlement,
+					InvokeURI:  "grpc://tgsettle-gateway",
+					IsEnabled:  true,
+				},
+			},
+		},
+	}
+
+	_, err := executor.ExecuteProviderSettlement(context.Background(), sexec.StepRequest{
+		Payment: &agg.Payment{
+			OrganizationBoundBase: pm.OrganizationBoundBase{OrganizationRef: orgID},
+			PaymentRef:            "payment-3",
+			IdempotencyKey:        "idem-3",
+			IntentSnapshot: model.PaymentIntent{
+				Ref: "intent-3",
+				Source: model.PaymentEndpoint{
+					Type: model.EndpointTypeManagedWallet,
+					ManagedWallet: &model.ManagedWalletEndpoint{
+						ManagedWalletRef: "wallet-src",
+					},
+				},
+				Amount: &paymenttypes.Money{Amount: "1.000000", Currency: "USDT"},
+			},
+			QuoteSnapshot: &model.PaymentQuoteSnapshot{
+				DebitAmount: &paymenttypes.Money{Amount: "1.000000", Currency: "USDT"},
+			},
+		},
+		Step: xplan.Step{
+			StepRef:    "hop_2_settlement_fx_convert",
+			StepCode:   "hop.2.settlement.fx_convert",
+			Action:     discovery.RailOperationFXConvert,
+			Rail:       discovery.RailProviderSettlement,
+			Gateway:    "payment_gateway_settlement",
+			InstanceID: "payment_gateway_settlement",
+		},
+		StepExecution: agg.StepExecution{
+			StepRef:  "hop_2_settlement_fx_convert",
+			StepCode: "hop.2.settlement.fx_convert",
+			Attempt:  1,
+		},
+	})
+	if err == nil {
+		t.Fatal("expected error")
+	}
+	if !strings.Contains(err.Error(), "converted amount is required") {
+		t.Fatalf("unexpected error: %v", err)
+	}
+}
--- a/api/payments/orchestrator/internal/service/orchestrator/step_money.go
+++ b/api/payments/orchestrator/internal/service/orchestrator/step_money.go
@@ -0,0 +1,64 @@
+package orchestrator
+
+import (
+	"strings"
+
+	"github.com/shopspring/decimal"
+	paymenttypes "github.com/tech/sendico/pkg/payments/types"
+	moneyv1 "github.com/tech/sendico/pkg/proto/common/money/v1"
+	chainv1 "github.com/tech/sendico/pkg/proto/gateway/chain/v1"
+)
+
+var cardMinorUnitScale = decimal.NewFromInt(100)
+
+func clonePaymentMoney(src *paymenttypes.Money) *paymenttypes.Money {
+	if src == nil {
+		return nil
+	}
+	amount := strings.TrimSpace(src.GetAmount())
+	currency := strings.TrimSpace(src.GetCurrency())
+	if amount == "" || currency == "" {
+		return nil
+	}
+	return &paymenttypes.Money{
+		Amount:   amount,
+		Currency: currency,
+	}
+}
+
+func protoMoneyToPaymentMoney(src *moneyv1.Money) *paymenttypes.Money {
+	if src == nil {
+		return nil
+	}
+	amount := strings.TrimSpace(src.GetAmount())
+	currency := strings.TrimSpace(src.GetCurrency())
+	if amount == "" || currency == "" {
+		return nil
+	}
+	return &paymenttypes.Money{Amount: amount, Currency: currency}
+}
+
+func transferExecutedMoney(transfer *chainv1.Transfer) *paymenttypes.Money {
+	if transfer == nil {
+		return nil
+	}
+	if money := protoMoneyToPaymentMoney(transfer.GetNetAmount()); money != nil {
+		return money
+	}
+	return protoMoneyToPaymentMoney(transfer.GetRequestedAmount())
+}
+
+func cardMinorToMoney(amountMinor int64, currency string) *paymenttypes.Money {
+	currency = strings.ToUpper(strings.TrimSpace(currency))
+	if idx := strings.Index(currency, "-"); idx > 0 {
+		currency = currency[:idx]
+	}
+	if currency == "" {
+		return nil
+	}
+	amount := decimal.NewFromInt(amountMinor).Div(cardMinorUnitScale)
+	return &paymenttypes.Money{
+		Amount:   amount.StringFixed(2),
+		Currency: currency,
+	}
+}
--- a/api/payments/quotation/go.sum
+++ b/api/payments/quotation/go.sum
@@ -155,16 +155,16 @@ go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ
 go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=
 go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.56.0 h1:UP6IpuHFkUgOQL9FFQFrZ+5LiwhhYRbi7VZSIx6Nj5s=
 go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.56.0/go.mod h1:qxuZLtbq5QDtdeSHsS7bcf6EH6uO6jUAgk764zd3rhM=
-go.opentelemetry.io/otel v1.41.0 h1:YlEwVsGAlCvczDILpUXpIpPSL/VPugt7zHThEMLce1c=
-go.opentelemetry.io/otel v1.41.0/go.mod h1:Yt4UwgEKeT05QbLwbyHXEwhnjxNO6D8L5PQP51/46dE=
-go.opentelemetry.io/otel/metric v1.41.0 h1:rFnDcs4gRzBcsO9tS8LCpgR0dxg4aaxWlJxCno7JlTQ=
-go.opentelemetry.io/otel/metric v1.41.0/go.mod h1:xPvCwd9pU0VN8tPZYzDZV/BMj9CM9vs00GuBjeKhJps=
+go.opentelemetry.io/otel v1.42.0 h1:lSQGzTgVR3+sgJDAU/7/ZMjN9Z+vUip7leaqBKy4sho=
+go.opentelemetry.io/otel v1.42.0/go.mod h1:lJNsdRMxCUIWuMlVJWzecSMuNjE7dOYyWlqOXWkdqCc=
+go.opentelemetry.io/otel/metric v1.42.0 h1:2jXG+3oZLNXEPfNmnpxKDeZsFI5o4J+nz6xUlaFdF/4=
+go.opentelemetry.io/otel/metric v1.42.0/go.mod h1:RlUN/7vTU7Ao/diDkEpQpnz3/92J9ko05BIwxYa2SSI=
 go.opentelemetry.io/otel/sdk v1.39.0 h1:nMLYcjVsvdui1B/4FRkwjzoRVsMK8uL/cj0OyhKzt18=
 go.opentelemetry.io/otel/sdk v1.39.0/go.mod h1:vDojkC4/jsTJsE+kh+LXYQlbL8CgrEcwmt1ENZszdJE=
 go.opentelemetry.io/otel/sdk/metric v1.39.0 h1:cXMVVFVgsIf2YL6QkRF4Urbr/aMInf+2WKg+sEJTtB8=
 go.opentelemetry.io/otel/sdk/metric v1.39.0/go.mod h1:xq9HEVH7qeX69/JnwEfp6fVq5wosJsY1mt4lLfYdVew=
-go.opentelemetry.io/otel/trace v1.41.0 h1:Vbk2co6bhj8L59ZJ6/xFTskY+tGAbOnCtQGVVa9TIN0=
-go.opentelemetry.io/otel/trace v1.41.0/go.mod h1:U1NU4ULCoxeDKc09yCWdWe+3QoyweJcISEVa1RBzOis=
+go.opentelemetry.io/otel/trace v1.42.0 h1:OUCgIPt+mzOnaUTpOQcBiM/PLQ/Op7oq6g4LenLmOYY=
+go.opentelemetry.io/otel/trace v1.42.0/go.mod h1:f3K9S+IFqnumBkKhRJMeaZeNk9epyhnCmQh/EysQCdc=
 go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
 go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
 go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
--- a/api/proto/payments/orchestration/v2/orchestration.proto
+++ b/api/proto/payments/orchestration/v2/orchestration.proto
@@ -6,6 +6,7 @@ option go_package = "github.com/tech/sendico/pkg/proto/payments/orchestration/v2

 import "google/protobuf/timestamp.proto";
 import "api/proto/common/gateway/v1/gateway.proto";
+import "api/proto/common/money/v1/money.proto";
 import "api/proto/common/pagination/v1/cursor.proto";
 import "api/proto/payments/shared/v1/shared.proto";
 import "api/proto/payments/quotation/v2/quotation.proto";
@@ -175,6 +176,10 @@ message StepExecution {
  ReportVisibility report_visibility = 9;
  // Optional user-facing operation label.
  string user_label = 10;
+  // Final amount processed by this step (if known).
+  common.money.v1.Money executed_money = 11;
+  // Converted amount produced by this step (for FX operations).
+  common.money.v1.Money converted_money = 12;
 }

 // Kept local on purpose: no shared enum exists for orchestration step runtime.
--- a/ci/dev/README.md
+++ b/ci/dev/README.md
@@ -27,7 +27,7 @@ make up
 make vault-init

 # 4. View logs
-make logs SERVICE=ledger
+make logs SERVICE=dev-ledger

 # 5. Stop everything
 make down
@@ -46,8 +46,8 @@ All in `.env.dev` (plaintext for dev):
 make build                  # Build all images
 make up                     # Start environment
 make down                   # Stop environment
-make logs SERVICE=ledger    # View service logs
-make rebuild SERVICE=ledger # Rebuild specific service
+make logs SERVICE=dev-ledger    # View service logs
+make rebuild SERVICE=dev-ledger # Rebuild specific service
 make proto                  # Regenerate protobuf
 make clean                  # Remove everything
 make status                 # Check service status
@@ -78,11 +78,11 @@ After code changes:

 ```bash
 # Rebuild specific service
-make rebuild SERVICE=ledger
+make rebuild SERVICE=dev-ledger

 # Or manually
-docker compose -f docker-compose.dev.yml build ledger
-docker compose -f docker-compose.dev.yml up -d --force-recreate ledger
+docker compose -f docker-compose.dev.yml build dev-ledger
+docker compose -f docker-compose.dev.yml up -d --force-recreate dev-ledger
 ```

 ## Adding New Services