Bank Wallet Deposit

📘 Banking, Wallet & Deposit APIs

Base URL:

http://127.0.0.1:8000/api/v1/taas/

Authentication:

API-KEY: <your-api-key>

---

🏦 Bank APIs

---

➕ 1. Add Bank Account

Endpoint

POST /bank/

Description

Add and verify a user bank account.

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/bank/' \
--header 'Content-Type: application/json' \
--header 'API-KEY: <API_KEY>' \
--data '{
    "account_id": 85,
    "bank_account_no": "20333858767",
    "bank_ifsc": "SBIN0000202",
    "bank_account_name": "Anurag Maurya",
    "bank_name": "State Bank of India"
}'

---

Response

{
  "id": 239,
  "account_id": 85,
  "status": "verified",
  "bank_account_no": "20333858767",
  "bank_ifsc": "SBIN0000202",
  "bank_account_name": "Anurag Maurya",
  "bank_name": "State Bank of India"
}

---

📄 2. Get Bank Accounts

Endpoint

GET /bank/

Query Params

Param	Description
account_id	Account identifier

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/bank/?account_id=85' \
--header 'API-KEY: <API_KEY>'

---

Response

{
  "count": 2,
  "results": [
    {
      "id": 239,
      "status": "verified"
    }
  ]
}

---

❌ 3. Delete Bank

Endpoint

POST /bank/delete/

Description

Delete a bank account.

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/bank/delete/' \
--header 'Content-Type: application/json' \
--header 'API-KEY: <API_KEY>' \
--data '{
    "bank_id": 231
}'

---

Response

{
  "message": "Bank deleted"
}

Response Code

204 No Content

---

💰 Wallet APIs

---

📊 4. Wallet Balance

Endpoint

GET /wallet/

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/wallet/?account_id=85' \
--header 'API-KEY: <API_KEY>'

---

Response

{
  "count": 3,
  "results": [
    {
      "asset": "INR",
      "current_balance": "2000.0000000000"
    }
  ]
}

---

🔐 Whitelisted Crypto Addresses

---

📥 5. Get Whitelisted Addresses

Endpoint

GET /wallet_addresses/

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/wallet_addresses/?account_id=85' \
--header 'API-KEY: <API_KEY>'

---

Response

{
  "count": 1,
  "results": [
    {
      "symbol": "USDT",
      "network": "TRX",
      "address": "TJFF6jPBrMENKoqrKAAgnbq3pDrjCCRy4r",
      "status": "approved"
    }
  ]
}

---

➕ 6. Create Whitelisted Address

Endpoint

POST /whitelist_wallet/

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/whitelist_wallet/' \
--header 'Content-Type: application/json' \
--header 'API-KEY: <API_KEY>' \
--data '{
    "account_id": 85,
    "asset": "USDT",
    "network": "TRX",
    "address": "TJFF6jPBrMENKoqrKAAgnbq3pDrjCCRy4r",
    "platform": "YOUR_PLATFORM_HERE",
    "address_label": "YOUR_LABEL_HERE"
}'

---

Response

{
  "id": 17,
  "symbol": "USDT",
  "status": "pending",
  "address": "TJFF6jPBrMENKoqrKAAgnbq3pDrjCCRy4r"
}

---

💳 Deposit APIs

---

📥 7. Get Deposit Details

Endpoint

GET /deposit_details/

---

Query Params

Param	Description
account_id	Account ID
currency	INR / AED

---

Example: INR

curl --location 'http://127.0.0.1:8000/api/v1/taas/deposit_details/?account_id=85&currency=INR' \
--header 'API-KEY: <API_KEY>'

---

Response

{
  "data": {
    "currency": "INR",
    "deposit_type": "bank_transfer",
    "available_bank_accounts": [
      {
        "bank_name": "State Bank of India"
      }
    ]
  }
}

---

💵 8. Create Deposit

Endpoint

POST /deposit/

---

Example: INR

curl --location 'http://127.0.0.1:8000/api/v1/taas/deposit/' \
--header 'Content-Type: application/json' \
--header 'API-KEY: <API_KEY>' \
--data '{
    "account_id": 85,
    "currency": "INR",
    "amount": 10000,
    "user_bank_id": 239,
    "carret_bank_id": 1,
    "transaction_reference_number": "jiouhg"
}'

---

Response

{
  "message": "Deposit transaction created successfully",
  "data": {
    "status": "pending",
    "amount": 10000
  }
}

---

🌐 9. Get Crypto Deposit Addresses

Endpoint

GET /deposit_addresses/

---

Request

curl --location 'http://127.0.0.1:8000/api/v1/taas/deposit_addresses/?chain=arbitrum' \
--header 'API-KEY: <API_KEY>'

---

Response

{
  "data": [
    {
      "address": "0x0fffacbf025f33a5372fce5ae0bb2c9777ff4e88",
      "chain": "Arbitrum",
      "asset": "USDT"
    }
  ]
}

---

🪙 10. Create Crypto Deposit

Endpoint

POST /crypto_deposit/

---

Description

Create a crypto deposit transaction (owned or third-party wallet).

---

📌 Example: Own Wallet

--data '{
  "account_id": 2,
  "asset": "USDT",
  "amount": "1000",
  "carret_wallet_id": 1,
  "txn_id": "0xabc...",
  "chain": "ETH",
  "declaration_data": {
    "is_wallet_owned": true,
    "reason_for_transfer": "Airdrop",
    "acknowledgement": true
  }
}'

---

📌 Example: Third-party Wallet

--data '{
  "account_id": 2,
  "asset": "USDT",
  "amount": "1000",
  "carret_wallet_id": 1,
  "txn_id": "0xabc...",
  "chain": "ETH",
  "declaration_data": {
    "is_wallet_owned": false,
    "reason_for_transfer": "Airdrop",
    "acknowledgement": true,
    "counterparty_name": "CARRETX TECHNOLOGIES PRIVATE LIMITED",
    "counterparty_pan": "AAJCC8786F"
  }
}'

---

Response

{
  "message": "Crypto deposit transaction created successfully",
  "data": {
    "status": "initiated",
    "amount": "1000.0000000000"
  }
}

---

📌 Notes

• Bank accounts must be verified before deposits

• Deposit limits are enforced (daily / weekly / monthly / annual)

• Crypto deposits require declaration metadata

• Wallet whitelisting is required for withdrawals (if applicable)

---

If you want, I can next:

• Merge all 3 docs (Account + KYC + Banking) into a single GitBook sidebar

• Add error handling + edge cases (very important for fintech APIs)

• Generate SDK examples (Python / Node.js) 🚀