API v3.7Production

Columbia Pay

Customer API Documentation

Base URL: https://columbiamoneypay.com

Last Updated: March 25, 2026

Introduction

The Columbia Pay API enables customers to perform deposit, withdrawal, and transaction status inquiry operations.

Credentials Provided

Terminal ID: Your customer identifier (e.g: demobahis)
API Key: Your key for signing transactions (pk_live_...)
Secret Key: Your secret key for hash calculation (sk_live_...)
Authentication
Hash calculation and security

What is Hash?

Hash is an encrypted key that proves your transaction is secure. With hash, your transaction is securely transmitted, no one can perform transactions on your behalf, and the system can verify that the transaction is authentic.

Hash Calculation Rules

Hash Formula Summary

Withdrawal: apiKey + islemid + tuser + tadsoyad + amount + secretKey
Status (POST): apiKey + islemid + secretKey
API Endpoints
Available operations and usage
GET/deposit/{ terminalid }

Deposit

Customer is redirected to this URL to initiate a deposit request.

URL Parameters
ParameterTypeRequiredDescription
terminalidStringTerminal ID (e.g: demobahis)
amountStringDeposit amount in TRY
payment_nameStringPayment method
Supported Payment Methods

Bank Methods

  • papara
  • paycell
  • hepsipay
  • param
  • paribu
  • havale
  • vip-havale

Crypto Methods

  • bitcoin
  • tether-trc20
  • tether-erc20
  • tron
  • solana
Example URL
https://columbiamoneypay.com/deposit/demobahis?amount=500.00&payment_name=havale
POST/api/withdraw

Withdrawal

Customer submits a withdrawal request via the API.

Request Parameters
ParameterRequiredFormatDescription
terminalid-Terminal ID
tuser-Username
tadsoyad-Full Name
amount"500.00"Withdrawal amount
islemid"CKM..."Unique withdrawal ID
payment_name-Payment method
cekim_iban-IBAN for fund transfer
hash64 charSHA256 hash
Hash Calculation Example

Step 1: Write the parameters

API Key: pk_live_abc123
Transaction ID: CKM20260325001
Username: user123
Full Name: John Smith
Amount: 500.00
Secret Key: sk_live_xyz789

Step 2: Concatenate (no spaces)

pk_live_abc123CKM20260325001user123John Smith500.00sk_live_xyz789

Step 3: Encrypt with SHA256

d4f2c3a1b5e7f9d2a4c6e8f0b2d4a6c8e0f2b4d6a8c0e2f4b6d8a0c2e4f6b

GET/api/transaction/status/{ terminalid }/{ islemid }

Transaction Status

Query transaction status with a simple GET request without hash.

Possible Status Values
StatusDescription
pendingTransaction is pending
completedTransaction completed successfully
canceledTransaction was canceled
failedTransaction failed
POST/api/status-check

Secure Status Check

Use POST method to securely query transaction status with hash.

Hash Calculation (Status Query)

SHA256(apiKey + islemid + secretKey)

Error Management
HTTP Status Codes
CodeMeaningDescription
200OKTransaction successful
201CreatedNew record created
400Bad RequestMissing or incorrect parameters
401UnauthorizedUnauthorized (hash error)
404Not FoundTransaction not found
409ConflictDuplicate transaction ID
500Server ErrorServer error
Code Examples
Implementation examples in different programming languages

Withdrawal Operation

const crypto = require('crypto');
const fetch = require('node-fetch');

const apiKey = 'pk_live_abc123';
const secretKey = 'sk_live_xyz789';

const hashString = apiKey + islemid + tuser + tadsoyad + amount + secretKey;
const hash = crypto.createHash('sha256').update(hashString).digest('hex');

const response = await fetch('https://columbiamoneypay.com/api/withdraw', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    terminalid, tuser, tadsoyad, amount, islemid, 
    payment_name, cekim_iban, hash
  })
});
Important Notes

🔒 Security

Always keep your secret keys confidential. Use HTTPS for all requests. Never expose API keys in client-side code.

🆔 Transaction ID

Each transaction must have a unique ID. Duplicate IDs will be rejected by the system.

💵 Amount Format

Amount should be sent as a string with decimal point (e.g: "500.00"). Always use two decimal places.

🔄 CORS

API requests must be made from your server. Client-side requests will be blocked by CORS policy.

For Questions

Join Our Teams

Columbia Pay API v3.7 • Last Updated: March 25, 2026