How NetSuite Payment Gateways Work and What They Connect To

What NetSuite payment gateways do

A NetSuite payment gateway is the connection between your NetSuite accounting system and the bank or payment processor that actually moves money. When a customer pays you through NetSuite—whether by credit card, ACH transfer, or another method—the gateway encrypts that payment information, sends it to your processor, and reports back whether the transaction succeeded or failed. NetSuite itself does not hold the money or process the payment; it acts as the messenger and record-keeper.

NetSuite comes with built-in connections to several major payment processors. You choose which one to use based on your business type, the payment methods you want to accept, and the fees you are willing to pay. The gateway you select determines which payment types your customers can use, how quickly money lands in your bank account, and what reports you see inside NetSuite about each transaction.

The gateway also handles the compliance work behind the scenes—encrypting card data so NetSuite and your staff never see the full card number, and keeping your system compliant with payment card industry (PCI) standards. This is why using NetSuite's built-in gateways is safer than trying to process payments outside the system.

Key Takeaways

• NetSuite payment gateways connect your accounting system to a payment processor, encrypting customer payments and reporting results back into your records.
• NetSuite supports multiple gateway options—including Authorize.Net, Stripe, PayPal, and others—and you select the one that matches your payment methods and fee structure.
• The gateway you choose determines which payment types customers can use, how fast money reaches your bank, and what transaction data appears in NetSuite reports.
• Payment gateways handle PCI compliance automatically, so customer card data is encrypted and your staff never sees full card numbers.
• Gateway setup requires you to open a merchant account with your chosen processor, get API credentials, and configure the connection inside NetSuite.

Common NetSuite payment gateway options

NetSuite integrates with several processors out of the box. Authorize.Net is one of the oldest and most widely used; it accepts credit cards, debit cards, and ACH transfers, and works well for businesses that bill customers repeatedly. Stripe is popular with online retailers and SaaS companies because it has lower setup costs, transparent pricing, and handles international cards easily. PayPal and PayPal Commerce Platform let customers pay using their PayPal balance or linked bank account, which can increase conversion rates if your audience already uses PayPal.

Other gateways available through NetSuite include Square (good for in-person and online payments together), Adyen (strong for international transactions and multiple currencies), and CyberSource (owned by Visa, often used by large enterprises). Each has different fee structures, settlement speeds, and reporting capabilities. Some charge a flat monthly fee plus per-transaction costs; others charge only per transaction. Some deposit money into your bank account the next business day; others take three to five days.

Your choice depends on your business model. A subscription software company might choose Stripe for its recurring billing tools. A retail store might choose Square to accept both card-present and online payments. A B2B company billing other businesses might choose Authorize.Net for its strong ACH support and customizable invoicing.

How to set up a payment gateway in NetSuite

Before you configure anything inside NetSuite, you must open a merchant account with your chosen processor. This is a separate contract between you and the processor (or their bank partner). You will provide business information, tax ID, bank account details, and sometimes a processing history. The processor runs a background check and decides whether to approve you. This step can take a few days to a week.

Once your merchant account is approved, the processor gives you API credentials—usually a merchant ID, API key, and secret key. These are the passwords that let NetSuite talk to the processor on your behalf. Keep these secure; do not share them or paste them into email.

Inside NetSuite, go to Setup > Integrations > Payment Gateway Connections (the exact path varies slightly by NetSuite version). Create a new connection, select your processor from the list, and paste in your API credentials. NetSuite will test the connection by sending a small transaction to the processor and confirming it comes back. Once the test passes, the gateway is live and customers can pay through it.

You also configure which payment methods are visible to customers—for example, you might accept Visa and Mastercard but not American Express, or you might accept ACH but only for invoices over a certain amount. These rules live inside the gateway settings and control what payment buttons appear on your customer portal or invoice.

How payment data flows from customer to your bank

When a customer enters their card number on your NetSuite invoice or payment page, the browser encrypts it immediately using a technology called tokenization. The card number never reaches NetSuite's servers; instead, the gateway receives it directly and returns a token—a safe stand-in that NetSuite can store and use for future reference.

The gateway sends the encrypted payment to your processor, which checks with the customer's bank to confirm the funds are available and the card is valid. The bank approves or declines the transaction and sends the result back to the gateway. The gateway reports the outcome to NetSuite, which records it in your transaction history and updates the customer's invoice status.

If the payment is approved, the processor holds the money temporarily (usually 24 hours) and then deposits it into your bank account. The timing depends on your processor and your bank; some offer next-business-day settlement, others take three to five days. You can see the deposit status inside NetSuite and also inside your processor's dashboard.

