Syncing Payments to NetSuite

This guide explains how MonetizeNow synchronizes payments to NetSuite, how invoice applications are handled, and what both systems display after a successful sync.

Overview

A payment becomes eligible for synchronization when:

1. Its status is SUCCESS.
2. It has been applied to an invoice in MonetizeNow.
3. The customer and target invoice already exist in NetSuite.

After these conditions are met, MonetizeNow creates the payment in NetSuite and allocates it to the corresponding invoice.

Payment Statuses

A payment’s status determines whether it is eligible for synchronization.

Applying Payments to Invoices

A successful payment must be applied to an invoice before NetSuite can allocate it.

The payment status confirms that the funds were collected. The invoice application identifies where those funds should be recorded.

Fully Applied Payment

When a successful payment is fully applied to an invoice, MonetizeNow synchronizes the payment and its allocation.

MonetizeNow

Payment:       $1,000
Status:        SUCCESS
Applied to:    INV-2041
Applied amount: $1,000
Unapplied:     $0

NetSuite

Payment:       $1,000
Allocated to:  INV-2041

Unapplied Payment

A successful payment can exist without being applied to an invoice.

Payment:       $1,000
Status:        SUCCESS
Applied to:    None
Unapplied:     $1,000

Until an invoice application is created, NetSuite has no invoice against which to allocate the payment.

Automatic Payment Application

MonetizeNow can automatically apply payments to open invoices using a first-in, first-out approach. The oldest eligible unpaid invoice is addressed first.

For example, a $1,000 payment applied across three open invoices may be distributed as follows:

NetSuite receives the same invoice allocations recorded in MonetizeNow.

When reviewing an automatically applied payment, use the payment’s allocation details to identify every invoice that received a portion of the payment.

NetSuite Dependencies

Before a payment can be synchronized, MonetizeNow must be able to identify the corresponding customer and invoice records in NetSuite.

Customer Association

The MonetizeNow account must be associated with a NetSuite customer. This association provides the customer information required to create the NetSuite payment record.

Invoice Association

Every invoice receiving a payment must have a NetSuite association in MonetizeNow. This association connects the MonetizeNow invoice ID to its corresponding NetSuite invoice ID.

The invoice must therefore be:

1. Created in MonetizeNow.
2. Exported to NetSuite.
3. Associated with the resulting NetSuite invoice record.
4. Available as a target for the payment application.

Payment Synchronization Sequence

The standard payment-sync sequence is:

1. A payment is created or collected in MonetizeNow.
2. The payment reaches the SUCCESS status.
3. The payment is applied to one or more invoices.
4. MonetizeNow resolves the associated NetSuite customer.
5. MonetizeNow resolves each target NetSuite invoice.
6. The payment is created in NetSuite.
7. NetSuite allocates the payment according to the MonetizeNow invoice applications.
8. MonetizeNow stores the resulting NetSuite association.

Reconciliation

After a successful synchronization, the invoice and payment balances should match across both systems.

For partially applied payments, compare:

• The original invoice amount.
• The amount applied to each invoice.
• The remaining invoice balance.
• Any unapplied payment balance.

Unlike service credits, a fully applied payment generally produces the same invoice balance in MonetizeNow and NetSuite.

Payment Previews

A preview can show how MonetizeNow expects a payment to be allocated, but it does not create a persistent invoice-application record.

The allocation becomes available for synchronization only after the payment application has been saved in MonetizeNow.

Frequently Asked Questions

Why is a payment visible in MonetizeNow but not in NetSuite?

First, check the payment status. Payments with a PROCESSING, FAILED, or CANCELED status are not eligible for synchronization.

If the payment status is SUCCESS, confirm that:

• The payment is applied to an invoice.
• The account is associated with a NetSuite customer.
• The target invoice exists in NetSuite.
• The target invoice has a NetSuite association in MonetizeNow.

Why is a successful payment not reducing the NetSuite invoice balance?

The payment may be unapplied in MonetizeNow or applied to a different invoice.

Review the payment’s allocation details rather than looking only at the expected invoice. Automatic application may have allocated the payment to an older invoice first.

Why was the payment applied to a different invoice?

MonetizeNow may automatically apply payments using a first-in, first-out approach. This means older eligible unpaid invoices are paid before newer invoices.

Review the payment’s allocation details to see the exact distribution.

Why is part of the payment still unapplied?

The payment amount may exceed the total eligible open invoice balance, or the payment may have been only partially allocated.

The unapplied portion remains available at the customer-account level until it is applied to another invoice.

Why did the allocation shown in the preview not appear in NetSuite?

A preview calculates the expected allocation but does not save an invoice-application record. Confirm that the application was finalized and appears in the payment’s saved allocation details.

Why did the payment sync run before the invoice was available in NetSuite?

The payment may have been created or applied before the invoice export and association were completed.

Wait until the invoice exists in NetSuite and its association is visible in MonetizeNow. Then retrigger the payment synchronization.

Why didn’t the payment retry automatically after the invoice association was created?

If the original payment sync ran before the invoice association existed, the payment may require a manual retry after all dependencies are available.

Confirm the invoice association first, then retrigger the payment sync.

Why did a payment update fail?

A payment update requires an existing NetSuite payment association. If the original create operation did not complete, the update has no NetSuite record to reference.

Resolve and retry the original create operation before retrying the update.

What happens when a payment moves from SUCCESS to FAILED or CANCELED?

MonetizeNow reverses the related invoice application. The payment is no longer eligible for active payment synchronization.

Review the current payment status and application records before attempting another sync.

What should I check before opening a support ticket?

Collect and verify the following:

• MonetizeNow account ID
• NetSuite customer ID
• MonetizeNow payment ID
• Current payment status
• Original payment amount
• Applied and unapplied amounts
• MonetizeNow invoice ID for every application
• NetSuite invoice ID for every application
• Customer-association status
• Invoice-association status
• NetSuite payment ID, if created
• Relevant sync timestamps
• Any connector error messages
• Whether the attempted operation was a create or an update