For Agents
Open Lemonway accounts, accept card and SEPA payments, run P2P transfers and payouts, refund transactions, and reconcile balances and disputes for marketplace and fintech apps.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Lemonway API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Lemonway API.
Open and manage per-user Lemonway accounts including blocking and unblocking flows
Accept money-in via web card payment, PayPal, SEPA direct debit, or virtual IBAN bank transfer
Send money-out via SEPA transfer to a registered IBAN for marketplace seller payouts
GET STARTED
Use for: Open a new Lemonway account for a marketplace seller, Initiate a card payment for a buyer, Send a SEPA payout to a seller's IBAN, Refund a specific money-in transaction
Not supported: Does not handle KYC document verification, accounting, or tax filing — use for account, money-in, money-out, P2P, refunds, and disputes only.
Jentic publishes the only available OpenAPI specification for Lemonway API, keeping it validated and agent-ready. The Lemonway API is a European payments and e-money platform built around per-user accounts: agents can open accounts, block or unblock them, list balances and transactions, take money in via card, PayPal, SEPA direct debit, or virtual IBAN bank transfer, send payouts via SEPA transfer, run peer-to-peer transfers between accounts, issue refunds, and list disputes. OAuth client-credentials issues a bearer token that is sent on subsequent calls.
Run P2P transfers between two Lemonway accounts for marketplace settlement
Issue refunds against a money-in transaction and confirm the new transaction state
List balances, transactions, and disputes per account for finance reconciliation
Patterns agents use Lemonway API for, with concrete tasks.
★ Marketplace Seller Onboarding and Payouts
Onboard a marketplace seller and pay them out at the end of the cycle. The agent calls POST /v2/accounts to open the seller account, registers the IBAN via POST /v2/moneyouts/iban, and at payout time calls POST /v2/moneyouts/transfer to send the SEPA transfer. Replaces the manual onboarding ticket queue and lets payouts run on schedule.
POST /v2/accounts for the seller, POST /v2/moneyouts/iban with their IBAN, then POST /v2/moneyouts/transfer at payout time.
Web Card Checkout for a Marketplace Buyer
Take a card payment from a buyer and credit the platform's holding account. The agent calls POST /v2/moneyins/cards/web/init with the amount and return URL, redirects the buyer to the hosted card page, and then verifies the resulting state via GET /v2/moneyins/{id}. The funds are then available for split or P2P transfer to the seller.
POST /v2/moneyins/cards/web/init with the order amount, redirect the buyer to the hosted page, and confirm the result with GET /v2/moneyins/{id}.
Refund and Dispute Reconciliation
Run finance reconciliation across refunds and disputes. The agent issues refunds via PUT /v2/refunds/{id} where required, lists open disputes through GET /v2/disputes, and joins the data to internal order records. Removes the manual export-and-pivot workflow that finance teams typically run on a Lemonway dashboard.
PUT /v2/refunds/{id} for the queued refunds and GET /v2/disputes to pull open disputes, joining both to the internal order ledger.
P2P Transfer Between Buyer and Seller Accounts
Move funds from a buyer's holding account to the seller's account inside Lemonway after the order ships. The agent calls POST /v2/p2p with both accountIds and the amount, then confirms the new balances via GET /v2/accounts/{accountid}/balances. Avoids re-running card capture and keeps the marketplace ledger consistent.
POST /v2/p2p with the buyer and seller accountIds and the order amount, then GET /v2/accounts/{accountid}/balances on both to confirm.
AI Agent Marketplace Operator via Jentic
An AI agent built on Jentic acts as a junior payments operator: it opens accounts on demand, runs payouts, and resolves refund tickets without the operator touching the API directly. Jentic isolates the OAuth client credentials so the agent never holds the raw bearer token between calls.
Through Jentic, search 'open lemonway account', execute POST /v2/accounts for the new seller, then chain to POST /v2/moneyouts/iban and POST /v2/moneyouts/transfer when the payout is due.
17 endpoints — jentic publishes the only available openapi specification for lemonway api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v2/accounts
Create an account
/v2/accounts/{accountid}/balances
Get account balances
/v2/moneyins/cards/web/init
Initiate a hosted web card payment
/v2/moneyins/bankwire/iban/create
Create a virtual IBAN for incoming wires
/v2/moneyouts/iban
Register an IBAN for payouts
/v2/moneyouts/transfer
Send a SEPA payout
/v2/p2p
Run a P2P transfer between two accounts
/v2/refunds/{id}
Issue a refund against a money-in transaction
/v2/accounts
Create an account
/v2/accounts/{accountid}/balances
Get account balances
/v2/moneyins/cards/web/init
Initiate a hosted web card payment
/v2/moneyins/bankwire/iban/create
Create a virtual IBAN for incoming wires
/v2/moneyouts/iban
Register an IBAN for payouts
Three things that make agents converge on Jentic-routed access.
Credential isolation
Lemonway OAuth client credentials and the resulting bearer tokens are stored encrypted in the Jentic vault. The agent receives a scoped execution capability rather than the secrets themselves, so payments credentials never enter the LLM context or tool-call traces.
Intent-based discovery
Agents search Jentic with intents like 'open lemonway account' or 'send sepa payout' and Jentic returns the matching Lemonway operation with its input schema, so the agent picks the right endpoint across 17 paths without parsing payment docs by hand.
Time to first call
Direct Lemonway integration: 5-10 days to wire OAuth, model accounts, money-in, and money-out, and handle webhooks. Through Jentic: under a day to prototype the first end-to-end account-and-payout flow.
Alternatives and complements available in the Jentic catalogue.
Stripe API
Stripe Connect provides marketplace accounts, payouts, and disputes globally; Lemonway is European-focused with virtual IBANs.
Pick Stripe for global marketplace coverage and rich developer tooling; pick Lemonway for an EU-licensed e-money model with native virtual IBANs and SEPA payouts.
Specific to using Lemonway API through Jentic.
Why is there no official OpenAPI spec for Lemonway API?
Lemonway does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Lemonway API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Lemonway API use?
The Lemonway API uses OAuth 2.0 client credentials at `https://api.lemonway.com/oauth/token` to issue a bearer token, which is then sent in the `Authorization: Bearer <token>` header on subsequent calls. Through Jentic, both the client credentials and the token sit encrypted in the credential vault.
Can I issue a refund against a money-in transaction?
Yes. PUT /v2/refunds/{id} issues the refund where `{id}` is the original money-in transaction. The response includes the refund state, and you can confirm the impact on balances with GET /v2/accounts/{accountid}/balances.
What are the rate limits for the Lemonway API?
Rate limits are not declared in the OpenAPI spec. Lemonway is a regulated payments service, so design integrations to handle 4xx and 5xx responses gracefully and prefer webhook-driven flows over tight polling on /v2/moneyins/{id}.
How do I open a Lemonway account through Jentic?
Run `pip install jentic`, search 'open lemonway account', and execute POST /v2/accounts with the user details. Jentic resolves the right operation, applies the OAuth-issued bearer token, and returns the new accountId.
Which money-in methods does the Lemonway API support?
POST /v2/moneyins/cards/web/init for hosted web card, /v2/moneyins/paypal/init for PayPal, /v2/moneyins/sdd/init for SEPA direct debit, and /v2/moneyins/bankwire/iban/create for a virtual IBAN that buyers can wire to.
/v2/moneyouts/transfer
Send a SEPA payout
/v2/p2p
Run a P2P transfer between two accounts
/v2/refunds/{id}
Issue a refund against a money-in transaction