How Do You Set Up E-Commerce Payment Integration, Step by Step?

The most fragile moment in online selling is the second the customer types in their card number. If the browser shows a warning, the basket closes. In this article we take on the three tools e-commerce payment integration requires: the SSL certificate, 3D Secure and the virtual POS connection. We set out the order of installation, the verification tests and the configuration mistakes we run into most often. Our aim is simple: know where to start the setup.

Written and reviewed by Digital Marketing Specialist

Abstract 3D image with three transparent shields, representing the security layers of online payment collection
Encryption, authentication and collection: the three layers that guard the till. Image generated with AI.
Category E-Commerce
PublishedUpdated
Reading7 min
Section7 sections
Section 0101 / 07

What Exactly Does E-Commerce Payment Integration Cover?

E-commerce payment integration is the technical connection that carries card data between the shop software and the bank, built with the SSL, 3D Secure and virtual POS tools. There are three layers: transport security, authentication and collection. Each layer has its own tool and its own test method. If one layer is missing, the bank treats the transaction as risky.

Separating the layers in e-commerce payment integration separates responsibility too. The SSL certificate sits on your server. 3D Secure runs at the cardholder's bank. The virtual POS definition is opened by the bank or payment institution you have an agreement with. When something goes wrong, that separation tells you which door to knock on. So where should testing start? On all three the same day: the layers of an e-commerce payment integration only give a reliable answer when they are tried together. In our e-commerce development service we bring these three layers together in a single setup plan.

Where do the virtual POS, the payment gateway and the bank come in?

The virtual POS is the virtual card terminal the bank allocates to your business. The payment gateway is the software bridge that carries messages between the shop and that terminal. The customer enters their card, the bridge passes the request to the bank, and the bank returns an authorization response. In the integration, the collection line that connects the e-commerce shop to the bank has to run without a break across all three stops; if a single link goes, the transaction fails.

Section 0202 / 07

How Is an SSL Certificate Installed Correctly?

A correct installation is three pieces of work: domain verification, loading the certificate chain in full, and redirecting all HTTP traffic to HTTPS. An SSL certificate is the digital identity that encrypts traffic between the browser and the server. If you don't set up the redirect, the payment page throws a mixed content warning. A customer who sees that warning does not type in their card details.

The job isn't finished once the certificate is installed. If an intermediate certificate is missing from the chain, a desktop browser will not show the problem while older Android devices throw an error. That is why we check the installation with an external testing tool and on a real handset, separately. We add the HSTS header too, so the browser only ever connects to the site with TLS encryption. The scale of online trade in Türkiye is growing fast: the ETBİS 2025 report — ETBİS is Türkiye's central e-commerce information system — puts the number of businesses trading online at 634,611. At that scale, e-commerce payment integration is not an optional extra.

What is the difference between DV, OV and EV certificates?

A DV certificate verifies domain ownership only and is issued within minutes. An OV certificate also checks the company registration. An EV certificate calls for the most detailed examination of all. The strength of the encryption is identical in all three; what differs is how thoroughly the identity is vetted. We recommend OV for corporate shops, because the details of the legal entity appear inside the certificate.

Section 0303 / 07

Why Is 3D Secure Integration Indispensable?

In Türkiye, banks treat 3D Secure as effectively compulsory for online sales made with consumer cards. 3D Secure is the secure authentication layer that verifies the cardholder through their bank. If verification succeeds, liability for a fraud claim passes to the bank. The step most often skipped during setup is recalculating the signature on the verification response server-side.

The flow works like this: the customer enters their card details, the payment bridge redirects the request to the bank, and the bank asks for a one-time code or an in-app approval. The approval comes back to the shop as a signed message. If you confirm the order without verifying that message, you have left a door open. Have the signature checked by the server, not the browser. In the payment flow, that single rule cuts off fake approvals at source. On the custom software side we gather that check into a single verification service.

Why does the 3DS 2.0 flow put less strain on the customer?

3DS 2.0 carries device and behavioural data to the bank during the transaction. If the bank judges the risk to be low, it asks the customer for no code at all; the transaction goes through quietly. We call that the frictionless flow. On attempts it finds risky, the verification screen appears as before. The result is clear: basket abandonment falls without security falling with it.

In what situation is a non-secure transaction enabled?

Non-secure is the transaction type taken without asking the cardholder to verify. On foreign cards or subscription renewals, some providers may grant limited permission. Responsibility stays entirely with the shop. Before opening that door, we assess your chargeback risk and your business model together.

Section 0404 / 07

From the Virtual POS Application to the Live Environment

The process runs in two stages: approval of the paperwork and handover of the technical keys. A virtual POS application is a commercial contracting process signed with a bank or payment institution. The provider asks for the tax registration certificate, the signature circular, the site address and the distance selling agreement. It hands over the live key only after reviewing the content of the site.

The content of the site matters as much as the document file. If the distance selling agreement, the cancellation and returns conditions, the delivery time and the contact details are not visible on the page, the file comes back. On the technical side of the integration, the only difference between your e-commerce site's test environment and its live environment should be the key. Same code, same flow, different key. Making the key the only difference puts an end to go-live surprises.

Which card scenarios do we try in the test environment?

A successful charge, insufficient funds, an incorrect CVV, a cancelled 3D verification and a timeout. We try all five scenarios separately for every bank. If there is instalment selling, we check that the instalment table matches the order summary exactly. We don't skip the partial refund test; the most frequent complaint on the accounting side comes from there.

