Testing Payments

Testing Payments

Before accepting real payments, it is essential to test your payment flow thoroughly. Nuvi integrates with Stripe and iyzico, both of which offer test/sandbox environments for safe testing.

Stripe Test Mode

Stripe provides a complete test environment that mirrors the live payment flow without processing real charges:

1. Log in to your Stripe Dashboard at dashboard.stripe.com.
2. Toggle the "Test mode" switch in the top-right corner. The dashboard header turns orange to indicate test mode.
3. Go to Developers > API Keys and copy your test publishable key and test secret key (they start with pk_test_ and sk_test_).
4. In Nuvi admin, go to Settings > Regions, select your region, and enter the test keys in the Stripe configuration.

Stripe Test Card Numbers

Use these test card numbers to simulate different scenarios:

• 4242 4242 4242 4242 — Successful payment (Visa).
• 4000 0000 0000 3220 — Triggers 3D Secure authentication.
• 4000 0000 0000 9995 — Declined (insufficient funds).
• 4000 0000 0000 0002 — Declined (generic decline).

For all test cards, use any future expiration date (e.g., 12/34) and any 3-digit CVC (e.g., 123).

iyzico Sandbox

iyzico offers a sandbox environment for Turkish payment testing:

1. Sign up for an iyzico sandbox account at sandbox-merchant.iyzipay.com.
2. Obtain your sandbox API Key and Secret Key from the sandbox dashboard.
3. Configure these keys in Nuvi's payment settings.
4. Use iyzico's test card numbers (available in their sandbox documentation) to simulate transactions.

What to Test

Run through the complete checkout flow for each scenario:

• Successful purchase — Add a product to cart, complete checkout, verify the order appears in admin.
• Failed payment — Use a decline card and verify the customer sees a clear error message.
• 3D Secure — Test the authentication popup flow and ensure it returns to your store correctly.
• Refunds — Process a test refund from the order detail page and verify it appears in Stripe.
• Email notifications — Confirm that order confirmation emails are sent after successful purchases.

Going Live

When testing is complete:

1. Switch to your live API keys in the Stripe/iyzico dashboard (toggle off test mode).
2. Update the keys in Nuvi's payment settings.
3. Process one small real transaction to verify everything works with live credentials.