Skip to content

FlashPay

Pay Ukrainian utility bills and mobile top-ups directly from your platform.

Supports in this guide: Payouts

Provider website: fbank.com.ua

Note

A live check of this website returned a bot-protection response rather than a clear success or failure - the domain is the bank's own, long-standing address, so it's kept here, but treat it as corroborated rather than freshly verified.

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

  1. Generate a key pair and get your Key ID (from FlashPay)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from FlashPay

Contact your FlashPay account manager to get your account verified.

Generate your own RSA key pair: 

# the Private key
openssl genrsa -out priv.key 2048
# the Public key
openssl rsa -in priv.key -out open.key -pubout
Send the public key (open.key) to your FlashPay account manager. Linking it to your account, FlashPay issues your Key ID.

  • Key ID -> Corefy field key_id.
  • Private key -> Corefy field private_key -> uploaded as a file; this is your own private key (priv.key), never share it with FlashPay.

UAH only.

Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Key ID
  • Private key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected FlashPay Provider account!

First request to Corefy API (MIN)

What it does: creates a payout-invoice that pays a Ukrainian utility bill, mobile top-up, or similar local billing service. FlashPay's full billers directory has thousands of entries (utilities, mobile operators, internet providers, and more); service selects which one.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "7a8b9c0d-1e2f-4031-8a02-5b6c7d8e9f0a",
      "service": "kyivstar_phone_uah",
      "currency": "UAH",
      "amount": 100,
      "fields": {
        "phone_number": "380671234567"
      }
    }
  }
}

Important

The required field under fields depends on the selected biller/method:

  • Mobile top-up by phone number (for example kyivstar_phone, vodafone_phone, lifecell_phone) -> fields.phone_number
  • Mobile contract payment or internet payment (for example kyivstar_contract, kyivstar_internet, vodafone_contract, lifecell_contract) -> fields.client_id
  • All other billers (utilities and the rest of the directory) -> fields.client_id (the biller's own account/client identifier)

Payout - MAX

There is no MAX variant - customer is not used at all for this connector, and no Options or Constants are configured.

Refunds

FlashPay does not support refunds.

Additional info

  1. Active reconciliation is available - payout statuses can be checked via an active status request.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the Key ID and private key for the selected environment (test_mode)
  • Payout rejected for an unknown biller -> confirm the service code is a valid, currently available entry in FlashPay's billers directory
  • Payout rejected for a wrong field -> check whether the selected biller needs fields.phone_number or fields.client_id - it depends on the method, not every biller uses the same one
  • Currency or service is not supported -> only UAH is available

Question

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