For developers

For businesses

Mission

Product

Resources

About

Team

Blog

Docs

Research

Partners

Sign in

Sign up

For developers

For businesses

Mission

Product

Resources

About

Team

Blog

Docs

Research

Partners

Sign in

Sign up

Previous

Whitelabelled email notifications and transaction/KYX updates

Next

Aug 22, 2025

📬 Feature: Whitelabelling for email notifications

It is now possible to customize certain parameters for the transaction receipt emails that get sent to your customers:

  • Sender name (e.g. “Company Support”)

  • Sender email alias (e.g. example@noreply.fernhq.com)

  • Logo shown in the email (taken from your branding configuration)

If you would like to customize email notifications that go to your customers, please reach out with your desired “Sender name” and “Email alias” and we’ll get it set up for you.

🌎 Transactions

  • Minimum amounts are now enforced:

    • SWIFT transfers: $1,000

    • NGN onramps: $5 USD

    • BRL onramps: 10 BRL (TED) / $10 USD (PIX)

  • BRL onramps + offramps: We were experiencing issues with BRL onramps, but these have now been fixed and are now fully live in production (but note minimum amounts above)

  • Incoming crypto transactions: Incoming crypto transactions into Fern wallets are now recorded as part of the transactions on the customer

  • Transaction expiry added to all transactions

🛡️ KYC / KYB API Updates

  • Document requirements

    • Uploaded image rules: size must be >10kb & <5mb

      • Images must be ≥200x200 pixels

    • KYC document requirements have been reverted back to 1 document minimum (proof of address is now optional)

    • If a Proof of Address has been submitted, it must have sub-type BANK_STATEMENT

    • Error messages improved for document-required fields

  • Schema validation improvements

    • DOB must be ≥18 years

    • SSN format checks for US IDs

  • Nationality

    • nationality is now a required field in the KYC API

    • nationalIdIssuingCountry is used to determine the valid nationalIdType options for the customer

    • nationalIdNumber is enforced on the KYC API, and taxIdNumber will soon be deprecated

  • Phone numbers must follow E.164 format

  • KYB API improvements (still in beta, use at your own risk! breaking changes may come next week)

    • Controller and UBOs merged for simplicity under the single concept of associated persons

    • Business industries now accept NAICS codes

  • Breaking change: Added verificationLink in the Customer schema (deprecated kycLink)

⚡️ Upcoming Platform Features

  • Solana support shipping next week

  • Successful customer PATCH requests that end up completing a customer’s KYC or KYB data requirements will trigger verifications (currently they do not)