Help

Enabling PayTR

Blocked setup reference for PayTR in Nevuto Admin, covering visible setup fields, currency support, and the missing Merchant ID field limitation.

Updated

PayTR is listed under Settings > Payments for stores operating in supported currencies. However, enabling PayTR from the Nevuto Admin UI is currently blocked because the setup form is missing the required Merchant ID field.

Important — Current Admin UI limitation PayTR requires three credentials—Merchant ID, Merchant Key, and Merchant Salt—before Nevuto allows a PayTR configuration to be saved. The current Configure API keys form in Nevuto Admin only displays Public key (for Merchant Salt) and Secret key (for Merchant Key) and does not provide an input field for your Merchant ID. Because the Merchant ID cannot be entered on the form, clicking Submit always fails with: PayTR payment gateway is not configured correctly. Please check your Merchant ID, Merchant Key and Merchant Salt credentials and try again. Do not attempt to enable PayTR for test or live checkout until this field is added.

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 PayTR settings page.
  • Have a PayTR merchant account with access to your integration credentials (Merchant ID, Merchant Key, and Merchant Salt) in the PayTR Merchant Panel. PayTR serves merchants operating in Türkiye.
  • Confirm that your store currency is supported by the PayTR integration: EUR, TRY or USD. If your store uses another currency, PayTR appears disabled in the payment provider picker.

Open the PayTR 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 PayTR in Enter payment method. Clear any category tab filter if it hides the result.
  4. Select the PayTR card to open its setup form.

Opening the setup form does not connect or activate PayTR. Select any screenshot to view it at full size.

Review the API key fields

In the Configure API keys card, the form currently displays two live credential fields and a status toggle:

  • Public key: Intended for your live PayTR Merchant Salt.
  • Secret key: Intended for your live PayTR Merchant Key.
  • Enable payment status: Controls whether PayTR is shown as an active payment option at checkout once configured.

Because the form does not include a field for your PayTR Merchant ID, saving new live credentials from this screen is currently blocked.

The Configure API keys card on initial setup with empty Public key and Secret key fields, Enable payment status turned off, and Submit disabled.

Review sandbox mode fields

Expanding Sandbox mode inside Configure API keys reveals the test-mode fields:

  • Sandbox public key: Intended for your test PayTR Merchant Salt.
  • Sandbox secret key: Intended for your test PayTR Merchant Key.
  • Enable sandbox mode: Switches the form to sandbox mode. As with live mode, the form does not include a Sandbox merchant ID input field, so sandbox setup cannot currently be saved from the Admin UI.

This screenshot shows an unsaved example with Sandbox mode expanded and Enable sandbox mode turned on while all four credential fields remain empty.

Set optional payment limits

The Payment Limits card lets you restrict the cart totals for which a payment provider appears 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.

Tip The $50–$500 USD range shown above is a prepared unsaved example, not a saved store setting or required range.

Troubleshooting

Was this guide helpful?