feat: OCP pay-flow (RealU→ZCHF→Open CryptoPay)

assets/languages/strings_de.arb

@@ -33,8 +33,8 @@
   "buyPaymentConfirmFailedAktionariat": "Es gibt ein technisches Problem. Bitte überprüfen Sie Ihr E-Mail-Postfach, möglicherweise fehlt noch eine Bestätigung Ihrer Blockchain-Adresse. Andernfalls versuchen Sie es später erneut. Falls der Fehler weiterhin besteht, kontaktieren Sie unseren Support.",
   "buyPaymentInformation": "Zahlungsinformationen",
   "buyPaymentInformationDescription": "Bitte überweisen Sie den Kaufbetrag mit diesen Angaben über Ihre Bankanwendung. Der Verwendungszweck ist wichtig!",
-  "buyRealUnit": "RealUnit kaufen",
   "buyRealu": "RealUnit Token kaufen",
+  "buyRealUnit": "RealUnit kaufen",
   "cancel": "Abbrechen",
   "changeAddress": "Adresse ändern",
   "changeInReview": "Änderung in Prüfung",
@@ -53,11 +53,11 @@
   "connectBitboxContent": "Bitte verbinden Sie Ihre BitBox mit Ihrem Smartphone.",
   "connectBitboxContentIos": "Bitte verbinden Sie Ihre BitBox mit Ihrem Smartphone und aktivieren Sie zusätzlich Bluetooth.",
   "connectBitboxFailed": "Es ist ein Fehler aufgetreten. Bitte versuchen Sie es erneut.",
-  "connectBitboxSignInHint": "Nach der Code-Überprüfung wird die BitBox um eine zusätzliche Bestätigung zur Anmeldung gebeten.",
   "connectBitboxSignatureCapturing": "Bitte bestätigen Sie die Anmeldeanfrage auf Ihrem BitBox-Gerät. Diese Signatur wird einmalig erfasst, damit künftige Käufe Ihre BitBox nicht erneut benötigen.",
   "connectBitboxSignatureCapturingTitle": "Anmeldung bestätigen",
   "connectBitboxSignatureFailed": "Ihre Anmeldesignatur konnte nicht erfasst werden. Sie können es erneut versuchen oder trotzdem fortfahren – Ihre BitBox wird dann möglicherweise für Ihren ersten Kauf erneut benötigt.",
   "connectBitboxSignatureFailedTitle": "Anmeldung nicht abgeschlossen",
+  "connectBitboxSignInHint": "Nach der Code-Überprüfung wird die BitBox um eine zusätzliche Bestätigung zur Anmeldung gebeten.",
   "connectBitboxTitle": "BitBox verbinden",
   "connected": "Verbunden",
   "connectedBitboxContent": "Bitte bestätigen Sie und folgen nun den letzten Anweisungen auf Ihrer BitBox.",
@@ -167,10 +167,38 @@
   "or": "Oder",
   "originalPdf": "Original-PDF",
   "pay": "Bezahlen",
+  "payAwaitingSettlement": "Zahlung wird abgeschlossen",
+  "payConfirmButton": "Bezahlen",
+  "payFailureBitboxRequired": "Bitte verbinden Sie Ihre BitBox, um fortzufahren.",
+  "payFailureGeneric": "Bei der Zahlung ist ein Fehler aufgetreten. Bitte versuchen Sie es erneut.",
+  "payFailureInsufficientEth": "Es konnten nicht genügend ETH für die Netzwerkgebühren bereitgestellt werden. Bitte versuchen Sie es später erneut.",
+  "payFailureInsufficientZchf": "Ihr REALU-Bestand reicht für diesen Betrag nicht aus.",
+  "payFailureQuoteExpired": "Das Zahlungsangebot ist abgelaufen. Bitte scannen Sie den Code erneut.",
+  "payFailureSignatureUnsupported": "Diese Wallet kann keine Transaktionen signieren. Wechseln Sie zu einer Software- oder BitBox-Wallet.",
+  "payFailureTitle": "Zahlung fehlgeschlagen",
   "paymentInformationFailed": "Beim Abrufen der Zahlungsinformationen ist ein Fehler aufgetreten.",
   "paymentInformationFailedDescription": "Bitte versuchen Sie es später erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an unseren Support.",
   "payoutAccountAdd": "Auszahlungskonto hinzufügen",
   "payoutAccountSelect": "Auszahlungskonto auswählen",
