Skip to content

Logo

KalonPay

Supports in this guide: Payments

Provider website: kalonpay.com

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

  1. Get your credentials (from KalonPay)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from KalonPay

Contact your KalonPay account manager to get your account verified and receive the following credentials.

  • API key -> Corefy field api_key.
  • Merchant ID -> Corefy field merchant_id.

You can set the currency/features according to what's available for your account, but it's necessary to check details of the connection with your Corefy account manager.

Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • API key
  • Merchant ID
  • Currency / Features -> choose values available for your account
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected KalonPay H2H Merchant account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice; card data itself is collected and submitted separately by Corefy's checkout/SDK layer, not as part of this request. KalonPay redirects the customer to a hosted payment page to complete the transaction.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6be05631-8710-4b14-a369-1928a2b70eda",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "199be985-c243-478a-86a8-4b8c902e5bb6",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "name@example.com",
        "phone": "+380680786663",
        "address": {
          "full_address": "Main street 1",
          "country": "GB",
          "city": "London",
          "region": "London",
          "post_code": "W1J 5AX"
        }
      }
    }
  }
}

Important

  • customer.name is split into first/last name; if missing, the card's own embossed cardholder name is used instead.
  • No Constants are configured for this connector - if customer.email, .phone, or any address field is missing, it's simply sent to KalonPay as an empty value rather than being filled with a fake default.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Refunds

KalonPay supports partial refunds, but only one refund per payment (no multiple partial refunds against the same payment). The original transaction ID is required.

Additional info

  1. Active reconciliation and callback are both available - either one can finalize the payment; Corefy also falls back to an active status request if no callback arrives in time.
  2. No recurring - this connector does not support saving/charging a token through Corefy.
  3. No Options are configured for this connector.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the API key and Merchant ID for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your KalonPay account and in Corefy
  • Refund fails with multiple attempts -> only one refund per payment is allowed

Question

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