X-Payments:Auth and Capture

From X-Cart 4 Classic
Jump to: navigation, search

Depending on the type of order fulfillment process used by your store, you may choose to set up your account in such a way that the capture of funds from your buyers' accounts will not happen automatically at the time of payment processing, but will be delayed so you can capture the funds manually at a later time (You will need to ensure that your preferred payment gateway supports this feature).

To enable manual capture transactions in X-Payments, you will need to adjust your payment configuration settings accordingly:

  1. Go to the 'Payment configurations' page (Settings -> Payment configurations) and select the payment configuration for which you need to enable manual capture.
  2. On the 'Payment configuration details' page, set the Initial transaction to Auth:
    XP2.0 initial transaction.png
    Choosing Auth ensures that, when a customer makes a payment, the payment amount will be authorized, but not captured - until the time you decide to capture funds manually.
    Note: In the case of Auth and capture, the authorization is immediately followed by automatic capture, so you will not be able to capture funds manually.

To capture funds after the initial 'Auth' transaction:

  1. On the 'Payments' page, locate the payment for which you want to capture funds and open its details for viewing. The 'Payment details' page opens.
  2. On the 'Payment details' page, locate the section for Capture/Void actions:
    X-Payments 1.0:
    Auth capture2.gif
    X-Payments 2.0:
    XP2.0 capture void.png
  3. Make sure that the amount 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.
  4. Click Capture.

If your payment gateway supports multiple capture transactions, you can capture funds several times, gradually decreasing the authorized amount.

You can also capture funds (the whole amount) directly from the 'Payments' page. To capture funds for a payment, simply click on the Capture link next to the payment status:
X-Payments 1.0:

Auth capture3.gif

X-Payments 2.0:

XP2.0 payments page capture.png


If funds are not available for capture, the Capture button disappears.

Important: Provided that a scheduling program has been appropriately set up on your system to run the script cron.php for X-Payments, any Auth transactions not Captured in 30 days will be automatically voided.