+  "payPaying": "Zahlung wird gesendet",
+  "payPreparingSwap": "Tausch wird vorbereitet",
+  "payQuoteRequested": "Geforderter Betrag",
+  "payQuoteSummary": "Sie bezahlen ${amount} ${asset}",
+  "payQuoteTitle": "Zahlung bestätigen",
+  "payQuoteUnavailable": "Für diesen Zahlungscode ist keine ZCHF-Zahlung verfügbar.",
+  "payQuoteZchfNeeded": "Benötigte ZCHF",
+  "payRefreshingQuote": "Angebot wird aktualisiert",
+  "payRetryButton": "Zahlung erneut versuchen",
+  "payRetryInsufficientZchf": "Der Preis hat sich geändert und die getauschten ZCHF decken diese Zahlung nicht mehr. Ihre ZCHF bleiben in Ihrer Wallet – versuchen Sie es erneut, um ein neues Angebot zu erhalten.",
+  "payRetryQuoteExpired": "Das Zahlungsangebot ist vor dem Abschluss abgelaufen. Ihre getauschten ZCHF bleiben in Ihrer Wallet – versuchen Sie es erneut, um ein neues Angebot zu erhalten und zu bezahlen.",
+  "payRetryTitle": "Schließen Sie Ihre Zahlung ab",
+  "payRetryTransient": "Die Zahlung konnte nicht abgeschlossen werden, aber Ihre getauschten ZCHF bleiben in Ihrer Wallet. Versuchen Sie es erneut, um ohne erneuten Tausch zu bezahlen.",
+  "payScanInvalid": "Dies ist kein gültiger RealUnit-Zahlungscode.",
+  "payScanTitle": "Zahlungscode scannen",
+  "paySuccess": "Zahlung erfolgreich",
+  "paySuccessDescription": "Ihre Zahlung wurde abgeschlossen.",
+  "paySwapping": "REALU wird in ZCHF getauscht",
+  "payWaitingForEth": "Netzwerkgebühren werden angefordert",
   "pdf": "PDF",
   "pendingTransactions": "Ausstehende Transaktionen",
   "personalData": "Persönliche Daten",
@@ -197,8 +225,8 @@
   "proofDocument": "Nachweis-Dokument",
   "purposeOfPayment": "Verwendungszweck",
   "qrCode": "QR-Code",
-  "realunitStockToken": "RealUnit Aktientoken",
   "realunitStockprice": "RealUnit Aktienkurs",
+  "realunitStockToken": "RealUnit Aktientoken",
   "realunitWallet": "RealUnit Wallet",
   "realunitWalletLogout": "Aus REALU Wallet abmelden",
   "realunitWalletLogoutCheck": "Ich habe meine Wiederherstellungsphrase gesichert.",
@@ -246,18 +274,18 @@
   "sellBitboxCheckingEth": "Wallet-Guthaben wird geprüft",
   "sellBitboxDepositDescription": "Bestätigen Sie auf der BitBox, um ZCHF an die DFX-Einzahlungsadresse zu überweisen.",
   "sellBitboxDepositFrom": "Sie senden",
+  "sellBitboxDepositing": "ZCHF wird gesendet. Bestätigen Sie auf der Bitbox",
   "sellBitboxDepositRetryDescription": "Der Tausch wurde abgeschlossen, aber die ZCHF-Einzahlung konnte nicht gesendet werden. Ihre Mittel sind sicher. Tippen Sie auf Wiederholen.",
   "sellBitboxDepositRetryTitle": "Einzahlung fehlgeschlagen",
   "sellBitboxDepositTitle": "ZCHF an DFX senden",
   "sellBitboxDepositTo": "DFX-Einzahlung",
-  "sellBitboxDepositing": "ZCHF wird gesendet. Bestätigen Sie auf der Bitbox",
   "sellBitboxEthReady": "Wallet bereit",
   "sellBitboxEthReadyDescription": "Ihr Wallet hat genug ETH, um mit dem Verkauf fortzufahren.",
   "sellBitboxSwapDescription": "Bestätigen Sie auf Ihrem BitBox, um REALU über den BrokerBot in ZCHF zu tauschen.",
   "sellBitboxSwapFrom": "Sie senden",
