n8n-nodes-tapsilat

This is an n8n community node for Tapsilat - a payment processing platform for Turkey.

It provides seamless integration with Tapsilat's payment APIs, allowing you to automate payment workflows including orders, subscriptions, refunds, and more.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Using npm

npm install n8n-nodes-tapsilat

Using n8n Community Nodes

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-tapsilat and confirm

Credentials

You'll need a Tapsilat API key to use this node:

1. Create an account at Tapsilat Dashboard
2. Navigate to API settings
3. Generate a new API key
4. Copy the Bearer Token

In n8n:

1. Go to Credentials > Add Credentials
2. Select Tapsilat API
3. Paste your Bearer Token
4. Optionally adjust the Base URL (default: https://panel.tapsilat.dev/api/v1)

Operations

Order

| Operation | Description | |-----------|-------------| | Create | Create a new payment order | | Get | Get an order by reference ID | | Get Status | Get the status of an order | | Get Many | Get multiple orders with pagination | | Cancel | Cancel an existing order | | Refund | Process a partial refund | | Refund All | Process a full refund | | Terminate | Terminate an order | | Get Payment Details | Get payment details for an order | | Get Transactions | Get transaction history | | Get Checkout URL | Get the checkout URL | | Manual Callback | Trigger manual callback |

Payment Term

| Operation | Description | |-----------|-------------| | Create | Create a payment term for an order | | Get | Get a payment term | | Update | Update a payment term | | Delete | Delete a payment term | | Refund | Refund a payment term | | Terminate | Terminate a payment term |

Subscription

| Operation | Description | |-----------|-------------| | Create | Create a new subscription | | Get | Get a subscription by reference ID | | Get Many | Get multiple subscriptions | | Cancel | Cancel a subscription | | Redirect | Get redirect URL for subscription |

Organization

| Operation | Description | |-----------|-------------| | Get Settings | Get organization settings |

Health

| Operation | Description | |-----------|-------------| | Check | Check API health status |

Usage Examples

Create an Order

1. Add the Tapsilat node to your workflow
2. Select Order as Resource
3. Select Create as Operation
4. Fill in the required fields:
   • Amount: 100.00
   • Currency: TRY
   • Locale: tr
   • Buyer Name: John
   • Buyer Surname: Doe
   • Buyer Email: [email protected]
   • Buyer Phone: 5551234567
5. Execute the node

Process a Refund

1. Add the Tapsilat node to your workflow
2. Select Order as Resource
3. Select Refund as Operation
4. Enter the Reference ID of the order
5. Enter the refund amount
6. Optionally add a reason

Development

# Clone the repository
git clone https://github.com/tapsilat/tapsilat-n8n-node.git

# Install dependencies
pnpm install

# Build
pnpm run build

# Run tests
pnpm test

# Link for local testing
pnpm link

Resources

• n8n Community Nodes Documentation
• Tapsilat Documentation
• Tapsilat SDK

License

MIT