Operation

Orders with automatic capture

If you have configured the Capture Mode to Automatic (capture immediately) (see Configure additional basic settings), the amount is captured immediately when the customer completes the checkout.

The purchase process follows the standard OXID eShop order process. After the customer clicks Order now, the Stripe payment form appears (Fig.: Stripe payment form).

Stripe payment form

Fig.: Stripe payment form

Result

The payment is captured immediately. In the admin area under Administer Orders ‣ Orders ‣ <Order>, the Payment tab displays the payment details (Fig.: Payment details of an automatically captured order).

Note

The Payment tab is provided by the OXID Payment Base module and is identical across all OXID Payment modules. Stripe Payment for OXID contributes the Stripe-specific content as a panel inside this shared tab. Further reading: OXID Payment Base Documentation.

Payment details of an automatically captured order

Fig.: Payment details of an automatically captured order

Note

Orders that stay at NOT_FINISHED

The order is created before the customer is sent to Stripe, so that an order number exists when they return. A customer who abandons the payment leaves the order behind at this status. Such orders are cleaned up automatically; see Clean up abandoned checkouts if they accumulate in your shop.

Orders with manual capture

If you have configured the Capture Mode to Manual (authorize only, capture later), the payment is initially only authorized. You must capture the amount manually afterwards.

Important

If you choose manual capture, you must capture the payment within 7 days. After this period, the authorization expires and the reserved funds are released.

The checkout process in the frontend is identical to the automatic mode. The customer goes through the normal checkout and enters their payment details in the Stripe payment form (Fig.: Stripe payment form).

The difference is visible in the admin area: The Payment tab shows the notice Payment capture required and offers the button Capture Payment (Fig.: Payment tab with capture form for manual capture).

Payment tab with capture form for manual capture

Fig.: Payment tab with capture form for manual capture

Capture payment

Capture the authorized amount to complete the transaction.

Procedure

  1. Go to Administer Orders ‣ Orders and select the order.

  2. Select the Payment tab.

  3. Optional: In the field Capture note (optional), enter a reason, e.g. “Order ready for shipment”.

  4. Click the button Capture Payment.

Result

The payment is captured and the order is marked as paid.

Cancel authorization

Alternatively, you can cancel the authorization to release the funds reserved on the customer’s card.

Note

This action cannot be undone.

Procedure

  1. Go to Administer Orders ‣ Orders and select the order.

  2. Select the Payment tab.

  3. Optional: In the field Cancellation reason (optional), select a reason.

  4. Click the button Cancel Authorization and confirm the dialog.

Result

The authorization is canceled and the reserved funds are released.

Refunds

Refund payments fully or partially via the Payment tab in the order administration.

Prerequisites

  • The order was paid with Stripe Payment.

  • The payment has been captured (in case of manual capture).

Full refund

Procedure

  1. Go to Administer Orders ‣ Orders and select the order.

  2. Select the Payment tab.

  3. Optional: Under Refund reason (optional), select a reason.

  4. Optional: Under Refund note, enter a description (max. 140 characters).

  5. Click the button Process Refund.

Partial refund

If you have already refunded individual items, the system displays the remaining amount. Click Process Refund to refund the remaining amount.