Skip to main content

Stripe Error Messages

Learn how to identify and fix common Stripe error messages that may appear when processing transactions or recurring payments.

Cristina Gruita avatar
Written by Cristina Gruita
Updated over 2 months ago

These errors typically relate to account configuration, card details, or payment gateway rules.


Statement Descriptor Too Long

Error:
Payment was not collected… The statement descriptor must be at most 22 characters. XXXXXXX is XX characters long.”

How to fix it:

  1. Navigate to Settings, click Configuration, select Stripe Connect.

  2. Shorten the Statement Text to fewer than 22 characters.

  3. Click Update to save your changes.


Invalid Card Number on an RPI

Error:
“Problem collecting payment… Card Number is invalid.”

This means the card originally used for the Recurring Payment Instruction (RPI) has been updated or replaced.

How to resolve:

  1. Identify the last four digits originally used to lodge the payment intent.
    This appears in CollectionReference2 in the Charge Log or via an RPI List.

  2. Obtain the new last four digits from the donor.

  3. Contact Donorfy Support to request an update to the CollectionReference2 field.
    This field cannot be edited manually by users.

  4. Inform the donor and take any missed payment as an ad-hoc transaction using the Stripe terminal.

  5. Add the payment to the constituent’s timeline and link it to the RPI.


Card Declined

Error:
“Payment was not collected… Your card was declined.”

This may be temporary or may indicate that the card has been replaced.

How to resolve:

  1. Contact the donor to confirm why the card was declined.

  2. Update the card details directly in Stripe.

  3. Amend the RPI in Donorfy using the same process as the invalid card number fix.

If the only issue was a recently replaced card, updating the card details in Stripe and adjusting the RPI will resolve the error.


Stripe Account Not Live

Error:
“This connected account cannot currently make live charges… Your transaction has not been processed.”

How to resolve:

  1. Log in to your Stripe dashboard.

  2. Ensure your account is:

    • Fully configured

    • Fully verified

    • Set to live mode

  3. Complete any additional steps requested by Stripe for new accounts.

  4. Retry the transaction once your account is fully enabled.

Did this answer your question?