OnlineCheckWriter icon

OnlineCheckWriter

Complete payment processing suite - checks, ACH, wire transfers, virtual cards, and document mailing

Actions13

Overview

This node integrates with the OnlineCheckWriter service to create and manage checks programmatically. Specifically, the Check - Create operation allows users to generate a new check linked to a specified bank account and payee. It supports detailed customization such as setting the check amount, delivery method, memo, priority, and address details.

Typical use cases include automating payroll, vendor payments, or any scenario where issuing physical or electronic checks is required. For example, a company could automatically create and mail rent payment checks each month or issue refunds via printed or electronic checks without manual intervention.

Properties

Name Meaning
Bank Account ID The identifier of the bank account from which the check will be drawn. This must correspond to an existing bank account in the OnlineCheckWriter dashboard.
Payee ID The identifier of the payee who will receive the check. The payee must be created beforehand in OnlineCheckWriter to obtain this ID.
Amount The monetary value of the check in USD. Supports decimal values with two digits precision (e.g., 100.00). Must be at least $0.01.
Additional Fields A collection of optional fields to further customize the check:
  Address Line 1 First line of the payee's address (e.g., street address).
  Address Line 2 Second line of the payee's address (optional).
  Check Number Custom check number. If not provided, the system auto-generates one.
  City City of the payee's address.
  Date Date of the check. Defaults to the current date if not specified.
  Delivery Method How the check should be delivered. Options: Print Only (manual delivery), Mail (print and mail), Electronic (send electronically if supported by payee). Default is Print Only.
  Description Internal description for the check, not printed on the actual check.
  Email Notification Email address to notify when the check is processed.
  Memo Memo line that appears on the check (e.g., invoice number).
  Print in Color Boolean flag indicating whether the check should be printed in color. Default is false.
  Priority Processing and delivery priority. Options: Standard (3-5 business days), Rush (1-2 business days), Overnight. Default is Standard.
  Reference Number Internal reference number for tracking purposes (not printed on the check).
  State Two-letter state code of the payee's address (e.g., CA).
  ZIP Code ZIP code of the payee's address.

Output

The node outputs JSON data representing the result of the check creation operation. This typically includes details about the newly created check such as its unique ID, status, and any metadata returned by the OnlineCheckWriter API.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with the error message, resource name, operation name, and the index of the item that caused the failure.

The node does not output binary data.

Dependencies

  • Requires an API key credential for OnlineCheckWriter configured in n8n.
  • Internet access to communicate with the OnlineCheckWriter API endpoints.
  • Proper setup of bank accounts and payees within the OnlineCheckWriter dashboard prior to creating checks.

Troubleshooting

  • Common Issues:

    • Invalid or missing bank account or payee IDs will cause errors.
    • Amounts less than $0.01 or improperly formatted amounts may be rejected.
    • Providing invalid dates or unsupported delivery methods can cause failures.
    • Network connectivity issues or incorrect API credentials will prevent successful API calls.

  • Error Messages:

    • "Unknown resource: check" — indicates the resource parameter was incorrectly set; ensure it is exactly "check".
    • API errors returned from OnlineCheckWriter will be passed through; check the error message for details such as invalid IDs or insufficient permissions.
    • If the node throws errors related to missing parameters, verify all required fields are filled.

  • Resolution Tips:

    • Double-check all IDs against the OnlineCheckWriter dashboard.
    • Use valid email addresses for notifications.
    • Enable "Continue On Fail" during testing to capture errors per item without stopping the workflow.
    • Review API key permissions and validity.

Links and References

Discussion