PayTR
Open PayTR secure checkout and follow the payment record when the callback arrives.
Open PayTR secure checkout and follow the payment record when the callback arrives.
Where to use it
On the web, Settings → Apps → Installed apps (/settings/apps) manages connections; Apps (/apps) adds them. In Era Desktop: Business → Apps and Settings → Apps → Installed apps.
What you need
| Field | What to supply |
|---|---|
| Merchant ID | Required. Account or setup information. |
| Merchant key | Required. Secret connection value. |
| Merchant salt | Required. Secret connection value. |
Connect step by step
Connect credentials
Fill in the connection form at Apps → PayTR; enter keys only in that form.
Open payment settings
Select the connected account in Settings → Payments (/settings/payments) and use test mode.
Configure the provider callback
Configure the webhook/callback path in the technical section at the provider.
Check the result
Check that a controlled test payment appears with its result in Finance, then save customer availability and ordering separately.
Era and workflow actions
The general app catalog declares no separate workflow tool block for this provider. Native operations use the module actions described below.
Native payment settings use finance.configure_payment_app. Charge/refund status follows the provider’s verified result; connecting an account does not produce a payment event. See the Finance guide for available payment actions.
Triggers
No separate provider workflow trigger is declared for this app. Use a schedule or the module event above when appropriate.
Permissions and limits
Before connecting
The callback confirms the result; returning to a success page is not proof of payment. The adapter contains fixed demo buyer, address and phone fields. The catalog marks this partial and declares no separate PayTR workflow block or provider trigger.
Apps read permission shows accounts; manage changes connections/settings; delete removes them. Inbox channel management needs Inbox manage, and payment settings need Finance manage. Workflows and Era also obey the target module’s permissions.
Related modules
Ask Era
Show PayTR payment records waiting for a result.
Specify the account and target record. Era uses the connected account’s access and your role permissions; an example prompt is not a completed operation.
For technical teams
POST /api/pay/paytr/webhook is the payment provider callback path; workflow webhooks are separate. The workspace is resolved from the stored payment reference and the signature is verified using the connected account’s key.
Code sources: apps/studio/lib/integrations/definitions.ts, apps/studio/app/(app)/apps/components/connect-app.tsx, packages/os-kernel/src/integrations/catalog.ts.