Help center

Frequently asked questions

Find answers about the by square portal, account access, pricing, API integrations, supported QR formats, plugins, scanning quality, data security, and troubleshooting.

Getting started

What is the by square portal?

The by square portal is the place where you manage your by square account, API access, billing, plugins, and tools for working with payment and invoice QR codes.

Who is the portal for?

The portal is designed for businesses, developers, accounting teams, ERP vendors, invoicing platforms, and anyone who needs to generate or read payment and invoice QR codes.

What can I create with by square?

You can create QR codes for payment and invoice data, including PAY by square, SPAYD, and INVOICE by square formats.

Do I need technical knowledge to use by square?

Not always. If you use ready-made portal tools or plugins, you may not need technical knowledge. If you want to connect by square to your own software, ERP, accounting system, or automated workflow, developer support is usually required.

Account and login

How do I create an account?

Go to the by square portal and choose Create account. After registration, you can sign in and manage your account.

I forgot my password. What should I do?

Use the Forgot your password? option on the login page to reset your password.

Can I log in without a password?

Yes. If available, you can use a one-time login code to sign in without entering a password.

Can multiple people use the same company account?

Depending on your plan, you may be able to invite team members or manage users under your account settings.

Pricing and limits

How much does it cost?

Pricing depends on your selected plan, usage volume, and whether you use the portal, API, plugins, or a custom integration. You can view available plans and billing details in the Billing section of the portal. For enterprise or high-volume use, contact by square support.

Where can I manage billing?

You can manage billing in the Billing section of the portal after signing in.

Is there a free trial?

If a free trial is available, you can start it directly from the portal or pricing page.

What happens after I reach my limit?

After you reach your plan limit, additional requests may be blocked, limited, or require a plan upgrade, depending on your subscription. Check the Billing section of the portal for your current usage, limits, and upgrade options.

Can I change or cancel my plan?

You can manage your plan from the Billing section. Changes may take effect immediately or at the next billing period, depending on the plan and billing setup.

Integration

How do I integrate by square?

You can integrate by square by using the API for custom software, ERP, accounting, or invoicing systems, using a supported plugin if one exists for your platform, or using by square libraries or a custom implementation for advanced workflows. Developers should start with the API documentation in the portal.

Can I integrate by square into my ERP, invoicing, or accounting software?

Yes. by square can be integrated into ERP, invoicing, accounting, and business systems using the API, plugins, or software libraries.

Where can I find the API documentation?

You can find API documentation in the portal under the Docs or API documentation section.

What is the API base URL?

The API base URL is provided in the API documentation. Use the documentation as the source of truth for the latest endpoint information.

Do I need an API key?

Yes, API integrations usually require authentication using API credentials generated in the portal.

What should I do if my API key is compromised?

Immediately revoke or regenerate the API key in the portal and update your integration with the new credentials.

Supported formats

Which formats are supported?

by square supports formats related to payment and invoice QR codes, including PAY by square, SPAYD, and INVOICE by square. Supported input and output formats may depend on whether you use the portal, API, plugin, or file upload feature.

Can I decode an uploaded QR code or invoice file?

If supported by your plan and integration type, you can upload or process files such as images or PDFs to read QR code data and retrieve structured information.

Can I use by square offline?

Offline generation may be possible through supported software libraries or custom implementation. This is usually intended for advanced or enterprise integrations.

PAY by square

What is PAY by square?

PAY by square is a QR payment format that encodes payment details into a QR code. Customers can scan the code in a compatible banking app instead of manually entering payment details.

Which banks support PAY by square?

PAY by square is supported by participating Slovak banks and banking applications that follow the PAY by square standard. Customers can scan the QR code directly in a compatible banking app.

Does PAY by square process the payment?

No. PAY by square does not process, authorize, or transfer money. It only encodes payment details into a QR code. The customer reviews and confirms the payment in their own banking app.

Can I generate a QR code without an invoice?

Yes. You can generate a payment QR code without an invoice if you have the required payment details, such as IBAN, amount, currency, payment reference, variable symbol, or other required fields.

