# Tạo ứng dụng thông báo

`POST /service/@id/tinopay/notification-apps` · TinoPay, token đăng nhập của chủ dịch vụ

Bước 4. `type` không đổi được sau khi tạo. `bot_token`: Zalo bắt buộc (bot riêng); Telegram có thì dùng bot riêng, bỏ trống thì dùng bot chung @allpay_telebot (`endpoint` là ID nhóm bắt đầu bằng `-`); Lark không gửi (`endpoint` là URL webhook bot Lark). `virtual_accounts`: số VA của tài khoản ngân hàng đó, rỗng là mọi VA. Trả 201.

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/tinopay/notification-apps` |
| Method | `POST` |
| Xác thực | token đăng nhập của chủ dịch vụ TinoPay (`Authorization: Bearer <token>`); gateway `/v1` chưa mở TinoPay |
| Content-Type | `application/json` |

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `id` | đường dẫn | int | có | ID dịch vụ TinoPay |
| `type` | body | string | có | telegram \| zalo \| lark (không đổi được sau khi tạo) |
| `name` | body | string | có | ≤ 250 |
| `endpoint` | body | string | có | — |
| `bot_token` | body | string | — | — |
| `bank_account_id` | body | string | có | — |
| `virtual_accounts` | body | array | — | — |
| `status` | body | string | — | active \| inactive |

## Example request

```bash
curl -X POST "https://api.tino.vn/service/100001/tinopay/notification-apps" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "zalo",
  "name": "Nhóm kế toán",
  "endpoint": "zgr-1a2b3c4d5e6f7a8b9c0d",
  "bot_token": "<bot_token>",
  "bank_account_id": "9c1e6f2a-5b7d-4e1a-9f3c-2d8b6a4e0c11",
  "virtual_accounts": [
    "9624QA01"
  ]
}'
```

`$TINO_TOKEN` là token đăng nhập của chủ dịch vụ TinoPay. Tham số đường dẫn trong ví dụ là giá trị mẫu.

SDK ([SDK & Ví dụ](/docs/sdk)): chưa có hàm riêng, dùng `client.request("POST", "/service/@id/tinopay/notification-apps")`.

## Example response

```json
{
 "data": {
  "id": 7,
  "type": "zalo",
  "name": "Nhóm kế toán",
  "endpoint": "zgr-1a2b3c4d5e6f7a8b9c0d",
  "bot": "own",
  "bot_token_masked": "<masked>",
  "bank_account_id": "9c1e6f2a-5b7d-4e1a-9f3c-2d8b6a4e0c11",
  "virtual_accounts": [
   "9624QA01"
  ],
  "status": "active",
  "last_error": null,
  "last_error_at": null,
  "created_at": "2026-10-22T09:00:00+07:00",
  "updated_at": "2026-10-22T09:00:00+07:00"
 }
}
```

Mẫu dựng theo tài liệu TinoPay API v1 (Tino chuyển tiếp nguyên dữ liệu TinoPay), giá trị là ví dụ.