Skip to main content
DatecsPay connects 1club to Datecs and BORICA. It has three modules you switch on per company: Online takes card payments on BORICA’s hosted checkout, POS Terminals charges cards on Datecs terminals at your desk, and Fiscal prints fiscal receipts on Datecs fiscal devices. An owner or admin sets it up once; any one module can run on its own.
If your organization trades through more than one company, each company connects its own BORICA terminal. Pick the company under Billing entity at the top of the DatecsPay page before you save or deactivate anything. The line under the picker reminds you that payments for that company’s gyms settle to the account you are setting up. The picker only appears when you have more than one billing entity. See Billing entities.

When to use it

DatecsPay suits a gym in Bulgaria that banks with BORICA, uses Datecs hardware at the desk, or both. Card data never touches 1club servers, and every request is signed with your own RSA key. Payment status comes back on its own: through the cardholder’s browser on return, a signed BORICA notification, and a reconciliation sweep that catches anyone who closes the tab early. Unlike Stripe and myPOS, DatecsPay has no free shared sandbox. Both the Test and Live environments run against BORICA with your own credentials. Only the terminal and gateway differ between them. Typical uses:
  • A gym already banking with BORICA - take card payments online through the BORICA terminal your bank issued, with no Stripe or myPOS account.
  • A BlueCash-50 at reception - charge cards on the Datecs terminal from the till, and print each sale’s fiscal receipt on the same box. Turn on POS Terminals and Fiscal.
  • Fiscal receipts beside a Stripe reader - keep taking cards on Stripe and use a BlueCash-50 only to print fiscal receipts for cash and card sales. Turn on Fiscal alone, with no BORICA credentials.
  • Rehearsing checkout before going live - run the full checkout against BORICA’s test gateway with your test terminal, where no real money moves, then switch to Live.
  • A member who closes the tab mid-payment - the membership still settles, because the reconciliation job confirms the charge with BORICA within a few minutes, with no staff action.

Modules

Each module is a checkbox on the DatecsPay page, switched on per company. Any one can be on alone. Datecs terminals and fiscal devices have no cloud connection of their own. They reach 1club through the Payment Bridge app that runs on the device, which you pair with a one-time code.

Before you start

  • A paid plan. DatecsPay is a paid-plan integration. On the Free plan and during the free trial, Activate is greyed out until you upgrade.
  • For Online: BORICA credentials for the environment you want. Both Test and Live need a Terminal ID (TID), a Merchant ID (MID), your RSA private key, and BORICA’s public certificate. BORICA issues a separate set for each environment, so keep the two sets apart. POS Terminals and Fiscal need none of these.
  • For Online: no other online card provider for the company. Each company takes online card payments through one provider at a time: Stripe, myPOS, or DatecsPay. While Stripe or myPOS takes them, the Online checkbox is locked and says which provider holds it. Untick Online under Use Stripe for on the Stripe page, or untick Online on the myPOS page, first. Both can keep running card readers beside DatecsPay, and POS Terminals and Fiscal aren’t affected.
  • For Fiscal: the company’s country. Fiscal receipts print only for a company whose billing entity is in Bulgaria.
Configuring DatecsPay requires the settings.manage.organization permission. Viewing its settings requires settings.read.organization.

Where to get your DatecsPay credentials

You need these only for the Online module. DatecsPay credentials come from BORICA (through your bank or acquirer), not from 1club. When your DatecsPay/BORICA terminal is provisioned you receive: Generate your key pair and register it with BORICA before you configure 1club, and download the matching BORICA certificate for the environment you are setting up.

Activate DatecsPay

  1. Go to Settings > Integrations.
  2. Under Payments, click Activate next to DatecsPay. 1club opens the DatecsPay page. Nothing is saved until you click Save.
  3. Tick the modules you want: Online, POS Terminals, Fiscal. Online starts ticked, unless another provider already takes the company’s online card payments.
  4. If Online is ticked:
    1. Choose an Environment: Test runs against BORICA’s test gateway, and Live processes real payments against BORICA production. BORICA gives you different credentials for each, so enter the set that matches.
    2. Enter your Terminal ID (TID) and Merchant ID (MID).
    3. Check the Merchant name and Merchant website. 1club pre-fills these from your organization’s name and website, but you can edit them if BORICA registered a different name or URL.
    4. Paste your Merchant private key (PEM) and BORICA public certificate (PEM). If your key file is protected with a passphrase, enter it in Private key passphrase. 1club uses it once to decrypt the key and never stores it.
  5. If POS Terminals is ticked, set the Daily card batch close time. See Daily card batch close.
  6. Click Save. The page shows Active next to the title and, with Online on, the environment, Test or Live. Save stays greyed out until at least one module is ticked.
  7. With Online on, click Test configuration to check that the stored key and certificate are well-formed.
  8. Pair your Datecs terminals under Payment terminals, and add fiscal rules and fiscal devices under Fiscal receipts.