+  "sellBitboxSwapping": "Tausch on-chain. Bestätigen Sie auf der Bitbox.",
   "sellBitboxSwapTitle": "REALU → ZCHF tauschen",
   "sellBitboxSwapTo": "Sie erhalten",
-  "sellBitboxSwapping": "Tausch on-chain. Bestätigen Sie auf der Bitbox.",
   "sellBitboxWaitingForEth": "Gasgebühren werden angefordert",
   "sellBitboxWaitingForEthDescription": "Ein kleiner ETH-Betrag wird an Ihr Wallet gesendet, um die Transaktionsgebühren zu decken. Dies kann einige Minuten dauern.",
   "sellMinAmount": "Mindestbetrag: ${amount} ${currency}",
@@ -282,10 +310,10 @@
   "settingsWalletBackupSubtitle1": "Bitte notieren Sie Ihre 12 Wiederherstellungs-Wörter in der exakten Reihenfolge auf einem Blatt Papier und bewahren Sie sie absolut sicher auf.",
   "settingsWalletBackupSubtitle2": "Dies ist die einzige Möglichkeit, Ihre Wallet wiederherzustellen.",
   "showSeed": "Seed anzeigen",
-  "signMessage": "Signierte Nachricht",
-  "signMessageGet": "Signierte Nachricht abrufen",
   "signature": "Signatur",
   "signingCancelled": "Signatur abgebrochen — bitte BitBox erneut bestätigen",
+  "signMessage": "Signierte Nachricht",
+  "signMessageGet": "Signierte Nachricht abrufen",
   "skip": "Überspringen",
   "softwareTermsText": "Mit der Nutzung dieser App akzeptieren Sie die Nutzungsbedingungen dieser Software.",
   "softwareTermsTextHighlighted": "Nutzungsbedingungen",
@@ -329,9 +357,9 @@
   "transactionBuy": "Kauf",
   "transactionHistory": "Transaktionshistorie",
   "transactionPending": "In Bearbeitung",
+  "transactions": "Transaktionen",
   "transactionSell": "Verkauf",
   "transactionWaitingForPayment": "Warte auf Zahlung",
-  "transactions": "Transaktionen",
   "twoFa": "2-Faktor Authentifizierung",
   "twoFaCodeRequired": "Code ist erforderlich",
   "twoFaCodeTooShort": "Der Code sollte 6 Ziffern lang sein",
@@ -356,4 +384,4 @@
   "youPay": "Sie bezahlen",
   "youReceive": "Sie erhalten",
   "youSell": "Sie verkaufen"
-}
+}

assets/languages/strings_en.arb

@@ -33,8 +33,8 @@
   "buyPaymentConfirmFailedAktionariat": "There is a technical problem. Please check your email inbox — you may still need to confirm your blockchain address. Otherwise, please try again later. If the error persists, contact our support team.",
   "buyPaymentInformation": "Payment information",
   "buyPaymentInformationDescription": "Please transfer the purchase amount using your banking app with these details. The purpose of payment is important!",
-  "buyRealUnit": "Buy RealUnit",
   "buyRealu": "Buy RealUnit Token",
+  "buyRealUnit": "Buy RealUnit",
   "cancel": "Cancel",
   "changeAddress": "Change address",
   "changeInReview": "Change in review",
@@ -53,11 +53,11 @@
   "connectBitboxContent": "Please connect your BitBox with your Smartphone.",
   "connectBitboxContentIos": "Please connect your BitBox with your Smartphone and activate Bluetooth.",
   "connectBitboxFailed": "Something went wrong. Please try to connect again.",
-  "connectBitboxSignInHint": "After verifying the code, the BitBox will ask for one additional confirmation to sign you in.",
   "connectBitboxSignatureCapturing": "Please confirm the sign-in request on your BitBox device. This signature is captured once so future purchases won't need your BitBox again.",
   "connectBitboxSignatureCapturingTitle": "Confirm sign-in",
   "connectBitboxSignatureFailed": "We couldn't capture your sign-in signature. You can retry, or continue anyway – your BitBox may then be needed again for your first purchase.",
   "connectBitboxSignatureFailedTitle": "Sign-in not completed",
