Component updates effective October 1st
Rainforest will be releasing changes to the Payment Component and Merchant Onboarding Component on October 1st, 2025 to better enhance your end users' and merchants' experience.
Payment Component
Card payments

Postal code always displayed
The Payment Component will always display the postal code field, regardless of the postal code being provided in the Payin Config. If it's provided in the Payin Config, then it will be pre-filled in the Payment Component.
Previously, if the postal code was provided in the Payin Config, then the postal code field was not visible. If the incorrect postal code was provided, then the end user could not correct this when processing their payment. Ultimately, this could result in lower approval rates if the card networks took into account the AVS check.
This change will positively impact the AVS check with the card networks as it will ensure the end user is providing the postal code associated with their card number and result in higher approval rates.
ACH payments

Name always displayed
The Payment Component will always display the name field, regardless of the name being provided in the Payin Config. If it's provided in the Payin Config, then it will be pre-filled in the Payment Component.
Previously, if the name was provided in the Payin Config, then the name field was not visible. If the incorrect name was provided, then the end user could not correct this information when processing their payment. Ultimately, this could result in an ACH Return due to the name of the account holder not accurately matching the name on file with the bank.
This change will positively impact ACH processing ensuring the name provided by the end user matches the name on file with their bank.
Account type selector
The Payment Component will now include the ability for the end user to choose the account type of Checking or Savings.
The account type will be set to Checking by default when rendering the Payment Component. To change the default to Savings, add the field-defaults
prop and set it to the following:
<rainforest-payment
session-key='REPLACE_ME'
payin-config-id='REPLACE_ME'
allowed-methods='CARD,ACH'
+ field-defaults='{"ach": {"account_type": "SAVINGS"}}'
></rainforest-payment>
Merchant Onboarding Component
Validated ACH (Plaid) as a deposit method
The Merchant Onboarding Component will automatically enable the validated ACH flow, where the merchant can connect to their online bank account to collect the bank information. Rainforest utilizes a third-partner, Plaid, for real-time validation.

Real-time bank account validation makes onboarding faster and more reliable by:
- Reducing data entry errors when a merchant enters their routing or account number
- Reducing friction to complete the application, because bank login credentials are generally known or saved versus the routing and account number
- Enabling Rainforest to quickly identify the owner of the account reducing the potential for documentation requests after the submission of the application
This change will no longer require Rainforest to enable this feature for your integration. To ensure your integration supports validated ACH deposit methods, see our Validated ACH in merchant onboarding guide.
Disable validated ACH
If you do not want to support the validated ACH flow, then a new allowed-deposit-methods
prop can be set to only ACH
.

<rainforest-merchant-onboarding
session-key="REPLACE_ME"
merchant-id="REPLACE_ME"
merchant-application-id="REPLACE_ME"
+ allowed-deposit-methods='ACH'
></rainforest-merchant-onboarding>
Please contact support if you have any questions.