MTB Bank¶

Website: mtb.ua

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

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

• mtbbank__wallet_id → Wallet ID
• mtbbank__partner_token → Token
• mtbbank__api_public_key → Public key
• mtbbank__api_secret_key → Secret key
• mtbbank__test_mode → true/false
• mtbbank__currency → choose currency (You can set these parameters according to available currencies and features for your ... 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 MTB Bank Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Enter credentials:

• Wallet ID
• Token
• Public key
• Private key

Set up Account¶

Step 1: Create merchant account¶

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

• Token
• Private Key
• Public Key
• Terminal ID

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Enter credentials:

• Token → Token
• Private Key → Private Key
• Public Key → Public Key
• Terminal ID → Terminal ID

API examples:¶

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

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_uah_hpp",
      "commerce_account":"Hello_World",
      "currency":"UAH",
      "amount":13.16,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"905020e6-37e7-449c-9133-df34fb3f9004",
      "service_fields":[
      ]
    }
  }
}

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

POST /api/commerce/payout-invoices HTTP/1.1
PAYOUT

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "commerce_account": "Hello_World",
      "currency": "UAh",
      "amount": 100,
      "test_mode": false,
      "reference_id": "f23ab13a-383b-4fd5-a973-41163ae14233",
      "fields": [],
      "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¶

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

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "commerce_account": "Hello_World",
      "currency": "UAh",
      "amount": 100,
      "test_mode": false,
      "reference_id": "f23ab13a-383b-4fd5-a973-41163ae14233",
      "customer": {
        "reference_id": "edwef2323dwd",
        "name": "John Doe"
      },
      "fields": [],
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

Additional information¶

Constants for payouts¶

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:

• status_operation_type → For each type of operation, you should assign the codes provided by the provider to constant.
• payout_operation_type → For each type of operation, you should assign the codes provided by the provider to constant.

Provider Options¶

H2H merchant account¶

• customer_name_format
  • this option will help you correctly parse first, last and patronymic names

Provider account¶

• payout_purpose
  • The option specifies the key from which we retrieve the value