Transaction Format Settings

These settings allow you to configure the methods for submitting transactions to the payment gateway.

• Partial Authorization – indicate whether or not your website can accept partial authorization payments.

Partial Authorization

The payment gateway has added support for partial authorizations for debit cards and prepaid cards for these card types, for U.S. transactions only:

• MasterCard

• Discover

• Diners Club

• JCB

• American Express

• Visa

If the balance on the prepaid card is less than the order amount, you can accept multiple forms of payment for the order: some or all of the amount on the card in addition to one or more different payment methods.

How a Partial Authorization Works

1. You submit an authorization request or a capture request for a prepaid card.

2. The authorization reply message lets you know that only a partial amount was approved because the balance on the card is not enough to cover the entire order amount. The reply message includes:

   • The amount you requested

   • The amount that was authorized, which is the amount available on the card

   • A value called the Order ID (also called splitTenderId in AIM and SIM) that you can use to link this authorization request to subsequent transactions

   You can also receive balance information for partially-approved and fully-approved requests.

   Note: All transactions are put in a hold state until the final transaction is received.  This is a transaction with an order ID, where the amount requested equals the amount approved.  At this point all transactions associated with the order ID will be released from the hold state and will be returned to the original state (Auth Only or Auth Capture).

   If the transaction is sent in as an Auth Only, you will have to submit the capture request when you are ready to settle the transactions. You can release all transactions associated with the order ID by sending a Prior_Auth_Capture request. This type of request is the same as the existing prior auth capture request, except the order ID is used instead of the transaction ID.

3. If you decide not to capture the partial authorization, you should request a void. A void request can be used to cancel the SplitTender group. This type of request is the same as the existing void request except the order ID is used instead of the transaction ID.

4. You can use one or more different payment methods for the rest of the order amount.

For partial authorizations to work correctly, you must make adjustments to your website, to allow for new fields.

Opting In

You must opt in to be able to receive and capture partial authorizations. There are two ways to opt in:

• You can turn on the Partial Authorization feature in the Transaction Settings section of your Merchant Interface (this page). By doing this, you are verifying that you are able to process partial authorization transactions.

• You can include a new API field in your initial authorization or authorization+capture request that enables partial authorization for that specific request.