+  "connectBitboxSignInHint": "After verifying the code, the BitBox will ask for one additional confirmation to sign you in.",
   "connectBitboxTitle": "Connect BitBox",
   "connected": "Connected",
   "connectedBitboxContent": "Please confirm and follow the last steps on your BitBox.",
@@ -167,10 +167,38 @@
   "or": "Or",
   "originalPdf": "Original PDF",
   "pay": "Pay",
+  "payAwaitingSettlement": "Completing payment",
+  "payConfirmButton": "Pay",
+  "payFailureBitboxRequired": "Please connect your BitBox to continue.",
+  "payFailureGeneric": "Something went wrong with the payment. Please try again.",
+  "payFailureInsufficientEth": "Could not provision enough ETH for network fees. Please try again later.",
+  "payFailureInsufficientZchf": "Your REALU holdings are not enough for this amount.",
+  "payFailureQuoteExpired": "The payment quote expired. Please scan the code again.",
+  "payFailureSignatureUnsupported": "This wallet cannot sign transactions. Switch to a software or BitBox wallet.",
+  "payFailureTitle": "Payment failed",
   "paymentInformationFailed": "An error occurred while getting the payment information.",
   "paymentInformationFailedDescription": "Please try again later. If the error persists, contact our support team.",
   "payoutAccountAdd": "Add payout account",
   "payoutAccountSelect": "Select payout account",
+  "payPaying": "Sending payment",
+  "payPreparingSwap": "Preparing swap",
+  "payQuoteRequested": "Requested amount",
+  "payQuoteSummary": "You pay ${amount} ${asset}",
+  "payQuoteTitle": "Confirm payment",
+  "payQuoteUnavailable": "No ZCHF payment is available for this payment code.",
+  "payQuoteZchfNeeded": "ZCHF needed",
+  "payRefreshingQuote": "Refreshing quote",
+  "payRetryButton": "Retry payment",
+  "payRetryInsufficientZchf": "The price moved and the swapped ZCHF no longer covers this payment. Your ZCHF stays in your wallet — retry to fetch a new quote.",
+  "payRetryQuoteExpired": "The payment quote expired before settling. Your swapped ZCHF stays in your wallet — retry to fetch a new quote and pay.",
+  "payRetryTitle": "Finish your payment",
+  "payRetryTransient": "The payment could not be completed, but your swapped ZCHF stays in your wallet. Retry to pay without swapping again.",
+  "payScanInvalid": "This is not a valid RealUnit payment code.",
+  "payScanTitle": "Scan payment code",
+  "paySuccess": "Payment successful",
+  "paySuccessDescription": "Your payment has been completed.",
+  "paySwapping": "Swapping REALU to ZCHF",
+  "payWaitingForEth": "Requesting network fees",
   "pdf": "PDF",
   "pendingTransactions": "Pending transactions",
   "personalData": "Personal data",
@@ -197,8 +225,8 @@
   "proofDocument": "Proof document",
   "purposeOfPayment": "Purpose of payment",
   "qrCode": "QR code",
-  "realunitStockToken": "RealUnit Stock Token",
   "realunitStockprice": "RealUnit Stockprice",
+  "realunitStockToken": "RealUnit Stock Token",
   "realunitWallet": "RealUnit Wallet",
   "realunitWalletLogout": "Log out of REALU Wallet",
   "realunitWalletLogoutCheck": "I have backed up my recovery phrase.",
@@ -246,18 +274,18 @@
   "sellBitboxCheckingEth": "Checking your wallet balance",
   "sellBitboxDepositDescription": "Confirm on your BitBox to transfer ZCHF to the DFX deposit address.",
   "sellBitboxDepositFrom": "You send",
+  "sellBitboxDepositing": "Sending ZCHF. Please confirm on the Bitbox.",
   "sellBitboxDepositRetryDescription": "The swap was completed but the ZCHF deposit could not be sent. Your funds are safe. Tap retry to try again.",
   "sellBitboxDepositRetryTitle": "Deposit failed",
   "sellBitboxDepositTitle": "Send ZCHF to DFX",
   "sellBitboxDepositTo": "DFX deposit",