What payment details can be included in PAY by square?

A PAY by square QR code can include payment details such as IBAN, amount, currency, payment reference, variable symbol, constant symbol, specific symbol, payment note, and beneficiary information, depending on the use case and required fields.

Can one QR code include multiple payments?

Support for multiple payments depends on the format and implementation. Check the API documentation or integration guide for the supported structure.

INVOICE by square

What is INVOICE by square?

INVOICE by square stores invoice-related accounting data in a QR code. It helps customers or accounting systems scan and import invoice information more easily.

What is the difference between PAY by square and INVOICE by square?

PAY by square contains payment information for creating a bank transfer. INVOICE by square contains invoice and accounting data for processing and bookkeeping.

Can one invoice contain both PAY by square and INVOICE by square?

Yes. An invoice can contain both payment and invoice QR codes, allowing the recipient to scan payment data in a banking app and invoice data in compatible accounting software.

Can customers scan the code directly from a PDF invoice?

Yes, as long as the QR code is clear, large enough, and supported by the customer's banking or accounting app.

Plugins

What are by square plugins?

Plugins help connect by square functionality to existing invoicing, accounting, ERP, or e-commerce systems without building a custom API integration from scratch.

How do I activate a plugin?

Log in to the portal, open the Plugins section, choose the plugin you need, and follow the setup instructions.

My plugin is not generating QR codes. What should I check?

Check that your account is active, billing is up to date, the plugin is configured correctly, API credentials are valid, and the invoice contains all required payment or invoice fields.

Can I use both plugins and the API?

Yes. You can use plugins for standard workflows and the API for custom automation or advanced integrations.

QR code scanning and quality

Why can't my customer scan the QR code?

Common causes include low image resolution, a QR code that is too small, poor print quality, missing quiet zone around the code, damaged PDF export, or an unsupported banking or accounting app.

What is the recommended QR code size?

Use a size that remains sharp and readable in both PDF and print. Avoid scaling up a low-resolution QR image.

Can I place the QR code on printed invoices?

Yes. QR codes can be printed on invoices, but they must remain clear, sharp, and scannable.

Can a QR code be changed after it is generated?

No. A generated QR code represents encoded data. To change payment or invoice details, generate a new QR code.

Why does the QR code work in one app but not another?

Different banking or accounting apps may support different formats, fields, or validation rules. Confirm that the app supports the specific QR code type you generated.

Data and security

Is payment information stored?

No. Payment information is processed without storage. It is used only to generate or process the QR code and is not saved by by square.

Does by square move money?

No. by square does not move money, process card payments, authorize transfers, or act as a payment institution. PAY by square only helps prepare payment details for the customer's banking app.

Is the payment sent automatically after scanning the QR code?

No. The customer must review and confirm the payment in their banking app.

Who can see my API keys?

Only authorized users with access to your account should be able to see or manage API credentials. Keep API keys private and do not share them publicly.

Should I include sensitive information in a QR code?

Only include information that is necessary for payment or invoice processing. A QR code can be scanned by anyone who has access to it.

Troubleshooting

The generated QR code contains wrong data. What should I do?

Check the source invoice, portal input, plugin configuration, or API request. QR codes are generated from the data you provide, so incorrect IBAN, amount, symbols, invoice number, or payment reference must be corrected at the source.

The API returns an error. How do I debug it?

Check the API documentation, verify authentication, confirm all required fields are present, inspect the response code and message, and test with a minimal valid request.

The QR code is missing from my invoice. What should I check?

Check whether the plugin or integration is enabled, the invoice contains all required fields, your account has available usage, and the selected output template includes the QR code.

My limit was reached and QR codes stopped generating. What should I do?

Open the Billing section in the portal, check your current usage, and upgrade your plan or contact support if you need a higher limit.

Where can I get support?

For support, contact by square through the support contact listed in the portal or email the by square support team.

Need more help?

Send us your question through the contact page and include your account, plugin, API endpoint, or invoice context when relevant.

Contact support