Connecting an online payment account: PayTR and Stripe
In the app, Online is the fourth payment method alongside cash and card: you show the customer a QR code or a payment link, and the moment the money lands the deposit or the check-out is recorded by itself. This page explains how to connect the account.
Where does the money go?
Straight into your own payment account. The amount never passes through Tanrikulu Apps; Tanrikulu Apps holds no balance and takes no commission.
- The customer scans the QR code or taps the link and pays with their card.
- PayTR / Stripe — your merchant account; the payment lands there.
- Your bank account — the money moves on the provider's payout schedule.
Understand test mode first
The Settings → Payment account → Test mode (sandbox) switch decides whether you are really collecting money. This is the most expensive setting to get wrong.
- Test mode on: no keys needed, you can try it straight away. The customer appears to have paid, but no money reaches your account. It is for trying things out only.
- Test mode off (live): you connect your own account, the customer really pays and the money lands with you. This is everyday use.
The app warns you and asks for confirmation when you turn test mode on. Before you start collecting real money, turn it off and connect your own account.
Which one should you connect?
- PayTR if you are in Türkiye. Stripe does not open accounts for businesses there.
- Stripe if you are outside Türkiye. PayTR serves businesses based in Türkiye only.
You do not need both; the deposit and check-out screens only offer the providers you have connected.
Connecting PayTR
- Merchant account — apply to PayTR; once approved, your merchant panel opens.
- Payment-by-link permission — applied for separately from the panel. A plain account cannot create links on its own.
- Enter three values — PayTR panel → Information → Merchant No, Merchant Password, Merchant Secret Key; then Settings → Payment account → PayTR → Connect.
The link-payment application and the switch to live mode are described step by step on PayTR's own pages; if their interface changes, the current version is there.
Connecting Stripe
- Complete the account — open a Stripe account and finish the business details; an incomplete account cannot take live payments.
- Get the secret key — in the dashboard under Developers → API keys. The value you need starts with
sk_. - Enter it in the app — Settings → Payment account → Stripe → Connect.
What happens once it is connected
Online then appears in three places:
- Take deposit → Online — to collect a deposit before match day. You type the amount and the QR code appears.
- Close and collect → Online — for the remainder when the match ends; any deposit already taken is subtracted automatically.
- Canteen receipt → Online — water, cola, a shirt. Until the payment lands the receipt does not enter the till and nothing is taken off stock.
Neither the deposit nor the check-out is written before the money arrives, so you never end up with a record that looks collected while the money is missing. Online takings sit on their own line in the end-of-day till; they are never merged with Card — Card is what goes through your own terminal.
tanrikuluapps.com/mac/#code). Even if the WhatsApp message is lost, the customer can pay from that page; when the payment lands the page turns into "deposit received" by itself.Common questions
- "Payment link could not be created" — the reason returned by the provider is printed on screen. The two most common causes: payment-by-link permission not yet granted, and a currency the provider does not accept.
- Tapping Online says "you have not connected an account yet" — there is no connected payment account. Go to Settings → Payment account and connect one. If you are signed in as staff, only the business owner can see this setting.
- A deposit larger than the fee is rejected — a deposit can be at most the match fee; if you type more, the app shows the upper limit. That way you never owe the customer a refund.
- A second deposit cannot be taken on a paid one — a deposit is taken once. If the amount needs correcting, you adjust what is collected at check-out.
- The payment went through but no money reached my account — test mode may still be on. Turn the switch off in settings; in live mode your own account is used.