-  "sellBitboxDepositing": "Sending ZCHF. Please confirm on the Bitbox.",
   "sellBitboxEthReady": "Wallet ready",
   "sellBitboxEthReadyDescription": "Your wallet has enough ETH to proceed with the sale.",
   "sellBitboxSwapDescription": "Confirm on your BitBox to swap REALU for ZCHF via the BrokerBot.",
   "sellBitboxSwapFrom": "You send",
+  "sellBitboxSwapping": "Swapping on-chain. Please confirm on the Bitbox.",
   "sellBitboxSwapTitle": "Swap REALU → ZCHF",
   "sellBitboxSwapTo": "You receive",
-  "sellBitboxSwapping": "Swapping on-chain. Please confirm on the Bitbox.",
   "sellBitboxWaitingForEth": "Requesting gas funds",
   "sellBitboxWaitingForEthDescription": "A small amount of ETH is being sent to your wallet to cover transaction fees. This may take a few minutes.",
   "sellMinAmount": "Minimum amount: ${amount} ${currency}",
@@ -282,10 +310,10 @@
   "settingsWalletBackupSubtitle1": "Please write down your 12 recovery words in the exact order on a piece of paper and keep them in a completely safe place.",
   "settingsWalletBackupSubtitle2": "This is the only way to recover your wallet.",
   "showSeed": "Show Seed",
-  "signMessage": "Sign Message",
-  "signMessageGet": "Get Sign Message",
   "signature": "Signature",
   "signingCancelled": "Signature cancelled — please confirm on the BitBox again",
+  "signMessage": "Sign Message",
+  "signMessageGet": "Get Sign Message",
   "skip": "Skip",
   "softwareTermsText": "By using this app, you accept the terms of use of this software.",
   "softwareTermsTextHighlighted": "terms of use",
@@ -329,9 +357,9 @@
   "transactionBuy": "Buy",
   "transactionHistory": "Transaction history",
   "transactionPending": "Processing",
+  "transactions": "Transactions",
   "transactionSell": "Sell",
   "transactionWaitingForPayment": "Waiting for payment",
-  "transactions": "Transactions",
   "twoFa": "Two-factor authentication",
   "twoFaCodeRequired": "Code is required",
   "twoFaCodeTooShort": "Code should be 6 digits",
@@ -356,4 +384,4 @@
   "youPay": "You pay",
   "youReceive": "You receive",
   "youSell": "You sell"
-}
+}

ios/Runner/Info.plist

@@ -44,7 +44,7 @@
 		<key>LSRequiresIPhoneOS</key>
 		<true/>
 		<key>NSCameraUsageDescription</key>
-		<string>This app needs camera access to verify your identity</string>
+		<string>This app needs camera access to verify your identity and to scan payment codes</string>
 		<key>NSLocationWhenInUseUsageDescription</key>
 		<string>Please provide us with your geolocation data to prove your current location</string>
 		<key>NSMicrophoneUsageDescription</key>

lib/packages/service/dfx/exceptions/payment/pay_exceptions.dart

@@ -0,0 +1,27 @@
+// Typed failures for the OCP pay flow (scan → swap → pay). Each one renders a
+// human-readable string (see `exception_surface_test.dart`) so it can surface
+// cleanly in logs, Sentry, and user-facing error states instead of the Dart
+// default `Instance of '...'`.
+
+/// The scanned QR / pasted code is not a DFX Open CryptoPay payment link.
+class InvalidPaymentLinkException implements Exception {
+  final String reason;
+
+  const InvalidPaymentLinkException(this.reason);
+
+  @override
+  String toString() => 'InvalidPaymentLinkException: $reason';
+}
+
+/// The loaded wallet cannot produce EIP-1559 signatures (today: the debug
+/// wallet). The pay flow needs to sign the swap and pay transactions locally,
+/// so it cannot proceed in this wallet mode.
+class PaySignatureUnsupportedException implements Exception {
+  // Only ever thrown / constructed as a const expression, so the zero-arg
+  // body never registers a runtime line hit; toString() below is exercised.
+  const PaySignatureUnsupportedException(); // coverage:ignore-line
+
+  @override
+  String toString() =>
+      'PaySignatureUnsupportedException: this wallet mode cannot sign transactions';
+}