|
|
| (13 intermediate revisions by 2 users not shown) |
| Line 7: |
Line 7: |
| | | | |
| | :* [[X-Payments:Video_Tutotials_on_Using_X-Payments_with_Magento | Video Tutotials on Using X-Payments with Magento]] | | :* [[X-Payments:Video_Tutotials_on_Using_X-Payments_with_Magento | Video Tutotials on Using X-Payments with Magento]] |
| | + | |
| | + | ==What's New== |
| | + | :* [[X-Payments:What%27s_New_in_X-Payments_Connector_for_Magento | What's New in X-Payments Connector for Magento]] |
| | + | :* [[X-Payments:Magento1-Connector-1.8.3 | X-Payments Connector for Magento v1.8.3]] |
| | + | :* [[X-Payments:Magento_Connector_v1.8.4 | X-Payments Connector for Magento v1.8.4]] |
| | | | |
| | ==Connecting Magento to X-Payments== | | ==Connecting Magento to X-Payments== |
| Line 14: |
Line 19: |
| | :* [[X-Payments:Updating_your_X-Payments_connector_for_Magento | Updating your X-Payments connector for Magento]] | | :* [[X-Payments:Updating_your_X-Payments_connector_for_Magento | Updating your X-Payments connector for Magento]] |
| | | | |
| − | ==Payments via X-Payments in Magento: Customer experience== | + | ==Using X-Payments with Magento: Customer experience== |
| | | | |
| | :* [[X-Payments:Magento_checkout_routine_when_using_X-Payments | Magento checkout routine when using X-Payments]] | | :* [[X-Payments:Magento_checkout_routine_when_using_X-Payments | Magento checkout routine when using X-Payments]] |
| | :* [[X-Payments:PCI_compliant_credit_card_saving_when_using_X-Payments_with_Magento | PCI compliant credit card saving when using X-Payments with Magento]] | | :* [[X-Payments:PCI_compliant_credit_card_saving_when_using_X-Payments_with_Magento | PCI compliant credit card saving when using X-Payments with Magento]] |
| | | | |
| − | ==Payments via X-Payments in Magento: Administrator experience== | + | ==Using X-Payments with Magento: Administrator experience== |
| − | ===Capturing payments===
| |
| | | | |
| | + | :* [[X-Payments:Control_of_access_to_X-Payments_connector_features_in_Magento | Control of access to X-Payments connector features in Magento]] |
| | :* [[X-Payments:Capturing_payments_when_using_X-Payments_with_Magento | Capturing payments when using X-Payments with Magento]] | | :* [[X-Payments:Capturing_payments_when_using_X-Payments_with_Magento | Capturing payments when using X-Payments with Magento]] |
| − | | + | :* [[X-Payments:Issuing_refunds_when_using_X-Payments_with_Magento | Issuing refunds when using X-Payments with Magento]] |
| − | ===Issuing refunds===
| + | :* [[X-Payments:Canceling_payments_when_using_X-Payments_with_Magento | Canceling payments when using X-Payments with Magento]] |
| − | After an order has been paid and invoiced, the entire order, or a portion of it, can be refunded. The basic method to do a refund in Magento is by issuing a credit memo.
| + | :* [[X-Payments:Finding_out_the_order_state_for_X-Payments_orders_when_using_X-Payments_with_Magento | Finding out the order state for X-Payments orders when using X-Payments with Magento]] |
| − | | + | :* [[X-Payments:Capture,_Void_and_Refund_on_orders_modified_using_Magento%27s_default_Edit_feature_when_using_X-Payments_with_Magento | Capture, Void and Refund on orders modified using Magento's default Edit feature when using X-Payments with Magento]] |
| − | {{Note1|'''Important''': If your workflow does not use invoices, or the order for which you need to issue a refund has been modified using Magento's default Edit feature, DO NOT use this procedure; instead, please refer to the section "[[#Capture, Void and Refund via the X-Payment Order State tab|Capture, Void and Refund via the X-Payment Order State tab]]".}}
| + | :* [[X-Payments:Capture,_Void_and_Refund_via_the_X-Payment_Order_State_tab_when_using_X-Payments_with_Magento | Capture, Void and Refund via the X-Payment Order State tab when using X-Payments with Magento]] |
| − | | + | :* [[X-Payments:PCI_compliant_credit_card_saving_on_behalf_of_a_customer | PCI compliant credit card saving on behalf of a customer]] |
| − | To issue a refund:
| |
| − | # In the Admin panel, select '''Sales''' > '''Orders''':<br />[[File:sales_orders.png|border]]<br /><br />
| |
| − | # In the Orders list, locate the order for which you want to issue a refund and click to open the order details:<br />[[File:order_to_refund.png|border]]<br /><br />
| |
| − | # In the '''Order View''' menu on the left-hand side of the screen, select the '''Invoices''' tab. This opens a list of invoices pertaining to the order:<br />[[File:invoices_list.png|border]]<br /><br />
| |
| − | # Locate the invoice for the item(s) you need to refund and click to open it.<br />[[File:invoice_to_refund.png|border]]<br /><br />
| |
| − | # In the upper right of the Invoice page, click the '''Credit Memo''' button to start the refund process by generating a credit memo.<br />[[File:credit_memo_button.png|border]]<br /><br />
| |
| − | # Scroll down to the "Items to Refund" section.<br />[[File:items_to_refund.png|border]]<br /><br />This section provides a list of items pertaining to the invoice and their respective quantities. By default, a refund will be issued for the entire invoice amount. If you are going to refund only some of the items and do a partial refund this time, update the quantities to refund (specify the correct quantities in the '''Qty to Refund''' column and click the '''Update Qty's''' button); the total amount to be credited will be re-calculated. Select the '''Return to Stock''' checkbox for the items that will be returned to inventory (Do not select the checkbox if the items will not be returned). If you want to refund shipping, issue an adjustment refund or add an adjustment fee, specify the respective amounts.<br />{{Note1|'''Important''': Before doing a partial refund, make sure your payment gateway supports this feature.}}
| |
| − | # Work through the process of creating a credit memo as usual: enter credit memo comments as needed, specify whether a notification of the credit memo needs to be emailed to the customer and whether your comments need to be appended to the notification.
| |
| − | # Click '''Refund''' or '''Refund Offline''' to process the refund (Select the button based on the action you require).<br />[[File:refund_offline_refund_buttons.png|border]]<br />If you select '''Refund''', a refund request will be submitted to the payment gateway via X-Payments, and a refund will be given at the same time that the credit memo is issued. If you select '''Refund Offline''', no refund request will be sent (This option assumes that you will handle the refund directly through the gateway or through the X-Payments back end).<br /><br />
| |
| − | :: Once you have completed the above steps, the credit memo should be created. Now if you go back to the order details and select the '''Credit Memos''' tab under the '''Order View''' menu, you should be able to see the new credit memo added to the list of credit memos pertaining to the order:<br />[[File:credit_memo_created.png|border]]<br /><br />The status will be shown as ''Refunded''.<br />If you have chosen to complete the refund online, the refund transaction will appear in X-Payments with the same status, ''Refunded''.<br />If you have chosen the "Refund Offline" option, the transaction will not be reflected in X-Payments.<br /><br />
| |
| − | | |
| − | ===Canceling payments===
| |
| − | In the "Auth only" workflow - as opposed to the "Auth and capture" workflow - it is possible to cancel (void) a payment before it has been captured. For example, if you have a payment for which an invoice was created with the "Not Capture" payment option, you can cancel it via the invoice page.
| |
| − | | |
| − | {{Note1|'''Important''': If your workflow does not use invoices, or the order for which you need to cancel a payment has been modified using Magento's default Edit feature, DO NOT use this procedure; instead, please refer to the section "[[#Capture, Void and Refund via the X-Payment Order State tab|Capture, Void and Refund via the X-Payment Order State tab]]".}}
| |
| − | | |
| − | To cancel a payment:
| |
| − | # In the Admin panel, select '''Sales''' > '''Orders''':<br />[[File:Sales_orders.png|border]]<br /><br />
| |
| − | # In the Orders list, locate the order for which you want to cancel a payment and click to open the order details.<br />[[File:order_to_cancel.png|border]]<br /><br />
| |
| − | # In the '''Order View''' menu on the left-hand side of the screen, select the '''Invoices''' tab. This opens a list of invoices pertaining to the order. Locate the invoice you need to cancel and click to open it.<br />[[File:invoice_to_cancel.png|border]]<br /><br />
| |
| − | # In the upper right of the Invoice page, click the '''Cancel''' button.<br />[[File:cancel_invoice_button.png|border]]<br /><br />The authorization to capture the invoice amount will be voided. The invoice status will be updated to ''Canceled''.<br />[[File:invoice_canceled.png|border]]<br /><br />In X-Payments, you should be able to find the respective Void transaction with the status ''Voided''. The status of the payment in X-Payments should be updated to ''Declined by merchant''.<br /><br />
| |
| − | | |
| − | ===Finding out the order state for X-Payments orders===
| |
| − | General information about the current state of an X-Payments order can be viewed in the '''X-Payment Order State''' section of the order details.
| |
| − | | |
| − | To access this section:
| |
| − | # In the Admin panel, select '''Sales''' > '''Orders''':<br />[[File:sales_orders.png|border]]<br /><br />
| |
| − | # In the Orders list, locate the X-Payments order for which you want to view the information and click to open the order details.<br />[[File:order_to_capture.png|border]]<br /><br />
| |
| − | # In the '''Order View''' menu on the left-hand side of the screen, select the '''X-Payment Order State''' tab. This opens a page like the following:<br />[[File:xp_order_state.png|border]]<br /><br />This is the most up-to-date information about the order state, since the information is updated every time the page is loaded or refreshed in the web browser.<br />On the snapshot above, we see information pertaining to Order #100000098 created on Jan 14, 2015 7:20:43 AM. Based on the table data, we can assume that the order was created for the amount of $110.80. An authorization was obtained for $110.80, of which $110.80 were captured. No refunds were given. The result payment status is ''charged''.<br />Should we need more information about the specific transactions that were performed on this order, we can expand the section '''Transaction list for order #''' by clicking on its header:<br />[[File:transaction_list.png|border]]<br /><br />The result will be detailed information about all the payment related transactions that have been performed on this order:<br />[[File:transaction_list1.png|border]]
| |
| − | <br /><br />
| |
| − | ===Capture, Void and Refund on orders modified using Magento's default Edit feature===
| |
| − | Sometimes you may require to make changes to an order in your store. For example, you may want to change an order if a customer asks you to add an item to their order or if some of the items in the order are out of stock.
| |
| − | | |
| − | When you need to remove an item from an X-Payments order in Magento, you use the Credit Memo feature (For more info, see the section [[X-Payments:Using_X-Payments_with_Magento#Issuing refunds |Issuing refunds]]). When you need to add an item to an order, you do it using Magento's default Edit feature:<br />
| |
| − | ::[[File:order_edit_feature.png|border]]<br /> | |
| − | | |
| − | You need to know that if you have used Magento's default Edit feature to add items to an X-Payments order, you will need to treat this order in a special way when performing payment related operations like Capture, Void or Refund.
| |
| − | | |
| − | The thing is, when you edit an order in Magento, the original order is canceled, and a new ("child") order is generated based on it. Because one or more items are added to the order, the grand total amount of the "child" order is greater than the grand total amount of the "parent" order. When your store creates a new order, it requests an authorization for the amount equal to the difference between the grand total amount of the child order and the grand total amount of the parent order:
| |
| − | ::''Xp Transaction amount = Child Order (new order) — Parent order (Edited Order)''
| |
| − | The existing authorization inherited from the parent order also keeps for the new order.
| |
| − | | |
| − | Now if you attempt to do a capture of funds on this new order through creating an invoice, you are highly likely to request a capture of an amount that does not match any of the two authorizations. This means, if you use the "Capture Online" option, you won't be able to complete the capture transaction successfully. That is why, when performing a capture on an order that has been edited using Magento's default Edit feature, you should refrain from using the "Capture Online" option. Instead, you may want to use the option "Capture Offline" or (in the event that you do not need an invoice) to perform a capture through the '''X-Payment Order State''' tab.
| |
| − | | |
| − | The same holds true for Void and Refund: when you need to perform these actions on an X-Payments order that has been edited in Magento, avoid using the "online" options of the invoice (Invoice: Cancel or Invoice: Credit Memo→Refund Online).
| |
| − | | |
| − | ''Example:''<br />
| |
| − | In our Magento store, an order was created (Order #100000110) for a single unit of "Simple product 1".
| |
| − | ::[[File:order_110.png|border]]<br />
| |
| − | | |
| − | The initial transaction on this order was performed in the "Auth only" mode, and the amount for which an authorization was obtained was $61 ($56 one unit of "Simple product 1" + $5 shipping):<br />
| |
| − | ::[[File:1_auth.png|border]]<br /> | |
| − | | |
| − | We edited the order by adding to it another unit of "Simple product 1". The order #100000110 was canceled, and, based on it, another order, Order #100000110-1, was generated. On this order, a new authorization was obtained for the difference of #100000110-1 and #100000110 grand total amounts, which was also $61 ($56 one unit of "Simple product 1" + $5 shipping).
| |
| − | | |
| − | Now if you take a look at the information in the '''X-Payment Order State''' section, you should see the authorization that Order #100000110-1 inherited from Order #100000110, as well as the new authorization that was created for the difference between the two order amounts:<br />
| |
| − | ::[[File:2_auth.png|border]]<br />
| |
| − | | |
| − | Please note that these are two separate authorizations ($61 + $61).
| |
| − | | |
| − | Now if we include both the units of "Simple product 1" from this order into a single invoice, the invoice total amount will be $122 ($112 two units of "Simple product 1" + $10 shipping):
| |
| − | ::[[File:invoice_two.png|border]]<br />
| |
| − | | |
| − | If we invoice the two units of "Simple product 1" separately, the invoice totals will be $66 ($56 first unit of "Simple product 1" + $10 shipping of both the units):
| |
| − | ::[[File:invoice_1.png|border]]<br />
| |
| − | | |
| − | and $56 ($56 second unit of "Simple product 1", no shipping):
| |
| − | ::[[File:invoice_2.png|border]]<br />
| |
| − | | |
| − | In any case, neither of the above amounts equals $61, the amount for which we have two authorizations. So, if you choose the "Capture Online" option when doing a capture, the capture transaction will not be processed successfully.
| |
| − | | |
| − | ===Capture, Void and Refund via the X-Payment Order State tab===
| |
| − | If your store's workflow does not involve invoicing, or you are dealing with an X-Payments order that has previously been edited using Magento's default Edit feature, you can perform Capture, Void and Refund operations via the X-Payment Order State section of the order details (The section can be accessed by clicking the '''X-Payment Order State''' tab in the '''Order View''' menu). The specific operations available to you depend on the current order state, and you can only see the buttons for the operations that you can perform. If necessary, you can edit the amount on which the operation is performed by editing the contents of the iput field in the Actions column of the table.
| |
| − | | |
| − | '''Important''': If you have already performed a Capture, Void or Refund operation on an order via the X-Payment Order State section, you should not attempt to do any further payment related operations on this order using the online options of the invoice (like Invoice: Cancel, Invoice: Capture Online or Invoice: Credit Memo→Refund Online), as it may cause the following problems:
| |
| − | * Sending a duplicate request for the current transaction;
| |
| − | * Requesting a transaction for an unavailable amount (For example, by doing Invoice: Credit Memo→Refund Online you may be requesting a refund for an amount exceeding the amount that you have captured originally via the '''Order(s) state''' block in the X-Payment Order State section).
| |
| − | The opposite is also true: If you have used on a certain order a payment related operation based on an online option of the invoice (Invoice: Cancel, Invoice: Capture Online or Invoice: Credit Memo→Refund Online), do not attempt to perform any further payment related operations on this order via the X-Payment Order State section, as it is likely to cause similar problems.
| |
| | | | |
| | ==Recurring Billing in Magento with X-Payments== | | ==Recurring Billing in Magento with X-Payments== |
