n8n-nodes-tbank

Overview

Integrate Tinkoff Business Acquiring v2 payments, recurring billing, and webhook handling into n8n workflows.

Nodes & Operations

Tinkoff Business

Manages payment lifecycle, recurring card enrollment, and related operations via the Tinkoff Business API.

• Payment · Initialize Payment — Initialize a payment session with Tinkoff Business by specifying the payment amount, order ID, and optional customer contact details, with support for two-stage (held) payments.
• Payment · Confirm Payment — Confirm a previously initialized payment by its Payment ID, optionally specifying an amount in kopecks for a partial confirmation.
• Payment · Cancel Payment — Cancel a payment in the Tinkoff Business Acquiring system by providing the unique Payment ID.
• Payment · Refund Payment — Refunds a payment identified by its Payment ID, optionally specifying an amount (in kopecks) to partially refund.
• Payment · Get Payment Status — Retrieve the current status of a specific payment by providing its Payment ID to the Tinkoff Business payment system.
• Recurring · Save Card (Add Customer) — Save a customer's payment card by adding a new customer and initiating a minimal recurring payment session to bind the card to that customer in Tinkoff Business.
• Recurring · Autopayment (Charge) — Charge a saved customer card using Tinkoff Business recurring payments by specifying the customer key, the previously obtained Rebill ID (optional), and the charge amount in kopecks.
• Recurring · List Saved Cards — Retrieve a list of all saved payment cards associated with a specific customer key in the recurring payments context.
• Recurring · Remove Card — Remove a saved card associated with a customer using their Customer Key and the card's Rebill ID (Card ID) in the Tinkoff Business Recurring payments system.
• Reports · List Transactions (Not Supported) — Reject the operation with an error indicating that listing transactions under the Reports resource is not supported because Tinkoff Acquiring v2 API does not provide these endpoints.
• Reports · Export Registry (Not Supported) — Throw an error indicating that the Reports API endpoints, including Export Registry, are not supported in Tinkoff Acquiring v2 and cannot be used in this operation.
• Reports · Reconcile Payments (Not Supported) — Reject calling the reconcile payments operation, as the Reports API endpoints are not supported by Tinkoff Acquiring v2.
• Webhook · Default — Handle incoming webhook POST requests from Tinkoff Business by validating the webhook token signature and returning the payload data for workflow use.

Installation

Install as an n8n community node: in n8n, open Settings → Community nodes → Install and enter n8n-nodes-tbank. See the n8n community nodes installation guide.