MKB (Moscow Credit Bank)

Quick Start

1. Sign up at mkb.ru and obtain API credentials
2. Create a terminal in the Admin Console with the parameters below
3. Start processing — the adapter is pre-built and ready to use

Go to MKB (Moscow Credit Bank) →

Overview

MKB (Moscow Credit Bank) payment integration

Provider ID	mkb
Category	Bank Transfers
Website	mkb.ru

---

Configuration

Required Parameters

Parameter	Description
mid	merchant identifier
aid	acquirer identifier (by default: 443222)
psp_id	identifier PSP (payment service provider)

Example Configuration

{
  "mid": "123456",
  "aid": "443222",
  "psp_id": "PSP001",
  "mcc_type": "aft",
  "redirection_remap": true
}

---

Payment Flow

Payments (one-phase):

1. init_payment - initialization payment via /{mcc_type}/paReq:
   • Sending data cards (pan, cvv, exp_date)
   • Currency is mapped to numeric code (RUB → 643)
   • Retrieval response_code
   • If code = 1 - parsing 3DS parameters
2. parse_3ds_response - version determination 3DS and creation redirect:
   • version 1: POST on acs_url with PaReq, MD, TermUrl
   • version 2: POST on methodUrl with threeDSMethodData
3. status - check via /getOrderStatus/{mid}/{oid}:
   • XML-response with field status
   • Parsing auth_responsedata for error_description

Payouts (one-phase):

1. init_payout - initialization via /a2c/purchase:
   • Generation random data sender from list referral persons (by citizenship)
   • Sending pan, client_mail, s_surname, s_firstName, s_address
   • Direct redirect in status "charging" with success (response_code = 1)

---

Status Mapping

Provider Status	4pay Status	Description
0 - WEB-request	new
1 - Authorization	charging
2 - Declined	rejected
3 - Completed	charged
4 - Cancelled	rejected
5 - Refund	reversed

---

Resources

• Official Documentation