The private key and certificate are stored encrypted and shown back to you as masked fields (•••••• (saved - leave blank to keep)). When you edit the configuration later, leave them blank to keep the existing values. Only paste a value if you are replacing it.
Your country and time-zone offset are not part of this form. 1club derives them automatically from your organization settings and sends them to BORICA at checkout.

Configuration fields

The BORICA fields apply only while Online is ticked. With Online off, none of them is required.

Daily card batch close

With POS Terminals on, every Datecs terminal of the company closes its card batch once a day at the time you set. The Payment Bridge app on the terminal runs it, so you don’t close the batch by hand. Pick a time when the desk is closed. If a terminal must close its batch before it can take a card and that doesn’t go through, the card panel says so and nothing is charged; try again. The card batch close is not the fiscal day: 1club doesn’t run X or Z reports on your fiscal devices.

Switch a module off

Untick the module and click Save:
  • Online off - members can no longer pay by card through BORICA for that company.
  • POS Terminals off - the company’s Datecs terminals are retired from Payment terminals. This is refused while one of them has a card charge still being resolved.
  • Fiscal off - the company’s fiscal devices are removed, and its desk sales tell staff to issue the receipt by hand. This is refused while a fiscal device still owes a receipt: wait for it to print, or waive it once you have issued it by hand.
A BlueCash-50 that is both a terminal and a fiscal device stays paired while either module still uses it.

Test vs. live environment

The environment applies to the Online module only. Datecs terminals and fiscal devices work the same way in either.
  • Test runs against BORICA’s test gateway with your test terminal. No real money moves, so you can rehearse the full checkout flow.
  • Live runs against BORICA production with your live terminal. Real payments are processed and settled to your account.
There is no credential-free sandbox. Both environments need a full credential set, and the TID, key, and certificate are different for each. DatecsPay keeps one credential set per company, for the environment you saved. When you switch Environment, the page clears the Terminal ID (TID), key, passphrase, and certificate fields. To save, enter the TID, private key, and BORICA certificate issued for the new environment. If you leave the key or certificate blank, the page asks for the one issued for that environment. Your saved set for the old environment is replaced, so keep a copy if you plan to switch back.

Test configuration

The Test configuration button checks that your saved credentials are complete and well-formed: that the private key and BORICA certificate are valid and the gateway for your environment resolves. It records the time of the last successful check. On success it shows “DatecsPay configuration looks valid”.
This check runs locally and does not contact BORICA or move any money. It catches a malformed key or a missing field, but it can’t confirm that BORICA recognizes your TID or merchant. The first real proof that credentials are correct is a successful test payment through hosted checkout.

What syncs online

  • Payments created in 1club open a BORICA hosted-checkout page that the customer is redirected to.
  • After payment, the status returns to 1club through up to three paths, so a payment settles even if one path fails:
    1. Browser return - BORICA posts the signed result back through the cardholder’s browser when they return to 1club, and 1club verifies the signature and settles the payment.
    2. Signed notification - BORICA can also notify 1club server to server. The notification’s signature is verified against your BORICA certificate before it is processed.
    3. Reconciliation - a background job runs every 5 minutes and confirms any payment still pending (for example because the customer closed the tab before returning) with a direct status check to BORICA.
  • The payment status and BORICA transaction references are recorded on the 1club payment, and any linked charges and bookings are settled automatically.
  • Every path is matched to the same payment by a unique reference, so a redelivered notification or an overlapping reconciliation never double-charges or double-settles.

Where members pay by card

Members pay through BORICA’s checkout page wherever they buy online: bookings, classes, events, memberships, the shop, signup forms, and outstanding balances in the member portal and on your website. In the member app, the checkout page opens inside the app and the member returns to the app with the result. If the confirmation takes a moment longer, the app says so rather than reporting a failure, so nobody pays twice.

Membership renewals

