Move recurring gifts from Donorbox
Updated 4 days ago
Move your Donorbox recurring giving to Gratona while preserving amounts and collection dates. First identify the connected processor: using the same Stripe account can avoid a payment-method transfer.
Before you begin
This guide covers what is specific to Donorbox. The shared steps are in the migration overview; have these in place first:
Onboarding path chosen. Growth plans and above require guided or white-glove onboarding. “Migration coordinator” below means your organization’s lead or the Gratona owner named in your onboarding plan; use their email in the samples.
Donor emails paused with the email pause instructions, before any records are imported.
Do step 1 below before you connect Stripe to Gratona, because the account Donorbox already uses is usually the one to connect. Existing collections keep running until the approved switch.
1. Check the connected processor
In Donorbox, open Settings → Payment Processors. Donorbox supports Stripe, PayPal or both. For Stripe, note the live account ID beginning with acct_ and use that account when connecting Stripe to Gratona, as in Prepare payments for your migration. If Gratona already has a Stripe connection, compare the account IDs first.
2. Follow the route for your account
Current setup | Next step |
|---|---|
Donorbox and Gratona use the same Stripe account | Connect the existing account to Gratona. Check access to the existing customers and saved payment methods, then prepare the recurring gifts. No token-copy request is needed. |
Donorbox and Gratona use different Stripe accounts | First consider using the existing account. If a different destination is required, arrange a Stripe account copy and reconcile the returned customer and payment-method IDs. |
PayPal recurring gifts | Review the PayPal agreements separately. Reusing a Stripe account does not bring PayPal payment methods or billing agreements into Stripe. For collection through Gratona’s Stripe connection, prepare a donor payment-setup request. |
Both Stripe and PayPal | Separate the plans by processor and apply the appropriate route to each group. |
Keep the existing Donorbox connection active during preparation. Donorbox says disconnecting its Stripe account prevents plans tied to that account from processing.
Message to your account administrator
Hi [name],
Please connect the Stripe account you use with Donorbox to Gratona and send me its account ID (acct_…). Do you also have recurring gifts through PayPal?
Thanks,
[migration coordinator]
Use this message when Gratona does not yet have a Stripe connection. If both platforms are already connected, compare their account IDs instead.
Stripe copy or external processor import?
Same Stripe account: neither a PGP key nor SFTP is involved.
Different Stripe accounts: follow Stripe’s account-copy instructions and complete the account-owner approvals. Confirm which saved methods are eligible and reconcile the destination IDs.
A processor outside Stripe: only this route uses Stripe’s public PGP key and Stripe’s case-specific SFTP instructions. If your provider identifies it, use the external-provider request sample and the request, upload and review steps.
None of these routes makes PayPal billing agreements transferable to Stripe.
3. Bring over the recurring-gift details
Sharing a Stripe account gives the receiving integration access to the permitted payment data. It does not by itself recreate Donorbox’s recurring plans in Gratona, or move Donorbox’s plan management; on every route, the recurring schedules are prepared separately.
Review the available Stripe and Donorbox records first. For each active gift, identify the donor, payment reference, amount, currency, frequency, next charge date and designation. Add sponsorship allocations where needed. If those plan details are not available through the existing records or account access, export them from Donorbox.
Open Recurring Plans in Donorbox.
Filter the plans for the group being moved.
Click Export and select all columns.
Upload the file to the private Gratona Space shared with your team.
This report supplies the schedule and designation information; it is not a payment-token transfer. A general list of every donor is unnecessary for this step.
Message when the plan export is needed
Hi [name],
Please export the active recurring plans from Donorbox: Recurring Plans → Export → All columns. Upload the file to our shared Gratona Space.
Please include the sponsorship breakdown for any gift covering more than one child.
Thanks,
[migration coordinator]
For any ACH import requested as part of a different route, review the notification and mandate requirements in the payment-import review in Prepare payments for your migration before approval. Gratona’s email switch does not control Stripe notifications.
4. Prepare the collection dates
Match the donors and payment methods, then review the amounts and next dates. For each group, record the last Donorbox collection and first Gratona collection.
Follow Launch and hand over your migration for the order: collection readiness is confirmed, with Gratona’s confirmation for any historical imports; the corresponding Donorbox plans are paused or cancelled; then their replacement schedules are enabled. Account for any pending payments or retries. How you stop a plan depends on its processor:
Plan type | How to stop it |
|---|---|
Stripe plans | Use Donorbox’s pause and cancel controls under Recurring Plans. |
PayPal plans | An administrator cancels the billing agreement in PayPal and then updates its Donorbox status. Changing the status in Donorbox alone does not stop PayPal charges. |
Confirm the schedule handoff
Keep one row per recurring plan with its Donorbox reference, Stripe customer/payment reference, donor, amount, currency, frequency, next date, designation, last source collection and first Gratona collection. Compare the active-plan count and recurring totals by frequency before moving each group.
Message after a group is ready
Hi [name],
The [group] recurring gifts are ready for the switch on [date]. Please cancel the Donorbox plans in the attached approved list before their replacement collections begin, and send the plans that still have a pending payment or retry.
Thanks,
[migration coordinator]
Use this message after the migration lead has reviewed and approved the group and its collection readiness is confirmed. Then confirm the first actual collections and receipts against the approved list, and resolve any failures individually.
Donorbox references
Continue in Gratona
Complete the switch in step 4 for each group.
Use the receipt instructions to review and activate only the approved messages.
Keep the recurring-plan report and stopped-schedule confirmation in your migration record. If a Stripe account copy was needed, retain its destination-ID mapping too.