Overview

This node operation allows users to pay an existing order in the Square system by specifying the order ID and optionally providing approved payment IDs and additional fields such as an idempotency key and order version. It is useful for automating payment processing for orders within workflows, ensuring payments are applied correctly and only once using idempotency keys.

Use Case Examples

1. Pay an order by providing the order ID and a list of approved payment IDs to apply to the order.
2. Use the idempotency key to ensure the payment request is not duplicated in case of retries.
3. Specify the order version to handle concurrency and ensure the correct version of the order is paid.

Properties

Output

JSON

• idempotency_key - Unique key to ensure the payment is applied only once.
• payment_ids - List of payment IDs applied to the order.
• order_version - Version number of the order being paid.

Dependencies

• Square API with authentication via an API key credential

Troubleshooting

• Ensure the Order ID is valid and exists in the Square system to avoid errors.
• Payment IDs must be approved and valid; otherwise, the payment request will fail.
• Idempotency key should be unique per payment attempt to prevent duplicate payments.
• If the order version is specified, it must match the current version of the order to avoid concurrency errors.