Skip to content

AliKassa

Supports in this guide: Payouts

Provider website: AliKassa.com

What you need to do for start processing transactions (brief summary)

  1. Sign up in AliKassa
  2. Get your credentials and keys
  3. Configure callback endpoint in AliKassa back-office
  4. Connect Provider account in Corefy Dashboard
  5. Send your first API request

Choose account type

AliKassa can be connected in different ways:

  • If you do payouts -> choose Provider account
  • If you do card payments -> choose H2H Merchant account (availability should be confirmed with your manager)

If you are not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from AliKassa

Before connecting, in AliKassa back-office complete account setup and collect the required credentials.

Step 1 - Sign up and activate your account

Send a request on the AliKassa website, verify your account, and get access to the back-office.

Step 2 - Get account identifiers

In Projects -> Accounts, find:

  • Merchant ID
  • Account UUID

Accounts

Step 3 - Generate keys

In Settings -> Keys, generate and download:

  • Password (password.txt)
  • Public key (public.pem)
  • Private (Secret) key (private.pem)

Step 4 - Configure notifications

In Settings -> Notifications, create a notification endpoint ID: https://psp-ext.paycore.io/alikassa/callback

Notifications

Create a notification ID

Important

Be sure to check with the manager if a whitelist of IPs is required. If yes, use IP addresses from the Corefy list.

Payouts processing (connect Provider account)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open AliKassa in the provider directory and press Connect at AliKassa Provider Overview page in the New connection section. Choose Provider account.

Connect

Step 2 - Fill in fields and upload keys

Enter credentials:

  • Account UUID
  • Payout Private Key password (from password.txt)

If you use a custom notification endpoint ID (other than https://psp-ext.paycore.io/alikassa/callback), enter the same value that is configured in AliKassa back-office.

Upload files:

  • private.pem as Payout Private Key
  • public.pem as Notification Public Key

Success

You have connected AliKassa Provider account.

First request to Corefy API (MIN)

What it does: creates a payout-invoice.

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 10,
      "fields": {
        "card_number": "411111******1111"
      }
    }
  }
}

Additional info

For callbacks processing, set up the callback URL in AliKassa back-office:

  • https://psp-ext.paycore.io/alikassa/callback

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Account UUID, password, and uploaded key files
  • Callbacks are not received -> verify notification endpoint ID in AliKassa matches the value in your Corefy connection settings
  • Not sure which account type to use? -> ask your Corefy account manager

Question

Still looking for help connecting your AliKassa account? Please contact our support team!