Kalonpay¶

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the kalonpay.com → Contact Us 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:

kalonpay__api_key → API key
kalonpay__merchant_id → Merchant ID
kalonpay__currency → choose currency (You can set these parameters according to available currencies and features for your Kalonpay wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Connect Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

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

Connect

Enter credentials:

API key
Merchant ID
Test Mode → true/false

Success

You have connected Kalonpay H2H merchant account!

API examples:¶

Minimum data set to create a payment invoices for payment_card_eur_hpp service¶

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "commerce_account":"Hello_World",
      "currency":"EUR",
      "amount":1.5,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"1",
        "name":"John Wick",
        "email":"[email protected]",
        "phone":"+154984541154441",
      }
    },
    "test_mode":true,
    "options":{
      "allow_partially":true,
      "bypass_hpp":false,
      "send_operation_context_on_return":false
    },
    "reference_id":"022ed634-b37b-4a63-9929-c3ac8e2f635b",
    "service_fields":[
    ]
  }
}
}

Maximum data set to create a payment invoices for payment_card_eur_hpp service¶

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "commerce_account":"Hello_World",
      "currency":"EUR",
      "amount":1.5,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"1",
        "name":"John Wick",
        "email":"[email protected]",
        "phone":"+154984541154441",
        "address":{
          "full_address":"221B Baker Street",
          "country":"GB",
          "region":"London",
          "city":"London",
          "street":"Baker Street",
          "post_code":"NW16XE"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":true,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"022ed634-b37b-4a63-9929-c3ac8e2f635b",
      "service_fields":[
      ]
    }
  }
}

Question

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