Kitopay¶

Website: kitopay.com

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the kitopay.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:

• kitopay__public_key → Public key
• kitopay__secret_key → Secret key
• kitopay__test_mode → true/false
• kitopay__currency → choose currency (You can set these parameters according to available currencies and features for your Kitopay wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.¶

Your public key (x-merchant-id) is always available in KitoPay dashboard. It looks like this:¶

• dev_pub_fb1dad5f-5982-4e1a-ac2f-62a7daaa7148¶

• prod_pub_fb1dad5f-5982-4e1a-ac2f-62a7daaa7148]¶

The secret key can be retrieved in the dashboard only once. Upon losing access to the secret key, it has to be regenerated and retrieved again through KitoPay dashboard. It looks like this:¶

• dev_sec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx¶

• prod_sec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]¶

Connect Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

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

Enter credentials:

• Public key
• Secret key
• Currency

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":5.35,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"44444"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"6f8ba0d6-e763-4bac-81fe-c66316e94916",
      "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":5.35,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"c4503615-7408-4ef9-aa43-d9499a5152f6",
        "name":"John Doe",
        "email":"[email protected]",
        "phone":"+380631854299",
        "date_of_birth":"1904-05-11",
        "address":{
          "full_address":" Proviantska 3",
          "country":"UA",
          "region":"AA",
          "city":"Kyiv",
          "street":" Proviantska",
          "post_code":"01001"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"32b89bb9-4d66-4a41-8526-904e61e7532d",
      "service_fields":[
      ]
    }
  }
}

Constants¶

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:

• FIRST_NAME → customer [address] [first_name]
• LAST_NAME→ customer [address] [last_name]
• EMAIL → customer [address] [email]
• DATE_OF_BIRTH → customer [date_of_birth]
• COUNTRY → customer [address] [country]
• CITY → customer [address] [city]
• REGION → customer [address] [region]
• FULL_ADDRESS → customer [address] [full_address]
• POST_CODE → customer[address][post_code]
• COUNTRY_PHONE_CODE → customer [constants][customer_country_phone_code]
• PHONE→ customer [address] [phone]