fix: map non-prefixed payment method IDs in Transak translation

[meltingice1337]

Explanation

Transak Native deposits were failing on staging/UAT with a 400 response and the error message paymentMethod is required parameter.

The root cause is in TransakService.normalizePaymentMethodForTranslation (in @metamask/ramps-controller). The translation endpoint only understands deposit-format payment method IDs (e.g. apple_pay), so the service maps canonical ramps IDs to that format via the RAMPS_TO_DEPOSIT_PAYMENT_METHOD lookup. However, that lookup was keyed only on the /payments/-prefixed form (e.g. /payments/apple-pay). When a canonical ID arrived without the prefix (e.g. apple-pay), it missed the map and was forwarded to the translation endpoint unchanged. The endpoint doesn't recognize that value, returns no usable paymentMethod, and the downstream deposit call fails with paymentMethod is required parameter.

The fix updates normalizePaymentMethodForTranslation to accept both forms: before falling back to passing the input through untouched, it now also tries the /payments/-prefixed variant of the input against the lookup. So both apple-pay and /payments/apple-pay resolve to apple_pay, while values already in deposit format (e.g. credit_debit_card) still pass through unchanged.

This helper feeds every Transak translation call (getBuyQuote, createOrder, getUserLimits, confirmPayment, getTranslation), so the fix applies uniformly across the deposit flow. The change is purely additive — it only broadens the set of accepted inputs and does not alter behavior for inputs that already worked, so it is not a breaking change.

Before:

ScreenRecording_06-03-2026.11-09-06_1.mp4

After:

ScreenRecording_06-03-2026.11-06-27_1.mp4

References

• Fixes TRAM-3610
• Follow-up (separate, in the mobile app repo): bump @metamask/ramps-controller to adopt this fix.

Checklist

• I've updated the test suite for new or updated code as appropriate
• I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
• I've communicated my changes to consumers by updating changelogs for packages I've changed
• I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

---

Note

Low Risk
Small, additive lookup change in payment method normalization with tests; no auth or breaking API changes.

Overview
Fixes Transak Native deposits on staging/UAT that failed with paymentMethod is required parameter when callers passed canonical payment method IDs without the /payments/ prefix (e.g. apple-pay).

normalizePaymentMethodForTranslation in TransakService now resolves both unprefixed and /payments/… canonical IDs to deposit-format values (e.g. apple_pay) before the native translate call; prefixed inputs and values already in deposit format behave as before. A unit test covers the unprefixed case; the changelog documents the fix.

^{Reviewed by Cursor Bugbot for commit c4a1c57. Bugbot is set up for automated code reviews on this repo. Configure here.}