Enabling Sipay

Connect Sipay under Settings > Payments to accept 3D Secure credit and debit card payments and process order refunds through your Sipay virtual POS account.

Before you start

• Sign in as the store owner or with a staff account that has permission to manage Payments. Staff accounts without Payments permission cannot open the Sipay settings page.
• Have an active Sipay merchant account. Sipay is a Türkiye virtual POS provider; complete Sipay's merchant onboarding before accepting live payments, and confirm that foreign-currency collection is enabled on your Sipay account if your store charges in USD or EUR.
• Confirm that your store currency is supported by the Sipay integration: EUR, TRY or USD. While this guide uses USD examples, a USD store currency does not replace Sipay's merchant eligibility requirements.
• Obtain your three API credentials (Merchant key, App ID, and App secret) from your Sipay Merchant Panel or Sipay integration support.

Open the Sipay setup

1. In your Nevuto admin, go to Settings > Payments.
2. Click Add payment in the upper-right corner, then select Add payment provider.
3. In the Add payment method modal, enter Sipay in Enter payment method. Clear any category tab filter if it hides the result.
4. Select the Sipay card to open its setup form.

If Sipay is already configured on your store, click its row on Settings > Payments or open the row's three-dot menu and choose Manage. Opening the setup form does not connect or activate Sipay until you submit valid credentials. Select any screenshot to view it at full size.

Match Sipay credentials to the Nevuto fields

In your Sipay Merchant Panel, open your integration and API settings (or refer to Sipay's API documentation) to copy your Merchant Key, App ID, and App Secret for the environment you are configuring.

Match your Sipay values to the fields in Nevuto:

• Merchant key: Your live Sipay Merchant Key.
• App ID: Your live Sipay App ID.
• App secret: Your live Sipay App Secret.
• Sandbox merchant key (inside Sandbox mode): Your test Sipay Merchant Key.
• Sandbox app ID (inside Sandbox mode): Your test Sipay App ID.
• Sandbox app secret (inside Sandbox mode): Your test Sipay App Secret.

All three fields for the active mode are required. Keep your Merchant key and App secret private and out of screenshots, emails and support tickets.

Configure sandbox mode

1. In the Sipay setup form under Configure API keys, click Sandbox mode to expand the test fields.
2. Paste your test Merchant Key into Sandbox merchant key.
3. Paste your test App ID into Sandbox app ID.
4. Paste your test App Secret into Sandbox app secret. You can leave the three live fields empty while setting up only sandbox testing.
5. Turn on Enable sandbox mode so Nevuto connects to Sipay's sandbox environment (provisioning.sipay.com.tr).
6. Turn on Enable payment status when you want Sipay offered at checkout during testing.
7. Review Payment Limits if you want to restrict Sipay by cart total.
8. Click Submit in the upper-right corner and wait for the confirmation toast.

When you click Submit, Nevuto validates the active mode's credentials by requesting an authentication token from Sipay before saving. On a successful first save, Nevuto returns to Settings > Payments. Reopen Sipay to confirm that your credentials and mode were stored.

In the Payments list, Active or Inactive indicates whether customers see Sipay at checkout, while Sandbox or Live shows which credential set is active.

This screenshot shows an unsaved example. All six credential fields are intentionally empty and Enable payment status is off. Enter your own Sipay test credentials before clicking Submit.

Test the 3D Secure payment flow

After saving your sandbox settings, test a complete 3D Secure card payment and return path before switching to live credentials. Review Sipay's official test cards documentation for test card numbers, expiration dates and CVV error simulation codes. Never use a real payment card in sandbox mode.

To run your own merchant test after saving sandbox credentials:

1. Add a product to your storefront cart in a supported currency (EUR, TRY or USD) and proceed to checkout.
2. Select Sipay as the payment method, enter one of Sipay's official test cards, and submit the order.
3. Complete the 3D Secure verification step shown by Sipay's sandbox environment and wait to be redirected back to your store.
4. Confirm that the order is marked as paid in Nevuto and that the test transaction appears as approved in your Sipay sandbox merchant panel with the matching order amount.
5. Run a second test where you cancel the 3D Secure prompt or use one of Sipay's error-simulation CVV values to verify that declined or cancelled attempts return to checkout without marking the order as paid.

Set payment limits

Use Payment Limits to control which cart totals can use Sipay at checkout. Turn on the Payment Limits switch and enter a Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum amount cannot exceed the maximum amount.

Switch to live payments

After your sandbox tests pass and your live Sipay merchant account is ready:

1. Copy your production Merchant Key, App ID, and App Secret from your live Sipay Merchant Panel (app.sipay.com.tr).
2. In Nevuto, open Settings > Payments and select Sipay.
3. Paste your production credentials into Merchant key, App ID, and App secret.
4. Expand Sandbox mode and turn off Enable sandbox mode.
5. Confirm Enable payment status and Payment Limits are set as intended.
6. Click Submit and verify that Settings > Payments lists Sipay as Active in Live mode. Reopen Sipay to confirm your live credentials are saved.

Your test credentials can remain in the sandbox fields; turning off Enable sandbox mode switches Nevuto to your live credentials.

Edit, refund, or deactivate Sipay

Open Sipay from Settings > Payments (or select Manage from the row's three-dot menu ) any time you need to rotate credentials, switch environments or adjust cart limits. Submit stays disabled until you change a field on the form.

You can issue full or partial refunds for Sipay orders directly from the order details page in Nevuto Admin, and Nevuto reconciles payment and refund statuses with Sipay automatically.

To stop offering Sipay at checkout without deleting your credentials, turn off Enable payment status and click Submit, or open the three-dot menu on the Sipay row in Settings > Payments and select Deactivate. Choosing Delete from the three-dot menu removes the saved Sipay configuration from your store. Deactivating or deleting Sipay only affects new checkouts and does not cancel or refund past orders.

Troubleshooting