Skip to main content

Real-World Example

Jane has an installment payment due tonight. The scheduled payment command runs, checks that her account and payment method are eligible, then dispatches the correct merchant job for Authorize.net, Stripe, or USAePay.

Visual Flow

Schedule Ownership

YouNegotiate is the source of truth for payment-plan schedules. Merchant processors receive individual payment requests when a payment becomes due; they do not own the plan schedule. Processing must use the current scheduled date after any consumer-approved date change, frequency change, skip, hold, or restart. The platform schedule and BillPay Calendar must update before a payment request is sent. When a plan is on hold, scheduled payments and payment reminders remain suspended. Processing resumes only when the plan reaches an eligible restart state.

When the Gateway Does Not Answer

Jane’s installment is sent to USAePay at 19:00, but the request times out before USAePay replies. The money may or may not have been taken, so the portal treats the payment as unknown, not failed. The installment stays in processing, Jane is not told it failed, and her skip count does not change. A reconciliation check looks the charge up at the gateway by its saved reference within minutes and records the real result. This applies the same way to Authorize.net and USAePay. While a charge is unknown, the installment cannot be retried, so the consumer is never charged twice for it. Payments in review are listed for support on the Consumer Payment Review page.

Bank (ACH) Payments

Jane pays her installments from her checking account. When Authorize.net or USAePay accepts the ACH charge, the money has not moved yet; bank transfers take a few business days to settle.
  1. The installment and its transaction stay in processing. Jane’s balance is not reduced yet.
  2. Reconciliation checks the charge at the gateway until it settles.
  3. When it settles, the installment is marked successful, the balance is reduced, and Jane is told the payment went through.
  4. The payment is then checked once a day for 60 days in case Jane’s bank returns it. A return restores the balance exactly once. Manual payments (Pay Now, partial, extra, and Pay Remaining Balance) and Helping Hand gifts from a bank account are watched and reversed the same way; see Extra Payment and Helping Hand Gift Registry.
Card payments are recorded as successful as soon as the gateway approves them. Only bank payments wait for settlement.

How It Should Work

  • It should process due schedule transactions through the scheduled command and merchant-specific queued jobs.
  • It should check consumer status, accepted offer, merchant configuration, and payment profile before charging.
  • It should process only the most current active schedule after permitted plan changes.
  • It should keep schedule, payment history, and BillPay Calendar state aligned.
  • It should record success, failure, attempts, and payment history consistently.
  • It should avoid overlapping processing for the same scheduled transaction.
  • It should treat a timeout or unclear gateway reply as unknown and confirm the result with the gateway before recording it.
  • It should keep a bank (ACH) payment in processing until the gateway reports it settled, then watch it for returns for 60 days.

How It Should Not Work

  • It should not charge consumers whose plans are on hold or not eligible for processing.
  • It should not let a merchant processor become the source of truth for the payment schedule.
  • It should not process an outdated date after a skip, hold, restart, or date change.
  • It should not process the same scheduled transaction twice at the same time.
  • It should not bypass gateway-specific services or payment profile rules.
  • It should not mark an installment failed, add a skip, or send a failed-payment message while the gateway’s answer is still unknown.
  • It should not retry an installment while an earlier charge for it is still unconfirmed.
  • It should not reduce the balance for a bank (ACH) payment before it settles.
Last modified on November 10, 2026