Enabling Payriff

Connect Payriff under Settings > Payments so customers can pay through Payriff's hosted checkout page and return to your store after completing payment.

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 Payriff settings form.
• Have an active Payriff merchant account. Payriff is an Azerbaijan payment service provider; verify that your business meets Payriff's merchant onboarding requirements before going live.
• Check that your store currency is supported. In Nevuto, Payriff supports AZN, USD and EUR. This guide uses USD examples, which do not establish merchant eligibility outside Payriff's supported market.
• Obtain your test and live application credentials from your Payriff Dashboard before configuring the integration.

Open the Payriff setup

1. Go to Settings > Payments in your Nevuto admin.
2. Click Add payment and choose Add payment provider.
3. In the Add payment method modal, search for Payriff in Enter payment method. Clear any active category tab if it filters out the result.
4. Click the Payriff card to open its setup form.

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

Match Payriff credentials to the Nevuto fields

In your Payriff Dashboard, open your application details to locate your Merchant ID (such as ES...) and your Secret Key. See Payriff's API documentation and Payriff's authorization guide for where to copy your application credentials.

Match your Payriff values to the fields in Nevuto:

• Public key: Your live Payriff Merchant ID (for example, ES...).
• Secret key: Your live Payriff Secret Key.
• Sandbox public key (inside Sandbox mode): Your test/sandbox Payriff Merchant ID.
• Sandbox secret key (inside Sandbox mode): Your test/sandbox Payriff Secret Key.

Do not include a Bearer prefix when pasting your Secret Key. Keep secret keys private and out of screenshots or support messages.

Configure sandbox mode

1. In the Payriff form under Configure API keys, expand Sandbox mode.
2. Enter your test Merchant ID in Sandbox public key.
3. Enter your matching test Secret Key in Sandbox secret key. On initial setup, if you provide a public key for an environment, Nevuto requires the corresponding secret key as well.
4. Turn on Enable sandbox mode so Nevuto selects your sandbox credential pair.
5. Turn on Enable payment status when you want Payriff visible at checkout for testing.
6. Review Payment Limits if you want to restrict when Payriff appears by cart amount.
7. Click Submit in the upper-right corner and wait for the confirmation message.

When you click Submit, Nevuto validates the active mode's Merchant ID and Secret Key with Payriff before saving. On a successful first setup, Nevuto returns to Settings > Payments. Reopen Payriff to confirm your saved settings.

The Payments list shows Active or Inactive status separately from Sandbox or Live mode.

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

Test the hosted checkout flow

Because Nevuto selects your test or live credential pair based on Enable sandbox mode, make sure you use test credentials issued by Payriff for sandbox testing. Follow the test card details and instructions provided for your Payriff merchant test application in Payriff's documentation.

After saving your test configuration:

1. Create a test cart in your storefront in a supported currency (AZN, USD or EUR) and proceed to checkout.
2. Select Payriff and continue to Payriff's hosted payment page. Note that Nevuto sets the Payriff payment page language to English (EN) when the store language is en-US, Russian (RU) for ru-RU, and Azerbaijani (AZ) otherwise.
3. Complete an approved test payment and return to your store.
4. Confirm that the order is marked as paid in Nevuto and appears as approved in your Payriff Dashboard.
5. Test a cancelled and a declined payment as well to verify how customers are returned to checkout when payment does not succeed.

An Active badge in Settings > Payments only reflects your saved store setting; always verify a complete checkout round-trip before accepting live payments.

Set payment limits

Use Payment Limits to offer Payriff only when the cart total falls within a specific range. Turn on Payment Limits and enter Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum amount must not exceed the maximum amount.

The $50–$500 USD range shown above is a prepared unsaved example, not a saved store setting or recommended limit. Turn Payment Limits off if you do not want a custom cart-amount restriction in Nevuto. Click Submit after changing limits and reopen the form to confirm they were stored.

Switch to live payments

Once you have verified the checkout flow and your live Payriff merchant application is active:

1. Open Settings > Payments in Nevuto and select Payriff.
2. Enter your live Payriff Merchant ID in Public key and your live Secret Key in Secret key.
3. Expand Sandbox mode and turn off Enable sandbox mode.
4. Confirm Enable payment status and Payment Limits.
5. Click Submit and verify that Settings > Payments shows Payriff as Active in Live mode.

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

Edit or deactivate Payriff

Open Payriff from Settings > Payments to update credentials, change modes or adjust payment limits. Submit stays disabled until you make a change on the form.

To stop offering Payriff at checkout, turn off Enable payment status and click Submit, or use the three-dot menu on the Payriff row in Settings > Payments to select Deactivate. Choosing Delete from the three-dot menu removes the saved Payriff configuration from your store. Deactivating or deleting the payment method does not cancel or refund existing orders; process any refunds directly in your Payriff Dashboard.

Troubleshooting