# TinoPay

Nhận chuyển khoản qua tài khoản ngân hàng liên kết và tài khoản ảo (VA); webhook, thông báo Telegram, Zalo, Lark cho từng giao dịch; API token.

Mọi route gọi qua gateway `https://api.tino.vn/v1` với `Authorization: Bearer <token>`; xem [Gọi API Tino](/docs/api).

## Hướng dẫn

- [Bắt đầu với TinoPay](/docs/tinopay-start)
- [Nhận webhook TinoPay](/docs/tinopay-webhook)
- [Thông báo Telegram, Zalo, Lark](/docs/tinopay-notifications)
- [API công khai TinoPay](/docs/tinopay-api)
- [Tích hợp không cần code](/docs/tinopay-integrations)

## Merchant

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay` | [Thông tin merchant](/docs/api/tinopay-get-merchant) | — |
| `PATCH` | `/service/@id/tinopay` | [Sửa thông tin merchant](/docs/api/tinopay-patch-merchant) | — |
| `GET` | `/service/@id/tinopay/pay-codes` | [Cấu trúc mã thanh toán](/docs/api/tinopay-get-pay-codes) | — |
| `PUT` | `/service/@id/tinopay/pay-codes` | [Lưu cấu trúc mã thanh toán](/docs/api/tinopay-put-pay-codes) | — |

## Tài khoản ngân hàng

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/bank-accounts` | [Danh sách tài khoản ngân hàng](/docs/api/tinopay-get-bank-accounts) | — |
| `GET` | `/service/@id/tinopay/bank-accounts/@bank` | [Chi tiết tài khoản ngân hàng](/docs/api/tinopay-get-bank-accounts-bank) | — |
| `POST` | `/service/@id/tinopay/bank-links/bidv-business` | [Yêu cầu liên kết BIDV doanh nghiệp](/docs/api/tinopay-post-bank-links-bidv-business) | — |

## Tài khoản ảo

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts` | [Danh sách tài khoản ảo (VA)](/docs/api/tinopay-get-bank-accounts-bank-virtual-accounts) | — |
| `POST` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts` | [Tạo tài khoản ảo](/docs/api/tinopay-post-bank-accounts-bank-virtual-accounts) | — |
| `POST` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts/@va/activate` | [Mở tài khoản ảo](/docs/api/tinopay-post-bank-accounts-bank-virtual-accounts-va-activate) | — |
| `POST` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts/@va/deactivate` | [Khoá tài khoản ảo](/docs/api/tinopay-post-bank-accounts-bank-virtual-accounts-va-deactivate) | — |
| `DELETE` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts/@va` | [Xoá tài khoản ảo](/docs/api/tinopay-delete-bank-accounts-bank-virtual-accounts-va) | — |

## Webhook

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/webhooks` | [Danh sách webhook](/docs/api/tinopay-get-webhooks) | — |
| `POST` | `/service/@id/tinopay/webhooks` | [Tạo webhook](/docs/api/tinopay-post-webhooks) | — |
| `GET` | `/service/@id/tinopay/webhooks/@webhook` | [Chi tiết webhook](/docs/api/tinopay-get-webhooks-webhook) | — |
| `PATCH` | `/service/@id/tinopay/webhooks/@webhook` | [Sửa webhook](/docs/api/tinopay-patch-webhooks-webhook) | — |
| `DELETE` | `/service/@id/tinopay/webhooks/@webhook` | [Xoá webhook](/docs/api/tinopay-delete-webhooks-webhook) | — |
| `GET` | `/service/@id/tinopay/webhook-logs` | [Log webhook](/docs/api/tinopay-get-webhook-logs) | — |
| `POST` | `/service/@id/tinopay/webhook-logs/@log/resend` | [Gửi lại log webhook](/docs/api/tinopay-post-webhook-logs-log-resend) | — |

## Giao dịch

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/transactions` | [Lịch sử giao dịch](/docs/api/tinopay-get-transactions) | — |
| `GET` | `/service/@id/tinopay/transactions/summary` | [Tổng hợp giao dịch](/docs/api/tinopay-get-transactions-summary) | — |
| `GET` | `/service/@id/tinopay/transactions/@transaction` | [Chi tiết giao dịch](/docs/api/tinopay-get-transactions-transaction) | — |
| `POST` | `/service/@id/tinopay/transactions/@transaction/resend-webhook` | [Bắn lại webhook cho giao dịch](/docs/api/tinopay-post-transactions-transaction-resend-webhook) | — |

## Thông báo

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `POST` | `/service/@id/tinopay/notification-apps/bot-info` | [Kiểm token bot](/docs/api/tinopay-post-notification-apps-bot-info) | — |
| `POST` | `/service/@id/tinopay/notification-apps/find-chats` | [Tìm nơi nhận của bot](/docs/api/tinopay-post-notification-apps-find-chats) | — |
| `POST` | `/service/@id/tinopay/notification-apps/test` | [Gửi tin thử](/docs/api/tinopay-post-notification-apps-test) | — |
| `GET` | `/service/@id/tinopay/notification-apps` | [Danh sách ứng dụng thông báo](/docs/api/tinopay-get-notification-apps) | — |
| `POST` | `/service/@id/tinopay/notification-apps` | [Tạo ứng dụng thông báo](/docs/api/tinopay-post-notification-apps) | — |
| `GET` | `/service/@id/tinopay/notification-apps/@app` | [Chi tiết ứng dụng thông báo](/docs/api/tinopay-get-notification-apps-app) | — |
| `PATCH` | `/service/@id/tinopay/notification-apps/@app` | [Sửa ứng dụng thông báo](/docs/api/tinopay-patch-notification-apps-app) | — |
| `DELETE` | `/service/@id/tinopay/notification-apps/@app` | [Xoá ứng dụng thông báo](/docs/api/tinopay-delete-notification-apps-app) | — |

## Tích hợp Sapo

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `POST` | `/service/@id/tinopay/sapo-integrations/test` | [Thử kết nối Sapo](/docs/api/tinopay-post-sapo-integrations-test) | — |
| `GET` | `/service/@id/tinopay/sapo-integrations` | [Danh sách tích hợp Sapo](/docs/api/tinopay-get-sapo-integrations) | — |
| `POST` | `/service/@id/tinopay/sapo-integrations` | [Tạo tích hợp Sapo](/docs/api/tinopay-post-sapo-integrations) | — |
| `GET` | `/service/@id/tinopay/sapo-integrations/@integration` | [Chi tiết tích hợp Sapo](/docs/api/tinopay-get-sapo-integrations-integration) | — |
| `PATCH` | `/service/@id/tinopay/sapo-integrations/@integration` | [Sửa tích hợp Sapo](/docs/api/tinopay-patch-sapo-integrations-integration) | — |
| `DELETE` | `/service/@id/tinopay/sapo-integrations/@integration` | [Xoá tích hợp Sapo](/docs/api/tinopay-delete-sapo-integrations-integration) | — |
| `GET` | `/service/@id/tinopay/sapo-order-logs` | [Nhật ký đối soát Sapo](/docs/api/tinopay-get-sapo-order-logs) | — |

## API token

| Method | Đường dẫn | Tên | Quyền |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/api-tokens` | [Danh sách API token](/docs/api/tinopay-get-api-tokens) | — |
| `POST` | `/service/@id/tinopay/api-tokens` | [Tạo API token](/docs/api/tinopay-post-api-tokens) | — |
| `DELETE` | `/service/@id/tinopay/api-tokens/@token` | [Thu hồi API token](/docs/api/tinopay-delete-api-tokens-token) | — |