CrystalBank¶

Website: crystalbank.com.ua

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the crystalbank.com.ua/ua/contacts 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:

• crystalbank__ext_system_id → ExtsystemID
• crystalbank__login → LOGIN
• crystalbank__password → PASSWORD
• crystalbank__ssl_certificate → generation of ssl_certificate ukrcard/crystalbank (sent to their mail and waiting for settings)
• crystalbank__ssl_private_key → generation of *ssl_private_key ukrcard/crystalbank (sent to their mail and waiting for settings)
• crystalbank__currency → choose currency (You can set these parameters according to available currencies and features for your CrystalBank 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 CrystalBank Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Enter credentials:

• External system ID
• Login
• Password
• SSL certificate
• SSL certificate private key

Set up Account Provider account¶

Step 1: Create Provider account¶

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

• crystalbank__ext_system_id → ExtsystemID
• crystalbank__login → LOGIN
• crystalbank__password → PASSWORD
• crystalbank__ssl_certificate → Generation of ssl_certificate ukrcard/crystalbank (sent to their mail and waiting for settings)
• crystalbank__ssl_private_key → Generation of ssl_private_key ukrcard/crystalbank (sent to their mail and waiting for settings)

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Enter credentials:

• External system ID
• Login
• Password
• SSL certificate
• SSL certificate private key

API examples:¶

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

SALE

POST /api/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_uah_hpp",
      "currency":"UAH",
      "amount":2.03,
      "reference_id":"1709718547",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false
      },
      "service_fields":[
      ]
    }
  }
}

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

SALE

POST /api/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_uah_hpp",
      "currency":"UAH",
      "amount":2.03,
      "reference_id":"1709718211",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"1709718211",
        "name":"Vlad Ivanov",
        "email":"[email protected]",
        "date_of_birth":"1999-08-25",
        "individual_tax_id":"174747****7488",
        "address":{
          "full_address":"7 rue dissoire-22",
          "country":"DZ",
          "region":"Nurnberg, Mittelfr (Neurothenbach)-1",
          "city":"Nurnberg, Mittelfr (Neurothenbach)-1",
          "street":"7 rue dissoire-22",
          "post_code":"65001"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false
      },
      "service_fields":[
      ]
    }
  }
}

Minimum data set to create a payout invoices for payment_card_uah service¶

PAYOUT

POST /api/commerce/payout-invoices HTTP/1.0
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "commerce_account": "Hello World",
      "currency": "UAH",
      "amount": 65.11,
      "reference_id": "cb9e1ab4-7ec8-48be-b6ee-cd23c215389f",
      "customer": {
        "reference_id": "414c9837-674d-4f9f-bfb5-f07aa01aa4a5",
        "address": {
          "country": "UA",
          "name": "Jogn Doe"
        }
      },
      "test_mode": true,
      "fields": {
        "card_number": "524872******1850"
      },
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

Maximum data set to create a payout invoices for payment_card_uah service¶

PAYOUT

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

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "commerce_account": "Hello World",
      "currency": "UAH",
      "amount": 65.11,
      "reference_id": "cb9e1ab4-7ec8-48be-b6ee-cd23c215389f",
      "customer": {
        "reference_id": "414c9837-674d-4f9f-bfb5-f07aa01aa4a5",
        "name": "John Doe",
        "individual_tax_id": "test",
        "reference_id": "414c9837-674d-4f9f-bfb5-f07aa01aa4a5",
        "address": {
          "country": "UA"
        }
      },
      "test_mode": true,
      "fields": {
        "card_number": "524872******1850"
      },
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

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:

• LANGUAGE → constant [language]

• LANGUAGE → constant [language]
• BUSINESS_APPLICATION_IDENTIFIER → constants [business_application_identifier]
• FUNDING_OR_PAYMENT_TRANSACTION_TYPE_INDICATOR → constants [funding_or_payment_transaction_type_indicator]
• PAYER_ACCOUNT_TYPE → constants [payer_account_type]
• PAYER_ACCOUNT_NUMBER → constants [payer_account_number]
• FUNDING_SOURCE → constants [funding_source]