forumNew topic

Payment gateway API integration — who covers the cost and ongoing maintenance?

İİlknur Y***MemberCommunity member
Joined
Feb 2023
Message
98
#1

We're a 12-person company in Mexico manufacturing and selling wholesale/retail office furniture. We signed a 140.000 MXN contract with a local dev agency to modernize our existing e-commerce site. The design and catalog phases are done, and now we're onto the checkout step.

The agency is asking for an extra 35.000 MXN to build a custom API integration for the region's main payment gateway. Their reasoning is that instead of an off-the-shelf plugin, they'll build a custom API tailored to our corporate invoicing and installment plans. On top of that, they want to bill us 850 MXN per hour for maintenance to handle webhook errors or API version updates post-launch.

Is it standard practice for an agency contracted to build an e-commerce site to charge for the payment connection as a separate line item? More importantly, who is on the hook if payment bugs or security vulnerabilities pop up after integration?

SSelin Ö***MemberCommunity member
Joined
Nov 2025
Message
336
Most Helpful#2

Short answer: Setting up standard, ready-made plugins should be covered under the main website budget, but direct API integrations involving custom business logic, multi-tier installment setups, or tailored ERP/accounting sync are legitimately billed separately by agencies. That said, the contract must strictly define liability boundaries and a warranty period for any defects.

Liability in payment systems splits into two distinct parts: 1) Security and Compliance: Card data security, encryption, and fraud prevention fall squarely on your payment gateway provider and PCI-DSS compliance. The agency should never store raw card data in your database; they must rely entirely on tokenization provided by the gateway. 2) Integration Integrity: Handling webhook endpoints reliably, accurately updating order statuses, and serving clear error messages to the customer during failed transactions are the agency's responsibility.

Don't jump on that 850 MXN/hour maintenance offer just yet. Insist on a free warranty and bug-fixing window of at least 60 to 90 days after delivery. Webhook dropouts or dropped connections during the first month post-launch aren't new scope; they're standard debugging of work already delivered. Maintenance fees should only apply to downstream events, like migrating to a breaking API version released by the gateway provider months later.

ÜÜlkü Ç***Member
Job title
Technical service technician
Sector
Jewelry
Organization type
120-person company
Joined
Dec 2025
Message
336
#3

If they're writing a custom API, the agency must commit to two core things: 1) Using idempotency keys (so a customer clicking the button twice doesn't get double-charged). 2) Queueing webhook notifications. Skip these safeguards, and whenever a connection drops, the customer gets charged but no order is created on your site.

KKadirMember
Job title
Shipping company
Organization type
family business
Joined
Jul 2024
Message
92
#4

Before signing anything, test the payment gateway's off-the-shelf module yourself to see if it actually handles your installment requirements. Agencies sometimes turn a 2-hour plugin install into a "custom API project" just to pad the invoice.

SSelin P***Member
Job title
Customer service representative
Sector
Freight
Organization type
early-stage startup
Joined
Nov 2024
Message
130
#5

In the Mexico City market, 35.000 MXN is pretty much the upper limit for a custom API integration. We paid 28.000 MXN for a similar corporate integration last fall, and that included a 3-month technical support warranty.

DDoruk Ş***MemberCommunity member
Joined
Oct 2024
Message
218
#6

Get an explicit clause added to the contract: "Software bugs resulting from the integration will be resolved by the contractor free of charge for 90 days following the go-live date." That protects you from surprise bills during the first few weeks.

ZZafer K***Member
Job title
Clinic manager
Sector
Law
Organization type
regional distributor
Joined
Nov 2023
Message
344
#7

With hourly maintenance deals, you risk the agency billing you hourly just to fix their own broken code. If you don't draw a hard line between bug fixes and new feature requests, you'll be stuck paying 850 MXN every single month.

VVeli D***Member
Job title
Network Administrator
Sector
Education
Organization type
two-branch business
Joined
May 2022
Message
107

Doki · Infrastructure migration · 2023

#8

sucks that this wasn't brought up on day one but payments are the backbone of the site.. and paying up front for a clean, custom API instead of hacking together a cheap pre-built plugin saves you from lost revenue down the line.

ÜÜmit Ö***Member
Job title
Sales Manager
Sector
Printing
Organization type
medium-sized business
Joined
Nov 2024
Message
108
#9

Bottom line: asking for extra budget for a custom API is normal, but don't commit to that maintenance fee right away. Lock down a 90-day warranty first, put the token-based architecture in writing, and make double-charge protection a requirement.

OOnur E***MemberCommunity member
Joined
Mar 2026
Message
63
#10

I think differently. honestly everyone rushing into payment API integration gets stuck at the same point.

This is my opinion, Im not claiming its absolute truth.

LLeyla O***Member
Job title
Field sales representative
Sector
Paper
Organization type
boutique agency
Joined
Feb 2024
Message
21
#11

We got stuck at the same point for a while. Don't hesitate to ask; those who don't ask always pay more.

Good luck with that.

NNuri E***Expert
Job title
General coordinator
Sector
Leather
Organization type
regional distributor
Joined
Feb 2023
Message
386
#12

Do you think this works at any scale? When making a decision, first look at what data you have on hand.

İİlknur Y***VeteranCommunity member
Joined
Jul 2022
Message
3
#13

You're right, I've been down that road too. Don't hesitate to ask; those who don't ask always pay more.

That's all, sorry if I went on too long.

MMelikeExpert
Job title
E-commerce Manager
Organization type
boutique agency
Joined
Sep 2023
Message
178
#14

Let me summarize what's been said so far. Any unwritten clause becomes a point of disagreement later, as both sides remember it differently.

When we decide without measuring, we always end up in the same place. Just leaving this note, it might be useful.

CCansu I***VeteranCommunity member
Joined
Jul 2022
Message
377
#15

I have an objection here. If you don't write this down from the start, it leads to arguments later.

Just leaving this note it might be useful.

ZZehra C***Member
Job title
Software developer
Sector
Consulting
Organization type
8-person team
Joined
Mar 2023
Message
94
#16

There's a trap here let me mention it. The biggest time-waster for us was not knowing who had the final say.

The biggest time-waster for us was not knowing who had the final say.

YYiğit Y***New member
Job title
Sales Manager
Sector
Machinery manufacturing
Organization type
a company within a holding
Joined
Aug 2026
Message
4
#17

I have no experience with payment API integration, so I'm asking. Everything goes well for the first three months; problems arise in the fourth.

People defend habits not processes. Resistance comes from there.

OOsman K***Expert
Job title
Software developer
Sector
Education
Organization type
two-branch business
Joined
Dec 2023
Message
23
#18

I felt relieved reading this answer, so it's not just me. Code without setup documentation isn't yours, even if you have it.

Proven by experience.

KKaanMember
Job title
Product Manager
Joined
May 2024
Message
96
#19

Let me share what happened to me; it might be useful. The cheapest quote is usually the least thought-out one.

Good luck with that.

İİlaydaMember
Job title
Customer Support Manager
Joined
May 2024
Message
124
#20

Timely topic.

This topic has been closed.The moderator marked the topic as resolved. If you have a similar issue, you can open a new topic.
New topic