Card Deposits

Card deposits allow you to fund your Intotes account by transferring RUB from your bank card to the platform's card. A platform operator verifies the payment and credits your balance. Commission is 0%.

How It Works

1. Check Limits and Card Details

Before creating an order, fetch the platform's card details and deposit limits:

GET /api/v1/card/limits

Response:

{
  "platform_card": {
    "bank_name": "...",
    "card_number": "...",
    "holder_name": "..."
  },
  "min_amount_kopecks": 10000,
  "max_amount_kopecks": 5000000
}

• platform_card -- the bank card details to which you should send your transfer.
• min_amount_kopecks / max_amount_kopecks -- allowed deposit range in kopecks (100 kopecks = 1 RUB).

2. Create a Deposit Order

POST /api/v1/card/orders

Request body:

{
  "type": "deposit",
  "amount_kopecks": 500000
}

• type -- must be "deposit".
• amount_kopecks -- the deposit amount in kopecks (e.g., 500000 = 5,000 RUB).

Response:

{
  "id": 42
}

The order is created with status pending.

3. Transfer Funds

Using your banking app, transfer the specified amount to the platform card shown in the /card/limits response. Make sure the amount matches exactly.

4. Confirm Payment

After you have sent the transfer, mark the order as paid:

POST /api/v1/card/orders/{id}/confirm-paid

This moves the order status from pending to paid_by_user. The platform operator is notified.

5. Operator Confirms Receipt

The platform operator checks their bank account for the incoming transfer. Once confirmed, the operator marks the order as completed, and your balance is credited with the deposited amount.

Order Status Flow

pending  -->  paid_by_user  -->  completed
   |
   +--> cancelled (by user or operator)

Status	Description
pending	Order created, awaiting your bank transfer
paid_by_user	You confirmed payment, operator reviewing
completed	Operator confirmed receipt, balance credited
cancelled	Order cancelled before completion

Chat With Operator

Each card order has an integrated chat. If you have questions or need to resolve an issue:

Send a message:

POST /api/v1/card/orders/{id}/messages

{
  "message": "I sent the transfer, receipt attached."
}

Read messages:

GET /api/v1/card/orders/{id}/messages?limit=50&offset=0

View Your Orders

GET /api/v1/card/orders/my?type=deposit&status=pending&limit=20&offset=0

All query parameters are optional. Filter by type (deposit or withdraw) and status (pending, paid_by_user, completed, cancelled).

Cancelling an Order

You can cancel an order while it is still in pending status:

POST /api/v1/card/orders/{id}/cancel

Once you have confirmed payment (paid_by_user status), cancellation requires operator intervention.

Error Codes

Code	Description
AMOUNT_TOO_LOW	Amount is below the minimum deposit limit
AMOUNT_TOO_HIGH	Amount exceeds the maximum deposit limit
ACTIVE_ORDER_EXISTS	You already have an active card order of this type
CARD_DISABLED	Card payments are temporarily unavailable