Auth vs. Auth and Capture
X-Payments Cloud can handle order payments as one of the two following transaction types:
Auth: At the time of payment, the customer's card is checked for validity/availability of funds, but the customer's account is not charged until the order is approved and invoiced. A separate Capture transaction is required to charge the customer's account.
Auth and Capture: The customer's card is charged at the time of order submission: authorization is immediately followed by automatic capture, and there is no need to capture the funds manually.
Not all payment gateways support both the said transaction types; for some payment gateways, only the Auth and capture type is supported. If your preferred payment gateway supports both the transaction types, you can specify the transaction type you want to use for order payments on the payment configuration details page:
Go to the Payment processing page (Settings -> Payment processing) and locate the payment configuration for which you require to set the transaction type. Open the details of this payment configuration for viewing/editing.
On the Payment configuration details page, adjust the Initial transaction setting to either Auth or Auth and capture:
Save your changes.
Enable Auth-Only Transactions and Manual Capture
Depending on the type of order fulfillment process used by your store, you may choose to configure X-Payments in such a way that order payments from your customers will happen in the Auth mode (as opposed to Auth and capture). Auth (Auth-only) mode means that the capture of funds from your buyers' accounts will not happen automatically at the time of order payment. Instead, the customer's card will be checked for validity and availability of funds, but no money will change hands. To get the money, you will need to capture the funds manually at a later time.
To enable Auth-only transactions with manual capture:
Go to the Payment processing page (Settings -> Payment processing) and locate the payment configuration for which you wish to enable Auth-only transactions with manual capture. Open the details of this payment configuration for viewing/editing.
On the Payment configuration details page, adjust the Initial transaction setting to Auth:
Save the changes.
Do a Manual Capture
After a payment transaction is performed in the Auth mode, the payment status of the respective order is set to "Authorized". It means that authorization for the order amount has been obtained, but the payment has not yet been completed (The money is still in your customer's account). To get the money from your customer, you need to capture the transaction.
A capture can be done:
via the admin panel of your online store (in the case of X-Cart, via the Admin area);
via the X-Payments Cloud admin panel.
Please note that the ability to capture funds for multiple orders at once (bulk capture) is currently available only via the X-Cart Admin area (not available via the X-Payments Cloud admin panel).
For instructions on doing a manual capture via the X-Cart Admin area, see the section Capturing Authorized Payments (X-Payments Cloud).
The current article provides instructions for doing a manual capture via the X-Payments Cloud admin panel:
This method can be used for capturing funds for a single order payment. This method does not allow you to adjust the amount for capture.
To do a capture, follow the steps below:
In the list of payments on the Payments page, locate the payment for which you need to do a capture. Obviously, this needs to be a previously authorized payment.
Click on the Capture button displayed next to the payment status. For example, to capture $54.53 for the payment 60137553979 (order 000025-9FKZ), we will need to use this button:
Note that if we have payments for which we have previously done a partial capture, those payments will be shown on the payments list as having the status "Captured", but they will still have a Capture button for them.
For such payments, clicking the Capture button will result in capturing not the entire payment amount but just the amount left to capture.
Once you have clicked the Capture button for your chosen payment, X-Payments Cloud will submit a capture request to the payment processor. Provided that this request is approved, the capture will be completed. The Payment details page will be opened, showing you the updated payment details:
This method can be used for capturing funds for a single order payment; it allows you to capture the entire authorized amount or do a partial capture (provided that your payment processor supports partial captures). In the case of partial captures, this method allows you to adjust the amount to be captured.
To do a capture, follow the steps below:
Locate the 'Authorized' payment for which you need to do a capture and open its details for viewing.
On the Payment details page, locate the section for Capture/Void actions:
Make sure that the amount for capture shown in the input box is correct. If you need to capture a partial amount, adjust the contents of the input box accordingly - only the specified amount will be captured.
In the screenshot below, we are capturing $20. It is a partial capture, as the amount authorized originally was $28.32:
After clicking the Capture button, the amount specified in the input box (in our case, $20) will be captured:
Note that if the payment processor supports partial captures but not multiple captures, after completing a capture, the Capture button will no longer be available.
If your payment processor supports multiple capture transactions, you will be able to do multiple partial captures on the same authorization.
For example, we have an order for two items: a bracelet ($6.49) and a watch ($19.99). The total authorized amount is $26.48. The bracelets are currently out of stock, but we are expecting to get more in three days. We want to capture the cost of the watch ($19.99) and ship the watch now, and then, in three days, we want to capture the cost of the bracelet ($6.49) and ship the bracelet. Provided that our payment processor supports multi-capture, after completing a capture of $19.99, the payment details will look as follows:
Note that we still have the Capture button to capture $6.49.