DatecsPay doesn’t collect renewals on its own: BORICA’s checkout needs the member at the page, and there is no saved card to charge. When DatecsPay takes a company’s online card payments, each renewal of an auto-renewing membership is raised as a charge and left owed. Collect it at the desk or from an invoice. See Recurring memberships. DatecsPay has no shareable payment link. The Send myPOS payment link action on a charge works with myPOS only, so on DatecsPay a member pays through the checkout in the portal, the app, or your website rather than from a link you send them. If sending a pay-by-link is central to how you collect, myPOS is the better fit.

Refunds

1club does not push refunds to BORICA. Refund a DatecsPay payment from your BORICA/acquirer side, then reconcile the charge in 1club.

Deactivate

  1. Pick the company under Billing entity, if you have more than one.
  2. Click Deactivate at the top of the DatecsPay page.
  3. Confirm in the Deactivate DatecsPay? dialog. It says DatecsPay stops working and its settings are deleted. With more than one billing entity, it also says the change applies to the selected company only.
Deactivating switches off all three modules at once: the company’s Datecs terminals are retired and its fiscal devices are removed. You stay on the DatecsPay page afterwards, with the form reset. Your stored credentials for that company are cleared, so activating again means entering them again. If 1club can’t deactivate DatecsPay, for example because a fiscal device still owes a receipt, the reason shows in the dialog.

Troubleshooting

  • Activate is greyed out - your organization is on the Free plan or the free trial. Upgrade to a paid plan to activate payments.
  • Test configuration fails - confirm the Merchant private key (PEM) and BORICA public certificate (PEM) are valid PEM and that you pasted the certificate for the environment you selected (test and production certificates differ).
  • Save asks for the key and certificate again - you changed Environment. BORICA issues a separate set per environment, so paste the key and certificate for the environment you selected.
  • Customers see a signature error on the checkout page - the public key registered with BORICA doesn’t match the private key on file, or the TID belongs to a different environment. Re-check the key pair registered with BORICA and confirm the TID matches your selected environment.
  • Payment succeeded on BORICA but the charge stays unpaid in 1club - this usually resolves on its own: the reconciliation job confirms pending checkouts within a few minutes. If it persists beyond that, re-check that your BORICA certificate is current.
  • Live payments fail but test works - confirm you are in the Live environment and entered live credentials (a production TID and the production BORICA certificate, not the test ones).
  • The Online checkbox is locked, or saving says another provider “already takes online card payments” - only one online card provider can be active per company. Untick Online on the Stripe or myPOS page for that company, then tick Online on DatecsPay again.
  • Save is greyed out - no module is ticked. Tick at least one, or click Deactivate to switch DatecsPay off.
  • Switching Fiscal off is refused - a fiscal device still owes a receipt. Wait for it to print, or waive it on the payment once you have issued it by hand, then save again.

Worked examples

Bulgarian gym already banking with BORICA. A fitness gym whose bank issued it a BORICA e-commerce terminal generates an RSA key pair, registers the public key with BORICA, and downloads the production certificate. It activates DatecsPay, selects Live, enters its TID and MID, pastes the private key and certificate, saves, and runs Test configuration. One real area booking confirms hosted checkout settles the charge. A member who closes the tab mid-payment. A member pays for a membership on BORICA’s page but closes the browser before returning to 1club, so the payment briefly shows as pending. Within a few minutes the reconciliation job checks the status with BORICA, confirms the charge, and settles the membership, with no staff action needed.

Tips & best practices

  • Keep your test and production credential sets clearly separated. The TID, key, and BORICA certificate differ per environment, and mixing them is the most common cause of signature errors.
  • Remember that Test configuration is a local check only. It can’t confirm BORICA recognizes your terminal, so always follow it with a real test payment.
  • Leave the masked private key and certificate fields blank when editing later. Only paste a value when you are deliberately replacing it.
  • Decide up front whether each company takes online card payments through DatecsPay, myPOS, or Stripe. Only one online card provider can run per company.
  • If you sell monthly memberships, plan how you will collect renewals. DatecsPay leaves each renewal owed, while Stripe and myPOS can collect them automatically.
  • Integrations - the full integration catalog and how activation works.
  • Fiscal receipts - fiscal rules and fiscal devices for the Fiscal module.
  • Tills - which terminals and fiscal device each counter uses.
  • Billing entities - the companies you trade through, each with its own payment accounts.
  • myPOS - the other hosted-checkout provider (myPOS Online can’t run alongside DatecsPay for the same company).
  • Payment terminals - card readers at the front desk, through Stripe, myPOS, or Datecs.
  • Stripe - card and wallet payments with test and live modes.
  • Charges - where payable charges live.
  • Payments - the payment records DatecsPay settles.