How to detect recurring gift failed and direct user to re-enter their credit card details?

Nathan Wells

I see I can have a user update their credit card info via the Blackbaud Checkout:

But how would I detect that the constituent needs to update their credit card information and then send them to our custom page with the Update Card Info Blackbaud Checkout integration?

Thanks!

Mina Mistry

Hi Nathan

There could be several approaches you can consider based on your specific requirements. The most obvious is if the card fails to process successfully (perhaps on multiple occasions or if it fails and you see the expiry date has passed).

When you use the Payments API to process the gift, the response object will indicate when the payment has failed and the reason for the failure. You could test out these responses using the test cards which can help simulate different scenarios.

Thanks

Mina

Nathan Wells

Thanks @Mina Mistry
I failed to state my questions was about recurring gifts. How to we detect when a user's credit card has expired so we can direct them to their user portal to update their recurring gift credit card info or detect if their recurring gift failed for some other reason?

Mina Mistry

Hi Nathan

If your organization is enrolled in the Credit Card Updater service, Blackbaud Merchant Services will automatically update any expired cards that are stored in our vault on a regular basis. You can contact Support to confirm if this service is enabled on your account.

If you wish to check any individual card, the GET Card endpoint will return details including the expiry date for any existing card token.

Thanks!

Mina

Nathan Wells

Thanks @Mina Mistry We are enrolled. But I'm still wondering how we can control contacting a constituent when their recurring payment method fails. It might even be something outside the API, I'm not sure. Do you know? Or know where I might find out that information?