Transfer API Guide

The Transfer API uses a traditional account-based system where the API Provider manages user balances. You control fund transfers by calling deposit and withdrawal APIs.

How It Works

1. Initialize user accounts in API Provider
2. Call deposit API to add funds to player’s API provider balance
3. The API provider manages gameplay and balance automatically
4. Call withdraw API to remove funds from player’s provider balance

Request Specification

Tip

DOWINN handles all encryption, Base64 encoding, and MD5 hashing automatically. You don’t need to manually construct these parameters.

Headers

Name	Type	Required	Description
Api-Id	string	✅	Your agent identifier
Api-Key	string	✅	Your secret key

Common Parameters

Most Transfer API endpoints require these parameters in the request data:

Property	Type	Required	Description
user_id	string	✅	Unique user identifier
currency	string	✅	Currency code (KRW, USD, JPY, etc.)
language	string	✅	Language code (EN, KO, CN, JP)
home_url	string	❌	URL to redirect when user exits game
bet_n_min	number	✅	Minimum bet amount for normal bets
bet_n_max	number	✅	Maximum bet amount for normal bets

Sample Request

POST /account-init HTTP/1.1
Content-Type: application/json
Api-Id: your-agent-id
Api-Key: your-secret-key

{
   "user_id": "testuser",
   "nick_name": "testusernickname",
   "currency": "USD"
}

Sample Response

{
  "code": 0
}

Note

Code 0 indicates a successful request. Other codes represent various error conditions.

Making a Request

Sample Code (Node.js)

import axios from 'axios';

const headers = {
  'Content-Type': 'application/json',
  'Api-Id': 'your-agent-id',
  'Api-Key': 'your-secret-key',
};

const body = {
  user_id: 'testuserid',
  agent_id: 'your-agent-id',
  balance: 0,
  currency: 'PHP',
};

try {

   const response = await axios.post(
      'https://API-PROVIDER/account-init',
      body,
      { headers }
   );

   console.log('Response:', response.data);

   /*
   {
   "code": 0
   }
   */

} catch (error) {
   console.error('Error:', error.response?.data || error.message);
}

Available Endpoints

Transfer API Endpoints

• Account & Balance Management
  • /account-init - Initialize user account
  • /account-balance - Check account balance
  • /account-deposit - Deposit funds
  • /account-withdraw - Withdraw funds
  • /check-transaction - Verify transaction status

Common API Endpoints

• Game Access

  • /game-lobby - Get game lobby URL

• Information & Management

  • /bet-history - Retrieve bet history
  • /bet-limit - Get betting limits
  • /get-table-list - List available tables
  • /online-users - Get online user count
  • /game-kick - Force user to exit game
  • /check-transaction - Check transaction status

Example Integration Flow

1. Initialize Account

   Call /account-init to create a user account in DOWINN’s system.

2. Add Funds

   Use /account-deposit to add funds to the player’s DOWINN balance.

3. Launch Game

   Call /game-lobby to get the game URL for the user to start playing.

4. Remove Funds

   Use /account-withdraw to remove funds from the player’s DOWINN balance.

5. Check Balance

   Query /account-balance anytime to check the player’s current balance stored in DOWINN.

6. Verify Transactions

   Use /check-transaction to confirm the status of any deposit or withdrawal operations.

Next Steps

• Explore the API Reference for detailed endpoint documentation