If the payment is declined, NetSuite marks the invoice as unpaid and can automatically send the customer a notification. You can set up retry rules so NetSuite tries the payment again on a future date, which is useful for subscription billing.

Fees and what they cover

Payment gateway fees vary widely by processor and by payment method. A typical credit card transaction costs between 2.2% and 3.5% of the transaction amount, plus a per-transaction fee of 20 to 30 cents. ACH transfers usually cost less—often 1% or a flat fee like $1 per transaction. Some processors charge a monthly gateway fee (typically $10 to $30) whether you process payments or not; others charge only when you process.

International card payments usually cost more than domestic ones. Some processors charge extra for certain card types (like corporate or rewards cards) or for transactions flagged as high-risk. Chargebacks—when a customer disputes a charge and their bank reverses it—typically cost $15 to $100 per chargeback, plus you lose the original payment amount.

Before you sign up, ask your processor for a clear fee schedule in writing. Some processors hide fees in their terms or add surprise charges later. Compare the total cost across a few processors using your expected transaction volume and mix of payment types. A processor with a lower percentage rate but a higher monthly fee might be cheaper for a high-volume business but more expensive for a low-volume one.

Troubleshooting common gateway problems

If customers report that payments are failing, the first step is to check whether the gateway connection is still active. Inside NetSuite, go to your gateway settings and look for a status indicator or test button. Some gateways require you to refresh your API credentials periodically; if your credentials expired, the gateway will reject all payments.

If only certain payment methods are failing (for example, only Amex cards, or only ACH), check your gateway configuration to confirm that method is enabled and that you have not hit a processing limit. Some processors limit the number of ACH transactions per day or the total dollar amount you can process in a 24-hour window.

If a payment was charged to the customer but does not appear in NetSuite, the transaction may be stuck in a pending state. Check your processor's dashboard directly—it is the source of truth for what actually processed. NetSuite's records should match, but sometimes a sync delay causes them to fall out of step. Contact your processor's support team if a transaction processed on their end but never appeared in NetSuite.

If you are seeing a high rate of declined transactions, it may be a sign that your processor is flagging legitimate transactions as fraudulent. This can happen if your business model changed (for example, you started selling to a new geographic region) or if your processor's fraud rules are too strict. Ask your processor to review your decline rate and adjust their rules if needed.

Switching from one gateway to another

If you want to move to a different processor, you do not have to re-enter all your customer payment information. NetSuite stores payment tokens, not card numbers, so the tokens from your old processor will not work with your new one. However, you can set up the new gateway alongside the old one, and new payments will use the new gateway while old tokens remain in the system for reference.

Before you switch, confirm that your new processor supports all the payment methods you currently offer. Some processors do not accept certain card types or do not offer ACH in all states. Also check the settlement speed and fee structure to make sure the switch will actually save you money or improve your cash flow.

Once your new gateway is live in NetSuite, you can disable the old one. Existing invoices will still show the old payment method in their history, but new invoices will default to the new gateway. If you need to reprocess a failed payment on an old invoice, you may need to manually re-enter the customer's payment information or contact your processor to see if they can retrieve the old token.

Frequently Asked Questions

Can I use multiple payment gateways at the same time in NetSuite?

Yes. You can set up multiple gateways and choose which one to use for each customer, invoice, or payment method. This is useful if you want to accept both credit cards (through Stripe) and ACH transfers (through Authorize.Net), or if you want to test a new processor before fully switching over.

What happens if my payment gateway goes down?

If your processor's servers are unavailable, customers will not be able to pay through NetSuite until the service is restored. You can manually enter payments on their behalf, or direct customers to pay through an alternative method (like a wire transfer or check) until the gateway is back online. Most major processors have uptime guarantees of 99.5% or higher, so outages are rare but not impossible.

Do I need a separate merchant account for each payment gateway?

Yes, each processor requires its own merchant account. You can have multiple merchant accounts open at the same time, but each one is a separate contract with a separate processor or their bank partner. Some businesses maintain two or three merchant accounts for redundancy or to optimize fees for different payment types.

How long does it take for money to appear in my bank account after a customer pays?

Settlement time depends on your processor and your bank. Most processors deposit money within one to three business days. Some offer next-business-day settlement for an extra fee. Weekends and holidays can add delays. You can see the expected settlement date inside your processor's dashboard and also sometimes inside NetSuite's transaction records.

What if a customer disputes a charge after I have already received the money?

The customer's bank will reverse the charge and debit your merchant account. This is called a chargeback. You will lose both the original payment and the chargeback fee (typically $15 to $100). You can dispute the chargeback by providing evidence that the customer received the product or service, but the burden of proof is on you. NetSuite does not handle chargebacks directly; you manage them through your processor's dashboard.