What is the correct scenario of accepting one-time/recurring payments by API ?

Emily Cray

Hi there ?

I am going to create an HTML page where I will accept one-time or recurring payments.

I have already understood the checkout process and transaction checkout. Also I have reviewed the Gift endpoints.

But I do not understand the following things:

1. what are the correct steps to accept payment in Blackbaud via API ? First, obtain the transaction token, then checkout transaction and finally create Gift. Right ?
2. how I can store the donor's card data for recurring payments ? What API endpoint to use ?
3. how I can create automatic recurring payments via API ?

Thanks in advance ?‍♂️

Mina Mistry

Good morning Emily!


When you invoke Blackbaud Checkout on your web page, you should pass a value in the card_token field.  Blackbaud Checkout will tokenize the payment information using that card_token value so you can use that same card_token for future recurring payments.


It sounds like you are also trying to set up an automated recurring gift in Raiser's Edge NXT via the Gift API, so that future payments would be triggered automatically from your RE NXT application?  If that is correct, you are on the right path in looking at the Gift endpoint you referenced in your post.  Once the Checkout transaction is complete, you can use the Gift endpoint to create the gift record in RE NXT.  This endpoint will accept the card_token created above so that the same payment method can be charged for future payments.


Let us know if you have any further questions!

Emily Cray

Mina Mistry:

Good morning Emily!


When you invoke Blackbaud Checkout on your web page, you should pass a value in the card_token field.  Blackbaud Checkout will tokenize the payment information using that card_token value so you can use that same card_token for future recurring payments.


It sounds like you are also trying to set up an automated recurring gift in Raiser's Edge NXT via the Gift API, so that future payments would be triggered automatically from your RE NXT application?  If that is correct, you are on the right path in looking at the Gift endpoint you referenced in your post.  Once the Checkout transaction is complete, you can use the Gift endpoint to create the gift record in RE NXT.  This endpoint will accept the card_token created above so that the same payment method can be charged for future payments.


Let us know if you have any further questions!

Hey Mina, thanks for your response ! Do you know why POST Gift returns 500 error ? Please check the screenshot:


 

Mina Mistry

Hi Emily


Sorry to see you're running into that issue with the Gift API.  To confirm, the Gift API is intended to be used with RE NXT only.  The error message you are seeing can occur when the customer environment you are connecting to does not have RE NXT (we are already working on improving that error message for more clarity).


Thanks

Mina

Emily Cray

Hi Mina ! I have full access to the environment (pic-1) and environment has connected app "Sky API Console" (pic-2). It is RE NXT, right ?

Then I pass authorisation and get the Authorization token (pic-3). But API still responds with 500 error says "The SKY API service is currently unavailable" (pic-4).

What else can I do to create test Gift via API ? Please help !









 

Alexia Chapparone

Hi Emily,


Could you give a high-level overview of the application that you are connecting the Payments API to and its features? The Gift API discussed below is used for customers integrating transactions into Raiser's Edge NXT (RENXT). It doesn't seem that the customer you are working with uses RENXT, so the Gift API will not be available, hence the 500 error. 


Let me know what you're looking to accomplish!


Thanks,

Alexia