Skip to content



Online payments made easy


Set up Account

Step 1: Create merchant account

To create an account send an email to connection request or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

  • Point ID
  • Service ID
  • Certificate
  • Certificate password

Connect H2H Merchant Account

Step 1. Connect H2H account at the Corefy Dashboard

Press Connect at Khanpay Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.


Enter credentials:

  • Point ID → Point ID
  • Service ID → Service ID
  • Certificate → Certificate (upload the text file)
  • Certificate password → Certificate password
  • Currency → choose currency (You can set these parameters according to available currencies and features for your Khanpay wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)


You have connected Khanpay H2H merchant account!

API examples:

Data set to create a transaction

POST /api/commerce/payment-invoices HTTP/1.0

  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_usd_hpp",
      "commerce_account": "hello world",
      "currency": "USD",
      "amount": 2,
      "reference_id": "3d759b21-4ce0-4a47-813a-9475f614d20d",
      "flow": "charge",
      "gateway_options": {
        "cardgate": {
          "tokenize": ""
      "customer": {
        "reference_id": "f5d12f54-09a5-434c-b59c-92a3cb369c45",
        "name": "ssss",
        "email": "[email protected]",
        "phone": "12312312333",
        "address": {
          "full_address": "sadasd",
          "country": "UA",
          "region": "SDF",
          "city": "sdsdsd",
          "street": "sadas",
          "post_code": "213213"
      "test_mode": true,
      "options": {
        "allow_partially": false,
        "bypass_hpp": false,
        "send_operation_context_on_return": false
      "service_fields": []

Additional information



If some parameters are not sent in the transaction creation request, they will take the values from the set constants.

Here is a list of constants with their corresponding parameters:

  • Full_address → customer [address] [full_address]
  • Region → customer [address] [region]
  • Country → customer [address] [country]
  • Post_code → customer [address] [post_code]
  • Email → customer [email]
  • Name→ customer [name]
  • Phone → customer [phone]

Still looking for help connecting your Khanpay account?

Please contact our support team!