Typical Scenarios

The following scenarios demonstrate different ways merchants can use the Paysafe Embedded Card Payments app

This is a typical scenario merchants may use to provide immediate delivery of the order without delayed payment capture.

1. Set Payment Action:
   • On the Settings→Payments page, ensure that the selected Payment Capture Method is Automatically at checkout.
2. Visit the Store:
   • In the Shopify admin, use the Visit your online store icon/shortcut on the Online Store sales channel.
3. Add Item to Cart:
   • In the store, add an item to the cart, proceed to the cart, and click Check out.
4. Check for Paysafe Credit Card Payment Method:
   • On the Shopify Checkout page, the Credit card payment method should appear.
   • If you don’t see it, verify that the extension is enabled, Test Flag is active, and other settings are configured correctly.
5. Make a Payment:
   • Paste the (test) card number, enter any Cardholder Name, an expiration date that is still valid, and any CVV
   • Click Pay now to complete the payment.
   • After successful payment, the customer is redirected to the success payment screen.

This is a typical scenario where the merchant obtains authorization for an initial purchase amount and captures payment at a later stage, for example, after the order is fulfilled.

1. Set Payment Action:
   • On the Settings→Payments page, ensure that the selected Payment Capture Method is Manually.
2. Visit the Store:
   • In the Shopify admin, use the “Visit your online store” icon/shortcut on the “Online Store” sales channel.
3. Add Item to Cart:
   • In the store, add an item to the cart, proceed to the cart, and click Check out.
4. Check for Paysafe Credit Card Payment Method:
   • On the Shopify Checkout page, the Credit card payment method should appear.
   • If you don’t see it, verify that the extension is enabled, Test Flag is active, and other settings are configured correctly.
5. Make a Payment:
   • Paste the test card number, enter any Cardholder Name, an expiration date that is still valid, and any CVV.
   • Click Pay now to complete the payment.
6. Review Order Status:
   • After a successful transaction, visit the Shopify Orders page and open the order you just created.
   • The order should have a status of Authorized, indicating that the payment is not captured and only the payment authorization has been completed.

This scenario demonstrates how to cancel an order with an authorized payment, resulting in a Void transaction.

Note: As stated in Testing Instructions: Payment testing in test mode, when in test mode, voiding amounts between 300 and 399.99 will be unsuccessful. Voiding other amounts will be successful.

1. Create a New Order:
   • Follow the steps in Scenario 2 to create a new order with an authorized payment.
2. Access the Created Order:
   • Open the created order, which should be in the Authorized status.
3. Cancel the Order:
   • Select More Actions→Cancel order
   • Since the payment is only authorized, the extension will automatically create a Void transaction and update the payment status to Voided.
4. Verify Void Transaction:
   • Check the Timeline section of the order. There should be a message confirming the successful cancellation of the authorization (Voided).

This scenario demonstrates how to refund an order after the settlement has been processed.

Note: As stated in Testing Instructions: Payment testing in test mode, when in test mode, refunding amounts between 200 and 299.99 will be unsuccessful. Refunding other amounts will be successful.

1. Create a New Order:
   • Follow the steps in Scenario 1 to create a new order with authorization and settlement.
   • Wait for some time until the settlement is processed. This usually happens overnight, so it’s best to continue the test the following day.
2. Access the Created Order:
   • Open the created order, which should now be in the Paid status.
   • Click the Refund button.
3. Perform the Refund:
   • Enter a partial or full payment amount.
   • Then, click Refund button.
4. Verify Refund:
   • Since the payment is settled, the extension will automatically create a Refund transaction and update the order status to Refunded.
   • Check the Order Notes (Timeline) section of the order for a message confirming the successful refund.
5. Partial Refund:
   • If you issued a partial refund, it’s possible to refund the order in multiple steps, as long as the refund amount is equal or less than the remaining amount available for refund.

This scenario demonstrates how to capture payment for an order where the payment was authorized but not yet settled.

Note: As stated in Testing Instructions: Payment testing in test mode, when in test mode, capturing amounts between 300 and 399.99 will be unsuccessful. Capturing other amounts will be successful.

1. Create a New Order:
   • Follow the steps in Scenario 2 to create a new order with an authorized payment.
2. Access the Created Order:
   • Open the order you just created, which should be in the Authorized status.
3. Capture the Payment:
   • Click the Capture payment.
   • Enter the amount you want to capture.
4. Partial capture:
   • If you enter a capture amount less than previously authorized amount, the payment status will change to Partially paid.
   • It is not possible to do an additional capture later. In such case, any additional capture must be done via your merchant portal. 
5. Verify Settlement:
   • In this case, since the payment was only authorized, the extension will automatically create a Settlement transaction and update the order status to Processing.
   • Check the Order Notes (Timeline) section of the order for a message confirming the successful settlement.