Certification guide

Before moving your iwocaPay integration to production, you’ll need to complete these functional tests in our Sandbox environment.

It’ll make sure your system correctly handles different payment outcomes and your customers get a seamless experience.

1. Environment setup

Prerequisites

• Environment: Ensure your integration is pointing to the Sandbox API.
• Credentials: Use your Sandbox API keys. You can find base URLs in our Sandbox Documentation.

Test data profiles

Use the following data to trigger specific outcomes:

• Standard Success (Cases 1, 2, & 4): Use the standard test buyer details found in our Sandbox Guide.
• Declined Application (Case 3): To simulate a “Declined” decision, enter £0.00 for the annual turnover question during the iwocaPay sign-up flow.

2. Required test cases

Case 1: “Pay Now” success path

Not applicable if you are not providing pay now.

Objective: Verify that a customer can successfully complete a “Pay Now” transaction and return to your site.

1. Initiate: Create an order and navigate to the iwocaPay checkout URL.
2. Selection: Confirm that both Pay Now and Pay Later options are visible (if configured).
3. Complete: Select Pay Now and follow the prompts to complete the payment.
4. Redirect: Ensure you are redirected back to your configured redirect_url.
5. Verification: Confirm your website displays a clear “Payment Successful” message to the customer.

Case 2: “Pay Later” success path

Objective: Verify that a customer can successfully complete a “Pay Later” (financing) journey.

1. Initiate: Create an order and navigate to the iwocaPay checkout URL.
2. Selection: Select the Pay Later option.
3. Complete: Complete the credit application using standard test data.
4. Redirect: Ensure you are redirected back to your redirect_url.
5. Verification: Confirm your website displays an “Order Confirmed” or “Payment Successful” message.

Case 3: “Pay Later” declined path

Objective: Verify that your site gracefully handles a declined credit application.

1. Initiate: Start a Pay Later journey.
2. Trigger Decline: When prompted for business turnover, enter £0.00.
3. Decision: The iwocaPay interface will show a “Declined” status.
4. Redirect: Click the Return to Merchant button.
5. Verification: Confirm that your website displays an appropriate error message (e.g., “Payment was not successful, please try another payment method”) and allows the user to attempt checkout again.

Case 4: cross-session recovery (Session drop)

Objective: Ensure the integration handles customers who switch devices or browsers (e.g., starting on a laptop, finishing on mobile).

1. Initiate: Start an order on your site and select iwocaPay.
2. Capture URL: Once you land on the iwocaPay checkout page, copy the full URL from your browser address bar.
3. Switch Session: Open a new Incognito/Private window (to simulate a “lost cookie” or new device) and paste the URL.
4. Complete: Complete the flow as normal in the new window.
5. Verification: Upon redirection, confirm your site correctly identifies the session and displays the order confirmation.
   • Note: If your site requires a login to see orders, the test passes as long as the confirmation is visible after the user logs in.

3. Requesting production access

Once you have verified these cases in Sandbox, please reach out to your Account Manager or our Support Team to request your Production API Keys.