# TinoPay

Receive bank transfers through linked bank accounts and virtual accounts (VA); webhooks and Telegram, Zalo, Lark notifications for each transaction; API tokens.

Every route is called through the gateway `https://api.tino.vn/v1` with `Authorization: Bearer <token>`; see [Calling the Tino API](/en/docs/api).

## Guides

- [Getting started with TinoPay](/en/docs/tinopay-start)
- [Receiving TinoPay webhooks](/en/docs/tinopay-webhook)
- [Telegram, Zalo and Lark notifications](/en/docs/tinopay-notifications)
- [TinoPay public API](/en/docs/tinopay-api)
- [No-code integrations](/en/docs/tinopay-integrations)

## Merchant

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay` | [Merchant details](/en/docs/api/tinopay-get-merchant) | — |
| `PATCH` | `/service/@id/tinopay` | [Update merchant details](/en/docs/api/tinopay-patch-merchant) | — |
| `GET` | `/service/@id/tinopay/pay-codes` | [Payment code patterns](/en/docs/api/tinopay-get-pay-codes) | — |
| `PUT` | `/service/@id/tinopay/pay-codes` | [Save payment code patterns](/en/docs/api/tinopay-put-pay-codes) | — |

## Bank accounts

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/bank-accounts` | [List bank accounts](/en/docs/api/tinopay-get-bank-accounts) | — |
| `GET` | `/service/@id/tinopay/bank-accounts/@bank` | [Bank account details](/en/docs/api/tinopay-get-bank-accounts-bank) | — |
| `POST` | `/service/@id/tinopay/bank-links/bidv-business` | [Request a BIDV business link](/en/docs/api/tinopay-post-bank-links-bidv-business) | — |

## Virtual accounts

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts` | [List virtual accounts (VA)](/en/docs/api/tinopay-get-bank-accounts-bank-virtual-accounts) | — |
| `POST` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts` | [Create a virtual account](/en/docs/api/tinopay-post-bank-accounts-bank-virtual-accounts) | — |
| `POST` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts/@va/activate` | [Activate a virtual account](/en/docs/api/tinopay-post-bank-accounts-bank-virtual-accounts-va-activate) | — |
| `POST` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts/@va/deactivate` | [Deactivate a virtual account](/en/docs/api/tinopay-post-bank-accounts-bank-virtual-accounts-va-deactivate) | — |
| `DELETE` | `/service/@id/tinopay/bank-accounts/@bank/virtual-accounts/@va` | [Delete a virtual account](/en/docs/api/tinopay-delete-bank-accounts-bank-virtual-accounts-va) | — |

## Webhooks

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/webhooks` | [List webhooks](/en/docs/api/tinopay-get-webhooks) | — |
| `POST` | `/service/@id/tinopay/webhooks` | [Create a webhook](/en/docs/api/tinopay-post-webhooks) | — |
| `GET` | `/service/@id/tinopay/webhooks/@webhook` | [Webhook details](/en/docs/api/tinopay-get-webhooks-webhook) | — |
| `PATCH` | `/service/@id/tinopay/webhooks/@webhook` | [Update a webhook](/en/docs/api/tinopay-patch-webhooks-webhook) | — |
| `DELETE` | `/service/@id/tinopay/webhooks/@webhook` | [Delete a webhook](/en/docs/api/tinopay-delete-webhooks-webhook) | — |
| `GET` | `/service/@id/tinopay/webhook-logs` | [Webhook logs](/en/docs/api/tinopay-get-webhook-logs) | — |
| `POST` | `/service/@id/tinopay/webhook-logs/@log/resend` | [Resend a webhook log](/en/docs/api/tinopay-post-webhook-logs-log-resend) | — |

## Transactions

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/transactions` | [Transaction history](/en/docs/api/tinopay-get-transactions) | — |
| `GET` | `/service/@id/tinopay/transactions/summary` | [Transaction summary](/en/docs/api/tinopay-get-transactions-summary) | — |
| `GET` | `/service/@id/tinopay/transactions/@transaction` | [Transaction details](/en/docs/api/tinopay-get-transactions-transaction) | — |
| `POST` | `/service/@id/tinopay/transactions/@transaction/resend-webhook` | [Resend webhooks for a transaction](/en/docs/api/tinopay-post-transactions-transaction-resend-webhook) | — |

## Notifications

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `POST` | `/service/@id/tinopay/notification-apps/bot-info` | [Check a bot token](/en/docs/api/tinopay-post-notification-apps-bot-info) | — |
| `POST` | `/service/@id/tinopay/notification-apps/find-chats` | [Find a bot's chats](/en/docs/api/tinopay-post-notification-apps-find-chats) | — |
| `POST` | `/service/@id/tinopay/notification-apps/test` | [Send a test message](/en/docs/api/tinopay-post-notification-apps-test) | — |
| `GET` | `/service/@id/tinopay/notification-apps` | [List notification apps](/en/docs/api/tinopay-get-notification-apps) | — |
| `POST` | `/service/@id/tinopay/notification-apps` | [Create a notification app](/en/docs/api/tinopay-post-notification-apps) | — |
| `GET` | `/service/@id/tinopay/notification-apps/@app` | [Notification app details](/en/docs/api/tinopay-get-notification-apps-app) | — |
| `PATCH` | `/service/@id/tinopay/notification-apps/@app` | [Update a notification app](/en/docs/api/tinopay-patch-notification-apps-app) | — |
| `DELETE` | `/service/@id/tinopay/notification-apps/@app` | [Delete a notification app](/en/docs/api/tinopay-delete-notification-apps-app) | — |

## Sapo integration

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `POST` | `/service/@id/tinopay/sapo-integrations/test` | [Test the Sapo connection](/en/docs/api/tinopay-post-sapo-integrations-test) | — |
| `GET` | `/service/@id/tinopay/sapo-integrations` | [List Sapo integrations](/en/docs/api/tinopay-get-sapo-integrations) | — |
| `POST` | `/service/@id/tinopay/sapo-integrations` | [Create a Sapo integration](/en/docs/api/tinopay-post-sapo-integrations) | — |
| `GET` | `/service/@id/tinopay/sapo-integrations/@integration` | [Get a Sapo integration](/en/docs/api/tinopay-get-sapo-integrations-integration) | — |
| `PATCH` | `/service/@id/tinopay/sapo-integrations/@integration` | [Update a Sapo integration](/en/docs/api/tinopay-patch-sapo-integrations-integration) | — |
| `DELETE` | `/service/@id/tinopay/sapo-integrations/@integration` | [Delete a Sapo integration](/en/docs/api/tinopay-delete-sapo-integrations-integration) | — |
| `GET` | `/service/@id/tinopay/sapo-order-logs` | [Sapo reconciliation log](/en/docs/api/tinopay-get-sapo-order-logs) | — |

## API tokens

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/service/@id/tinopay/api-tokens` | [List API tokens](/en/docs/api/tinopay-get-api-tokens) | — |
| `POST` | `/service/@id/tinopay/api-tokens` | [Create an API token](/en/docs/api/tinopay-post-api-tokens) | — |
| `DELETE` | `/service/@id/tinopay/api-tokens/@token` | [Revoke an API token](/en/docs/api/tinopay-delete-api-tokens-token) | — |