Enabling Crypto in Fundraise Up with Gemini

Enabling Crypto with Gemini allows donors to donate cryptocurrency easily, providing simple donation management and automatic receipting.


As part of preparing to accept cryptocurrency donations, you will need to have an account with a cryptocurrency exchange such as Gemini or Coinbase Commerce. Please speak with your Success team for recommendations on processors and the process of expedited account setup. This account will allow you to process and hold cryptocurrency donations. 

It's also worth being aware that the available crypto processor accounts at this time do not offer automatic deduction of our platform costs. As such, Fundraise Up's platform fees for processing crypto donations will be invoiced from your organization at the end of any timespan where you received crypto donations, rather than immediately.

Connecting Gemini

Please note that Gemini accounts used with The Giving Block are restricted; they do not allow direct login and connection to other platforms.

If you have such an account, we recommend either getting a Coinbase Commerce account or new Gemini account for use with Fundraise Up and any other providers.

If your account is a Gemini nonprofit account, connecting it to Fundraise Up can be done by making an API key, a process we outline here:

First, you'll want to log into your Gemini account, click on Account in the top right, and choose the option to go to your Settings page. 

From there, click the API option in the left-hand menu. Here, if you haven't already made an API key for Fundraise Up usage, you'll want to click the Create a New API Key button. You can either make the key "Master" or "Primary"; "Primary" is sufficient for the payment connector's purposes.

Screen Shot 2022-07-29 at 9.47.07 AM

API key settings

Screen Shot 2022-07-29 at 9.48.01 AM

Name: Use a clear and logical name like "Fundraise Up API key" so that it's clear that the API key is used with your Fundraise Up account.

API key settings: Select the option for "Fund management." To limit the scope of access for the API key, we recommend leaving all other options unselected.

Do not select the "Uses a time based nonce" API key setting for the API key you use to connect Gemini to Fundraise Up. The option is not compatible with the integration.

Adding your Gemini API key and secret in Fundraise Up

Last but not least, log into your Fundraise Up account, click on your organization's name in the top right, choose Settings in the menu, and click Payment Options in the left-hand menu. From here, you can click to connect a crypto processor, and enter your Gemini API Key and API Secret you copied into the connection screen. 


Choosing which campaigns accept crypto

Once you've connected a crypto processor and enabled cryptocurrency as a payment option for your account, you'll want to choose which Fundraise Up campaigns offer cryptocurrency donations as a checkout option. 

To do so, click the Campaigns option in the top bar, then click on any campaign you'd like to edit. In the edit options under checkout, click Payment Options, then check the box to accept cryptocurrency donations into this campaign specifically, and click the Save Changes button at the bottom.

Screen Shot 2022-08-31 at 9.24.16 AM

Once you've done so, donors opening up checkout for this campaign will have the option to donate cryptocurrency instead of standard (or "fiat") currency.

Please be aware that, if cryptocurrency is the default payment option for a campaign, "form"-style elements (Donation Form, Simple Form, Impact Slider) will not be available for that campaign, as the amount controls inherent to those elements are designed around donations of standard currency.

You can, however, use Donate Button elements to open campaigns that have cryptocurrency as the default payment option!


Understanding the crypto checkout process

Screen Shot 2022-08-08 at 12.32.58 PMMaking their donation

Donors who arrive in cryptocurrency donation checkout will see options to choose which currency (and exchange) they are donating, and then an amount field.

As donors enter an amount of their cryptocurrency of choice, they'll be shown a live estimate of the approximate value of that amount of cryptocurrency in your account's default standard currency - USD for US accounts, GBP for UK accounts, etc.

When the donor has chosen how much they'd like to give and clicks Donate, they'll be taken to provide the personal information they'd like to associate with this donation, skipping past the "payment option" screen as it is unnecessary in this flow.

Screen Shot 2022-08-09 at 9.10.58 AMAfter that, the donor will be shown all required and optional personal information fields, including custom questions if present on the campaign. They will be able to skip optional fields if desired.

Once the donor has provided their personal information, they'll be taken to a screen of checkout which offers them a QR code and a button.

  • Donors who have a crypto app on their phone can scan the QR code, which should auto-open their app of choice and take them right to a transfer screen where they can finalize the amount/currency they want to send to your organization.
  • Donors who prefer to make crypto transfers from a website can instead use the "Copy wallet address" button to copy the wallet ID where they should send their cryptocurrency, which they can paste into their website of choice while making the transfer.

Once a donor has initiated the transfer, the screen will remain open to this QR code/"Copy wallet address" button screen until it receives enough confirmations on the blockchain that it's for sure going to go through, at which time the screen will auto-advance to the campaign's Thank You screen of checkout.

Reviewing their donation later

Given that crypto donations are at this time only a one-time donation method, donors will receive the "One time receipt" email template if enabled when their donation succeeds.

If PDF receipts are enabled the donor will, as would be appropriate with any in-kind donation method, receive a PDF receipt which lists out the amount in the specific cryptocurrency they donated, as well as the date and time they donated. 

This way, each donor can responsibly report the value of their donation to the tax service in your operating country rather than having the reported amount proscribed due to an estimate on a receipt.

Donors accessing Donor Portal will be able to see both the amount they gave and the approximate estimated converted value of the amount they gave.

Screen Shot 2022-08-12 at 8.54.59 AM


Managing incoming crypto donations

In the Fundraise Up dashboard

Within your Fundraise Up dashboard and Insights tab, crypto donations will appear much like any other donation in any currency aside from your default one; in granular views, each donation will show the original cryptocurrency and amount donated, but in summaries, the dashboard will show the approximate amount in your default currency that donation would have been if sold immediately upon arrival.

Screen Shot 2022-08-12 at 8.39.12 AM

On donation record pages themselves, you can see more details about the payment method used, the specific cryptocurrency and amount provided, the name of the processor, and the ID of the payment transaction in the processor's system. All of that information is exportable and usable in CRM integration mapping rules as well.

In your processor account's wallet

As your donors start to make crypto donations, their donated assets will accrue in your payment processor account's wallet, in exactly the cryptocurrency and amount they provided. 

Depending on the processor used, there may not be a clear indication that the wallet address used for a transaction was generated from Fundraise Up. As such, you may want to cross-reference Fundraise Up donation records, exports, or synced data to your CRM of choice to triage which donations came from Fundraise Up crypto checkout.

While we may add a setting later to allow the automatic liquidation of these donated assets, for now, if the sale of these assets for fiat currency is desired, at this time that should be manually done by a member of your staff logging into your wallet and initiating such a sale. 

In exports 

Similar to the Fundraise Up interface, we will retain the flexibility in exports of treating crypto donations like any other donation in a currency other than your default currency wherever possible.

So, in exports, "Donation Amount" and "Donation Currency" will always show the actual amount in the cryptocurrency provided, whereas "Converted Donation Amount" (and any "Converted" column) will show the value in your default currency as of the time of donation.

Screen Shot 2022-08-12 at 8.46.05 AM

In CRM and marketing integrations

In any sync to an external system, our behavior will be governed by what degree of multi-currency support is present; as such, given that the majority of CRMs do not offer currency selectors with the full gamut of cryptocurrencies, we will err on the side of writing the converted donation amount into the amount field.

You will still always have the offramp of mapping "payment method" to an appropriate field (if not done automatically to such a standard field by the CRM integration) so that you can easily filter on and locate crypto donations specifically.