Transfer Integration Overview

What is Transfer Integration?

Transfer integration means API Provider holds the player’s balance. You control fund transfers by calling our API to deposit or withdraw money from the player’s API Provider account.

Key Benefits

• Centralized Balance: API Provider manages the player’s balance
• Transaction Control: You decide when to deposit or withdraw to the player’s account balance
• Simplified Integration: API Provider handles all in-game transactions automatically
• Easy Management: You only call deposit, withdrawal, and check balance APIs

How It Works

1. Player’s balance is stored in API Provider’s system
2. You call deposit API to add funds to their API Provider balance
3. API Provider manages all in-game transactions (bets, wins, losses) automatically
4. You call withdraw API to remove funds from their API Provider balance
5. You handle the money on your end as needed

Supported Currencies

KRW, USD, JPY, CNY, PHP, HKD, THB, VND, BDT, INR

Request Specification

Tip

API Provider 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

Integration Flow

API Endpoints

Endpoint	Purpose	When to Use
Account Init	Create API Provider account	First time player accesses games
Account Deposit	Add funds to API Provider balance	Player wants to add money
Account Withdraw	Remove funds from API Provider balance	Player wants to cash out
Account Balance	Check player’s API Provider balance	View the current balance stored in API Provider
Check Transaction	Verify transaction status	Confirm pending transactions

Important Considerations

Error Handling

Refer to the error codes to handle common scenarios like insufficient balance, account not found, duplicate transactions, and invalid amounts.

Error Codes

{
  "https": {
    "200": "successful request",
    "202": "failed request",
    "500": "internal error"
  },
  "codes": {
    "0": "successful request",
    "1": "error occured",
    "2": "missing data",
    "3": "invalid key",
    "4": "data format error",
    "5": "expired request",
    "6": "invalid agent",
    "9": "blocked user",
    "100": "data value error",
    "101": "permission denied",
    "102": "insufficient balance",
    "103": "integration failure"
  },
  "history_types": {
    "ALL": "all",
    "END": "ended",
    "ING": "ongoing"
  }
}

Transaction Idempotency

• Use unique transaction IDs for all deposits and withdrawals
• Duplicate transaction IDs will return the original response
• Never reuse transaction IDs across different operations

Balance Management

Your Responsibility:

• Decide when to add funds (call deposit API)
• Decide when to remove funds (call withdraw API)
• Handle transaction failures and retries
• Track your own financial records if needed

API Provider’s Responsibility:

• Store and manage player’s balance
• Process all bets, wins, and losses automatically
• Update balance for deposits and withdrawals
• Provide current balance information on request

Security

• All requests must be encrypted (see Encryption Guide)
• Validate amounts before API calls
• Use HTTPS for all endpoints
• Store credentials securely
• Log all transactions for auditing

Implementation Sequence

Follow this order when implementing transfer integration:

Phase 1: Account Setup

1. Implement Account Init
2. Test account creation for new players
3. Handle existing account scenarios

Phase 2: Fund Transfers

4. Implement Account Deposit
5. Test adding funds to player’s API Provider balance
6. Implement Account Withdraw
7. Test removing funds from player’s API Provider balance

Phase 3: Balance & Verification

8. Implement Account Balance
9. Implement Check Transaction
10. Test complete deposit-play-withdraw flow

Prerequisites

Before starting implementation, ensure you have:

• ✅ API credentials from API Provider
• ✅ Understanding of encryption methods

Next Steps

1. Read the Getting Started Guide
2. Understand Transfer API concepts
3. Set up your encryption
4. Implement Account Init
5. Test deposit and withdrawal flows
6. Review integration patterns above

---

Ready to start? Begin with Account Init to create your first API Provider account.