CartDNA is a Shopify Payment App Development Partner

CartDNA Logo

CartDNA Integration Guide for Shopify

Get setup tips, configuration guidance, app credential help, and practical solutions for CartDNA Shopify payment app integration. Learn how to update API keys, manage test and live settings, configure webhooks, and reduce common setup mistakes before you go live.

Shopify-compatible payment app integrations
Test and live credential support
720+ payment methods across 190+ markets
Flexible configuration for provider-specific setups

CartDNA integration made simple for Shopify merchants

CartDNA helps Shopify merchants connect approved payment methods, banks, PSPs, and alternative payment services through native Shopify-compatible payment app flows. This knowledge base page gives you a practical starting point for updating settings, understanding credentials, and checking critical configuration points before launch.

Every CartDNA app can have different technical requirements. That is because each integration depends on the payment provider, processor, bank, or service partner behind the app. Your setup may include provider-specific API fields, custom options, live and test credentials, and sometimes webhook configuration requirements.

Update your CartDNA app settings and API keys

You can update your CartDNA payment app settings and API credentials in two ways. Both methods take you to the same app configuration area. Choose the route that best fits your workflow.

Update through Shopify Admin

Best for merchants who want to manage payment app settings directly from Shopify.

Includes:

Fast access from Shopify Payments settings
Direct route to the app management area
Good for day-to-day configuration updates

Update through CartDNA Merchant Portal

Best for merchants managing one or more CartDNA apps from the CartDNA dashboard.

Includes:

Central access to CartDNA app management
Easy navigation from the main dashboard
Helpful for multi-app merchant workflows

Support note: If you do not have access to the CartDNA Merchant Portal, or if you cannot log in, contact the CartDNA Support Team before making account-related changes.

How to update CartDNA app settings through Shopify Admin

Use this route if you want to manage your CartDNA app from your Shopify account.

1

Log in to your Shopify Admin Panel.

2

Go to: Settings > Payments

3

Find your CartDNA payment app in the payment methods list.

4

Open the More actions menu and click: Manage

5

You will be redirected to the CartDNA app configuration section.

Helpful note: This route is useful when you want a fast way to review payment app status, configuration fields, and credential updates without leaving Shopify.

How to update CartDNA app settings through the CartDNA Merchant Portal

Use this route if you prefer working from the CartDNA dashboard.

1

Log in to your CartDNA Merchant Portal.

2

Go to the Main Dashboard.

3

Find the app you want to update.

4

Click: Manage

5

You will be redirected to the CartDNA app configuration section.

Important support note: If you are experiencing login issues, missing access, or account restrictions, contact the CartDNA Support Team for help before updating payment settings.

What you will see inside the app configuration section

Once you open the configuration area, you may see several tabs depending on the app.

Live Mode

Enter or update your live API keys and production settings for real transactions.

Test Mode

Add or update test credentials to simulate payments without moving real money.

Custom Configuration

Manage provider-specific fields if supported by the selected CartDNA app.

Important note: Some apps include extra settings that are unique to the payment processor, bank, acquirer, or service provider connected to that integration. This means configuration fields can differ from app to app.

What are CartDNA app credentials

App credentials are secure API keys or connection details issued by your payment provider. They allow your CartDNA app to communicate with a PSP, bank, omnichannel platform, or other payment service provider so transactions can be processed safely.

These credentials act as the technical bridge between your Shopify store and the payment provider. In most cases, the credentials used in CartDNA are the same credentials you would use if you were integrating directly with that provider.

Test credentials vs live credentials

Test credentials

  • Used for development and setup validation
  • No real payment funds move
  • Helps you check redirects and app behaviour
  • Best for pre-launch testing

Live credentials

  • Used for real customer transactions
  • Needed when you are ready to accept payments
  • Should only be added after successful testing
  • Must match your approved live merchant account

Practical advice: Always complete full testing in test mode before switching to live mode. This helps you detect setup issues early and reduces failed payments after launch.

Where to find your API keys and app credentials

You can usually find test and live API credentials by signing in to your payment provider's merchant dashboard or partner portal. In some cases, the provider may send them directly to you or ask you to request them through support.

What to check:

  • Confirm you are using the correct merchant account
  • Confirm whether keys are test or live
  • Confirm whether extra webhook values are required
  • Confirm whether the PSP has provider-specific setup instructions

Conversion-focused support message: Not sure which credentials to use? Contact CartDNA Support before updating the app. A quick check now can prevent payment failures later.

Configure webhooks if required

After updating test or live API keys, you may need to click the: Configure Webhooks button for each mode.

This step is critical for some payment apps. If webhook configuration is required but not completed, your app may not function correctly. Order status updates, payment confirmations, and transaction events may fail to sync properly.

Some CartDNA apps do not require webhook setup, so you may not see this button.

Before you finish:

  • Save your updated settings
  • Configure webhooks if the option appears
  • Run a test checkout
  • Confirm redirect and return behaviour
  • Review order and payment status in Shopify

Best practice before making integration changes

We strongly recommend speaking to the CartDNA Support Team before changing API keys, merchant account mappings, or provider-specific settings. A small configuration mistake can stop transactions, send customers to the wrong payment page, or create checkout errors.

Best practice checklist:

  • Confirm you are editing the correct CartDNA app
  • Check whether the provider issued new test or live credentials
  • Review custom fields carefully
  • Configure webhooks if required
  • Test checkout after every important change
  • Complete a live transaction if possible
  • Confirm the customer reaches the correct payment page

This process helps protect conversion rate, checkout stability, and customer trust.

Reconnect your app to another merchant account or payment profile

CartDNA lets you reconnect or update your licensed payment app to work with a different merchant account or payment profile without additional charges. This gives you flexibility when changing acquirers, moving to a new PSP setup, or updating business payment arrangements.

Before switching:

  • Check provider approval status
  • Confirm live credentials are valid
  • Review any custom configuration changes
  • Re-test the app before accepting live orders

Go live with more confidence

A careful launch reduces payment risk and helps avoid failed customer journeys. Before going live, you should test payment redirects, verify return URLs, confirm order creation behaviour, and check whether payment notifications are updating correctly inside Shopify.

Recommended go-live flow:

  1. 1.Add test credentials
  2. 2.Run test transactions
  3. 3.Confirm redirect behaviour
  4. 4.Confirm Shopify order updates
  5. 5.Add live credentials
  6. 6.Configure live webhooks if required
  7. 7.Run a real transaction
  8. 8.Monitor the first few orders closely

Frequently asked questions

Can I update CartDNA app API keys later?
Yes. You can update API credentials and app settings at any time through Shopify Admin or the CartDNA Merchant Portal.
Do all CartDNA apps use the same configuration fields?
No. Each CartDNA app can include different settings depending on the payment provider, bank, processor, or service partner behind the integration.
Do I always need to configure webhooks?
No. Some apps require webhook setup and some do not. If the button appears in your configuration area, review it carefully and complete the step if needed.
Where do I get my test and live credentials?
Most merchants get them from their PSP or bank merchant dashboard. Some providers issue them directly through onboarding or support.
Should I test before using live credentials?
Yes. You should always test first. This helps you catch setup issues before real customers start using the payment method.
Can CartDNA help me verify the setup?
Yes. CartDNA Support can help review your configuration and reduce the chance of misconfiguration.

Need help with CartDNA integration?

If you are updating credentials, changing payment providers, or preparing to go live, the CartDNA team can help you review the setup and reduce avoidable checkout issues.

Credential review guidance
Webhook setup checks
Configuration troubleshooting
Test and live launch support