Dushanbe City Bank

Quick Start

1. Sign up at dc.tj 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 Dushanbe City Bank →

Overview

Dushanbe City Bank payment integration

Provider ID	dushanbe
Category	Bank Transfers
Website	dc.tj

---

Configuration

Required Parameters

Parameter	Description
username	merchant login
password	merchant password
account	account number merchant (for example: 90135)
articul	product/service SKU (for example: 30)
sender_name	sender name (for example: FINHUB LLC)
username	merchant login
password	merchant password
sender_name	sender name

Example Configuration

{
  "env": "prod",
  "username": "merchant_login",
  "password": "merchant_password",
  "account": "90135",
  "articul": "30",
  "sender_name": "FINHUB LLC",
  "currency": "810"
}

---

Payment Flow

Payments (one-phase and two-phase via Acquiring):

1. create_payment - payment creation via POST /Payment.php:

   • XML payload with Order data
   • CardInfo: Pan, Month, Year (normalized to 4 digits), CVV, HolderName
   • Payee: FIO, Contact (first 6 digits cards), AccNumber (remaining digits)
   • AddParams: phone, SenderName, Sign (MD5 hash), CardholderIP, Resolution, UserAgent
   • Sign = MD5(orderid + login + password)
   • Retrieval URL3DS for redirect

2. get_payment_status - status check via GET /CheckPay.php:

   • Query params: orderid, mcht, sign
   • Parsing XML response
   • Check WithdrawalStatus and RechargeStatus
   • Error codes: 126, 130, 133 → return current status without changes

Payouts (one-phase via Expresspay):

1. create_payout - payout creation via GET /expresspay.asp:

   • Query params: command=pay, login, account (cardnumber), txn_id, prvid, ccy, sum, sign, txn_date, wallet (phone)
   • Sign = MD5(login + txn_id + account + password)
   • sum format: "100.50" (with decimal point)
   • txn_date format: YYMMDDHHMMSS
   • Parsing XML response with result code

2. get_payout_status - status check via GET /expresspay.asp:

   • Query params: command=getstatus, login, txn_id, sign
   • Sign = MD5(login + txn_id + password)
   • Parsing result code: 90 → new, 0 → charged, 12 → rejected

3. cancel_or_correct_payout - payout cancellation (refund):

   • Query params: command=cancel, login, account, txn_id, sign
   • Sign = MD5(login + txn_id + password)
   • result = 31 → rejected (cancelled)

---

Status Mapping

Provider Status	4pay Status	Description
90	new
0	charged
12	rejected

---

Resources

• Official Documentation