Multi-Currency Adapter for Stripe – Customer Documentation

Step 1: Create a New Workflow

1. Open your n8n instance (cloud or self-hosted)
2. Click New Workflow
3. Name it "Stripe Multi-Currency Balance Monitor"

Step 2: Add HTTP Request Node

1. Drag and drop an HTTP Request node onto the canvas
2. Configure the node:
   • Method: GET
   • URL: https://stripe-multicurrency-adapter.round-cloud-7d27.workers.dev/v1/accounts/{accountId}/balance/EUR
   • Authentication: Generic Credential Type
   • Header Name: Authorization
   • Header Value: Bearer YOUR_API_TOKEN
3. Click Send Test Request to verify the connection

Step 3: Parse JSON Response

1. Add a Code node after the HTTP Request node
2. Use this JavaScript to extract balance and transactions:

   const response = $input.item.json;
   return {
     accountId: response.account.id,
     currency: response.account.currency,
     balance: response.account.balance / 100, // Convert from cents
     transactions: response.transactions?.map(t => ({
       id: t.id,
       amount: t.amount / 100,
       date: new Date(t.created * 1000).toISOString(),
       description: t.description
     })) || []
   };

Step 4: Add Schedule Trigger (Optional)

1. Add a Schedule Trigger node at the start
2. Set it to run every hour, daily, or as needed
3. Connect it to your HTTP Request node

Step 5: Add Conditional Logic

1. Add an IF node after the Code node
2. Set conditions like:
   • Balance below threshold → Send alert
   • Large transaction detected → Notify team
   • New currency detected → Create new account

Step 6: Add Action Nodes

Based on your conditions, add nodes to:

• Send Email (Gmail, Outlook, SMTP)
• Send Slack Message to your finance channel
• Update Google Sheets with balance data
• Create Airtable Record for transaction tracking
• Post to Webhook to trigger other systems

Step 1: Your API Endpoint

Your app exposes currency-specific endpoints. Here's an example using curl:

curl -X POST \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://stripe-multicurrency-adapter.round-cloud-7d27.workers.dev/v1/accounts/{accountId}/balance/EUR?transactions=true

Response:

{
  "account": {
    "id": "stripe_EUR",
    "currency": "EUR",
    "balance": 310010  // Amount in cents (3100.10 EUR)
  },
  "transactions": [
    {
      "id": "txn_123",
      "created": 1703123456000,
      "amount": 50000,
      "fee": 1500,
      "net": 48500,
      "type": "charge",
      "description": "Payment for invoice #123"
    }
  ]
}

Each currency (EUR, USD, GBP, etc.) has its own endpoint. You'll create separate QuickBooks bank accounts for each currency.

Step 2: Create Make.com Scenario

1. Create a new scenario in Make.com

   Name it "Stripe to QuickBooks Multi-Currency Sync"

2. Add Schedule Trigger

   Set it to run daily (or as often as needed) to keep balances in sync

3. Add HTTP Module (POST Request)

   • Method: POST
   • URL: https://stripe-multicurrency-adapter.round-cloud-7d27.workers.dev/v1/accounts/{accountId}/balance/EUR
   • Authentication: Bearer Token
   • Token: YOUR_API_TOKEN (in Authorization header, not URL)
   • Query Parameters: ?transactions=true (optional, e.g., ?from=2024-01-01&to=2024-01-31&limit=50)

   Create separate HTTP modules for each currency (EUR, USD, GBP, etc.)

4. Add Iterator Module

   If you want to process multiple currencies in one scenario, use an Iterator to loop through currencies. Otherwise, create separate HTTP modules for each currency.

5. Add QuickBooks Online Module

   Connect your QuickBooks account and configure:

   • Action: Create Journal Entry (or Update Bank Account Balance)
   • Account: Stripe EUR Bank Account (create this in QuickBooks first)
   • Amount: {{balance}} / 100 (convert from cents)
   • Currency: EUR
   • Date: Current date
   • Memo: "Stripe EUR Balance Sync"

6. Repeat for Each Currency

   Create separate QuickBooks modules for USD, GBP, and other currencies. Each should update its corresponding bank account in QuickBooks.

Example Make.com Scenario Structure