Payhere

13 tools available

Easy payment links for accepting online payments

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.

Common workflows with Payhere

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

Payhere actions 13

Every Payhere action below is a callable tool any Definable persona can invoke.

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.

Frequently asked questions

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.

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.

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.

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.

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.

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.

Ready to automate with Payhere?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations