RollyPay FAQ — payments, fees and API integration

Onboarding and getting started

Who can connect to RollyPay?

Individuals, self-employed, sole traders and companies. Your legal form doesn't limit the payment methods available — terms are tailored to the project. Onboarding and account maintenance are free: you only pay a percentage of successful payments.

What documents are required?

Individuals and the self-employed only need a Telegram contact and a description of the project. Sole traders and companies provide standard registration details. Your manager will also ask for the website or bot link and the business category — that's needed for review.

How long does onboarding take?

A manager reviews your application within 15–20 minutes during business hours. Once terms are agreed you get dashboard access and API keys, and you can accept your first payment the same day — via a payment link with no code, or through the API.

Which businesses do you accept?

Online stores and marketplaces, SaaS and subscriptions, digital goods and licenses, online education, VPN and hosting, Telegram bots, IT services and development. Every project goes through review: the category and terms are confirmed by a manager before launch.

Can I test everything before going live?

Yes. Test mode runs on the same terminal with the same API key — just pass "test": true when creating a payment. Test payments don't move your balance, don't consume terminal limits and are excluded from analytics.

Fees and pricing

What are the fees?

Crypto starts from 1%, SBP and bank cards from 4%. The final rate depends on turnover, business category and the methods you enable — it's agreed with your manager at onboarding and always visible in the dashboard.

Are there subscription or hidden fees?

No setup fee, no monthly subscription, no charge for the dashboard. The fee is taken only from successful payments: your terminal balance is credited with the amount minus the fee, and that amount is shown on every payment.

Can the rate be lowered?

Yes — rates are reviewed as your turnover grows, just message your manager. Cashback lowers your effective cost further: part of the fee comes back to your balance.

How does cashback work?

Every successful payment returns part of the fee to your balance. The percentage grows with turnover. Cashback accrues in USDT, can be withdrawn together with the rest of your funds and has no minimum threshold to wait for.

What currency is my balance held in?

Customers pay in rubles while the terminal balance is held in USDT — revenue is converted at the rate applied when the payment is credited. You can withdraw in USDT to a wallet or in rubles to a Russian bank card.

Payment methods

Which payment methods are supported?

SBP via QR code and payment link, bank cards (Visa, Mastercard, Mir) and crypto — USDT (TRC-20, ERC-20), BTC, ETH and other networks. ERIP for customers in Belarus and international payments can be enabled on top.

Do I have to enable every method at once?

No. Start with what you need now and add the rest later — no re-integration required: methods are switched on our side, your code stays unchanged.

What is payment cascading?

If a processing route declines a payment or goes down, the system automatically retries it through the next available route. Your customer never notices, and the success rate stays as high as 95% with nothing to do on your side.

What does checkout look like for the customer?

The customer lands on the RollyPay payment page, picks a method and pays. The page is mobile-first and opens from a direct link, so it works equally well for a website and a Telegram bot. You get the result via webhook.

Can I refund a payment?

Yes. Refunds are issued from the dashboard on the payment card: the full amount is returned to the customer through the same method they paid with. Refunds aren't available for test payments — no real money was involved.

Integration and API

How hard is the integration?

The simplest scenario — a payment link — needs no code at all. An API integration takes 30 to 60 minutes: there's documentation at docs.rollypay.io, SDKs for Node.js, PHP and Python, and ready-made modules for popular CMS platforms. Our team helps during onboarding.

How do I accept payments in a Telegram bot?

The bot creates a payment with a POST request to the API and sends the customer a link to the payment page. Once paid, a webhook hits your server and the bot delivers the goods, access or subscription instantly. No separate entity or company is required.

How do webhooks and signature checks work?

A POST with an event — payment.paid, for example — is sent to the callback_url set on your terminal. The X-Signature and X-Timestamp headers carry an HMAC-SHA256 signature of "timestamp.body" signed with your terminal key; verify it before processing. If your server doesn't answer 2xx within 10 seconds, delivery is retried.

Can I run several projects in one account?

Yes. An account can hold multiple terminals, each with its own API keys, limits, callback_url, analytics and balance. Teammates get role-based access instead of sharing your main login.

Payouts and dashboard

How fast can I withdraw?

As soon as a payment is credited to your balance the funds are available — there's no extra hold. USDT payouts are processed within minutes of confirmation, and every payout status is visible in the dashboard.

Where can I withdraw to?

To a Russian bank card in rubles, or in USDT to an external wallet (TRC-20 and other networks). You choose the network and address in the payout form, which also shows current limits and the network fee.

Can payouts be created via API?

Yes — POST /api/v1/payouts with the amount, wallet address and network. An idempotency key is supported, so a retried request never creates a duplicate payout — handy for scheduled automatic payouts.

What's in the dashboard?

Real-time payments and statuses, turnover and conversion, payout and cashback history, terminal and webhook settings with callback delivery logs, plus report exports to CSV and XLSX.

Security and support

How secure is accepting payments with RollyPay?

Every transaction passes anti-fraud checks and suspicious ones are stopped in real time. Card payments are protected by 3-D Secure and tokenization, and all data travels over secured channels.

Do you store card data?

Full card numbers are never stored on our servers — processing happens on the side of licensed partners. The dashboard only shows masked details needed to reconcile payments.

What about disputed payments?

Every payment has full details and status history in the dashboard, and support helps you work through a dispute. If a payment came in by mistake, issue a refund — the money returns to the customer the same way it arrived.

How does support work?

Support answers around the clock on Telegram at @rollypaysupport_bot; for pricing and onboarding questions message your manager at @rollypay_manager. The first reply usually arrives within minutes.

Useful links

See also: about the company, support, terms of use.