X-Payments:Emulating transactions

From X-Payments Help
Revision as of 15:17, 10 August 2016 by Dohtur (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Sometimes a situation may occur when you need to change the status of a payment in X-Payments without actually completing the respective transaction via the payment gateway. For example, you may need to "mark" a payment as captured when you know that the funds have been successfully moved to your account, but the information about the payment status change was not sent to X-Payments (i.e., X-Payments did not receive a callback request from the payment gateway - because the payment gateway does not support this feature or was down). In this case, you should use the 'Emulate transaction' feature. As a result, the transaction status will be updated in X-Payments - without the information being sent to the payment gateway. The information about the transaction status change will also be sent to the online store, and - provided that the online store supports this feature (X-Cart does) - the order status in the store will be automatically updated as well.


To emulate a transaction:

X-Payments 2.0 and later:

  1. On the payment details page, locate the section for Capture/Void/Refund actions:
    XP2.0 capture void.png or XP2.0 refund.png
  2. Make sure that the amount shown in the input box is correct. If you need to use a partial amount, adjust the contents of the input box accordingly - the transaction will be completed only for the specified amount (NB: Your payment gateway must support partial transactions!).
  3. Capture/Refund transactions: Select the Emulate transaction check box below the input box.
    Void: Select the Emulate transaction check box next to the Void button.
  4. Click the transaction action button (Capture, Refund or Void).

X-Payments 1.0:

  1. On the payment details page, click the Emulate transaction link. The 'Emulate transaction' section opens:
    Auth capture4.gif
  2. Make sure that the amount shown in the input box is correct. If you need to use a partial amount, adjust the contents of the input box accordingly - the transaction will be completed only for the specified amount (NB: Your payment gateway must support partial transactions!).
  3. Click the transaction action button (for example, Capture).