“When the payment methods used in e-commerce are examined, card payments rank first with 62.5%.”

— Ministry of Trade of Türkiye, E-Commerce Outlook in Türkiye Report 2025 (PDF)
Section 0505 / 07

Which Tests Should You Run After the Integration?

Once you are live, three checks are essential: a low-value order on a real card, the refund flow, and the order notifications. Those three catch the silent faults, such as the payment appearing to succeed while no order is created. We repeat the tests daily through the first week. We log every error that comes up with a screenshot. That record speeds up the correspondence with the bank.

The silent fault is the most expensive failure in an e-commerce payment integration. The customer pays, the order doesn't appear in the list, and the call centre hears about it the next day. That is why we match the payment record against the order record in two separate places. A daily reconciliation report shows the transactions that don't line up at a glance. A well-built e-commerce payment integration tells you about the fault before the customer does. On the e-commerce SEO side too, we count drop-offs at the payment step as lost conversion.

Why are webhook and callback verification critical?

The callback is the payment result coming back through the customer's browser. The webhook is the notification the provider sends straight to your server. If the customer closes the page early the callback is lost, while the webhook still arrives. That is why we tie order status to the webhook. We compare the signature and the amount of every incoming notification against the order record.

Section 0606 / 07

Secure Payment Integration: A 7-Step Setup List

The order is this: SSL, legal pages, virtual POS application, test scenarios, 3D Secure signature verification, webhook connection, live transaction. When that order breaks down, the setup gets expensive. You can use the seven steps below as a checklist. Each step ends in a concrete output. You'll see the step you've missed as plainly as reading a table.

We drew the list from our own installations in the field.

  1. Install an SSL certificate on the domain and redirect all traffic to HTTPS.
  2. Publish your distance selling, returns and privacy pages.
  3. Submit your virtual POS application to a bank or payment institution.
  4. Try the five card scenarios with the test keys.
  5. Verify the signature on the 3D Secure response server-side.
  6. Tie order status to the webhook notification.
  7. Make a low-value real transaction with the live key, then refund it.

If you have completed the seven steps, your e-commerce payment integration is ready to go live. If you'd like to run the setup with us, get in touch through the quote form and we'll review your existing infrastructure and draw up a step list to fit your business.

Which indicators do we watch in the first 30 days?

Success rate per attempt, 3D verification completion rate, number of refunds and the reconciliation difference. We track those four indicators in a weekly table. If the success rate drops noticeably, we look first at a rule change on the bank's side. Then we open up the device breakdown; the problem usually clusters in a single family of devices.

Abstract 3D image with a beam of light passing through a keyhole, representing encrypted data transfer
Verifying the signed response message server-side closes the open door. Image generated with AI.
Section 0707 / 07

Payment Integration Methods Compared

The four methods differ by setup burden and by where card data sits. A bank virtual POS is heavy to set up and routes card data through your server; it suits high volume with one bank. Payment institutions offer multi-bank instalments at medium effort. Hosted pages and wallet buttons keep card data away from you.

MethodSetup burden3D SecureCard dataSuitable scenario
Bank virtual POSHighManaged by the shopPasses through your serverHigh volume with a single bank
Payment institutionMediumManaged by the providerWith the providerMulti-bank instalments
Hosted payment pageLowWith the providerNever touches itA shop with no technical team
Wallet buttonLowIn the walletIn the walletRecurring mobile sales

Which Tools Secure the Payment Step?

The payment step is your shop's till. We secure that till with three tools: SSL, 3D Secure and a correctly configured virtual POS. An e-commerce payment integration that puts the setup in order, brings discipline to the testing and automates the reconciliation lowers both basket abandonment and the operational load. Before you begin, let's go over your existing infrastructure together.

FAQs

Frequently asked questions: e-commerce payment integration

Can I apply for a virtual POS without an SSL certificate?

No. Providers want a domain that is already live over HTTPS in the application file.

How long does a payment integration take to set up?

If the paperwork is complete, approval of the application takes a few working days. On a shop running on an off-the-shelf platform, the technical connection usually fits into a week. If custom development is needed, it takes longer.

Is it possible for me to switch 3D Secure off?

On consumer cards, not in practice. Providers may grant non-secure permission in a limited set of scenarios. In that case the shop carries the cost of any fraud claim, which is why we take that decision together with the business model.

Should I choose a bank virtual POS or a payment institution?

If you work at high volume with a single bank, a direct bank connection makes sense. If you want to show instalment campaigns from several banks, a payment institution offering a single API shortens the setup.

Does selling in instalments need an extra integration?

No extra connection is needed; the instalment table comes back from the same service. What you do need is to show that table in the order summary and price in the commission difference.

Can I store card details in my own database?

We advise against it. Holding card data on your server brings you into PCI DSS scope; it creates obligations for audit, network segmentation and penetration testing. At SME scale, that cost is rarely worth carrying. If you need recurring payments, use tokenization: the provider stores the card on its own side and returns you nothing but a key that can be used to make a transaction. That way the card number never enters your system at all, and your area of responsibility narrows if there is ever a breach. On new builds we choose this route by default.

Is going live without a test environment risky?

Yes. Without test keys you cannot try refund, cancellation and error scenarios. An error that surfaces on the first real order costs you both the money and the customer.

Does the same integration work in a mobile app?

The same virtual POS definition is used; the flow differs. Inside the app you need to open the 3D verification screen in a secure browser component. Update the order status through the webhook, as before.