authorize_only attribute on transaction

Lauren White

Hello, I'd like to set up a system to delay charging a card. We'd like to collect and store the card token data but not make a charge.

I'm looking at the documentation here:

And I see a flag called authorize_only. Is this attribute intended for this use case?

Lauren White

For context, we'd use the BBMS payment form on the front end.

Mina Mistry

Hi Lauren

To store a card, you can use the StoreCardInfo method of Blackbaud Checkout that will give you a token. This will not perform any authorizations on the card. There is a similar method for storing a direct debit account.

Supported transactions - SKY API (blackbaud.com)

The authorize_only parameter is used when you want to authorize a payment on that card (i.e. the cardholder will see a pending charge) but not charge until a later date.

Lauren White

@Mina Mistry Hi Mina, thanks so much - that's very helpful. I appreciate it.

One follow up question:

On the backend, after the transaction token is received, what Payments api endpoint needs to be called to finalize storing of the card data? I tried this endpoint (CreateCheckoutTransaction) with an amount of zero but that didn't work and I didn't see any paramaters that suggest saving a card for future use.

Mina Mistry

Using StoreCardInfo doesn't require any separate “finalize” calls. The card_token parameter will be used to store the card information.