Payhere

payment processing 13 tools available

Easy payment links for accepting online payments

About this integration

Connect Payhere to Definable to recover failed charges, triage refunds against policy, detect churn signals. Personas call Payhere's 13 tools directly from chat or scheduled flows. Hook to a finance or growth persona — react to revenue events the moment they happen.

Connect Payhere to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 13 exposed

Plans All, incl. Free

Data Never trained on

Payhere · in workflows

What teams actually run.

Three patterns teams run with Payhere on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Failed charge recovery

│ Webhook on failed payment

│ Persona pulls customer context

└ Drafts a recovery message

Refund triage

│ Refund request arrives

│ Agent checks policy + history

└ Approves or routes for human review

Subscription churn detection

│ Pull cancellations

│ Identify common reasons

└ Trigger a save-flow

13 tools available

The Payhere toolbox.

Every Payhere capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

Create Hook

Tool to subscribe to a REST hook for receiving webhook events. Use when you need to register a webhook endpoint to receive real-time notifications for payment_received, subscription_cancelled, or subscription_created events.

Create Plan

Tool to create a new payment plan in PayHere. Use when you need to set up either a recurring subscription or one-off payment plan for accepting payments.

Delete Hook

Tool to remove a REST hook listener subscription. Use when you need to stop receiving webhook events for a specific hook.

Get Current Company

Tool to fetch company information for the currently authenticated user. Use when you need to retrieve comprehensive company details including identity, configuration, integration status, and associated users.

Get Current Company Stats

Tool to fetch payment statistics for the last 30 days with comparison data from the preceding 30-day period (30-60 days ago). Use when you need to analyze recent payment trends, subscriber growth, or compare current performance against the previous month.

Get User

Tool to fetch information on the currently authenticated user. Use when you need to retrieve details about the logged-in user.

List Customers

Tool to list all customers from Payhere, ordered chronologically with most recent first. Use when you need to retrieve customer records, browse customers, or access customer information. Supports pagination via page and per_page parameters.

List REST Hooks

Tool to list all active REST hooks subscriptions for the authenticated company. Use when you need to view all currently registered webhook listeners for your PayHere account.

List Payments

Tool to list all payments ordered chronologically, most recent first. Use when you need to retrieve payment history or check payment statuses. Supports pagination with page and per_page parameters.

List Plans

Tool to list all plans in your PayHere account. Use when you need to retrieve and paginate through available plans.

List subscriptions

Tool to list all subscriptions ordered chronologically by most recent payment first. Use when you need to retrieve subscription data with customer and plan details.

Update Current Company

Tool to update the company information for the currently authenticated user. Use when modifying company details such as name, legal name, address, logo, support email, website, or branding preferences (button color and text color).

Update Plan

Tool to update an existing plan's configuration and settings. Use when you need to modify plan properties like name, description, pricing, or other settings for both one-off and subscription plans.

See it run

One prompt, start to finish.

A real prompt, the Payhere tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Payhere task end-to-end — plan it, execute across the API, and hand back a verified result.

payhere.create_hook Tool to subscribe to a REST hook for receiving webhook events. Use when you need to regist

payhere.create_plan Tool to create a new payment plan in PayHere. Use when you need to set up either a recurri

payhere.delete_hook Tool to remove a REST hook listener subscription. Use when you need to stop receiving webh · verified

done

Done. Payhere responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Payhere

Questions, answered.

What teams ask before connecting Payhere.

01 What can I automate with Payhere on Definable?

Anything Payhere exposes through its API. Common payment processing workflows on Definable include recover failed charges, triage refunds against policy, detect churn signals. Personas can call any of the 13 Payhere tools directly, then chain the result into another integration without you writing code.

02 How does Payhere authentication work?

Payhere uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

03 Is the Payhere integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 13 Payhere tools. You only need a separate Payhere subscription if Payhere itself charges per seat or per API call.

04 Is using Payhere through Definable secure?

Every call from a persona to Payhere is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

05 How do I get started with Payhere on Definable?

Sign up for Definable, open the integrations page, find Payhere, and connect via OAuth or API key. You can immediately attach Payhere to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

06 What Payhere actions does Definable expose?

Definable exposes all 13 Payhere actions as callable tools — including `Create Hook`, `Create Plan`, `Delete Hook`, plus 10 more. Each tool gets a typed parameter schema so personas know exactly how to call it.