# TINGEE Open API > TINGEE (by HENO) Open API integration docs: virtual accounts (VA), QR Code, payment gateway, Direct Debit, disbursement (Direct Link), TingeeBox devices, e-invoices. Docs version: 1.2.2. General rules: - Base URL: https://open-api.tingee.vn (PROD), https://uat-open-api.tingee.vn (UAT). - Required headers: x-client-id, x-request-timestamp (yyyyMMddHHmmssSSS, UTC+7), x-signature = HMAC_SHA512("{timestamp}:{JSON.stringify(body)}", secretKey) as hex; requests without a body sign "{}". - Every API returns HTTP 200; check the "code" field ("00" = success). Error codes: https://developers.tingee.vn/en/md/docs/error-list.md - OpenAPI: https://developers.tingee.vn/en/openapi.json · Postman: https://developers.tingee.vn/en/tingee-open-api.postman_collection.json ## Get started - [Getting Started](https://developers.tingee.vn/en/md/docs/index.md): API and SDK documentation for integrating Tingee BaaS. Fast, convenient and secure payments via QR Code and Virtual Account. - [Webhook (IPN)](https://developers.tingee.vn/en/md/docs/webhook-ipn.md): Webhook (IPN — Instant Payment Notification) is the mechanism Tingee uses to push notifications to your server as soon as a transaction occurs, so you do not have to keep polling the API. ## Overview - [Get started](https://developers.tingee.vn/en/md/docs/config-info.md): Introduction {#giới-thiệu} - [Important notes](https://developers.tingee.vn/en/md/docs/luu-y-quan-trong.md): Before integrating, read the notes below carefully to make sure your system works correctly and reliably. ## Accounts & Identification - [Introduction to the Banking API](https://developers.tingee.vn/en/md/docs/banking/index.md): Core APIs that let partners manage virtual accounts (VA), handle debit/credit transactions, and perform in-depth financial reconciliation. - [List supported banks and e-wallets](https://developers.tingee.vn/en/md/docs/banking/get-banks.md): Use this API to get the list of banks and e-wallets that Tingee supports for account linking and virtual account (VA) creation. - [Query the account list](https://developers.tingee.vn/en/md/docs/banking/get-va-paging.md): Use this API to query the list of virtual accounts (VA) created on the Tingee system, with pagination and search by multiple criteria. - [Create a virtual account (VA)](https://developers.tingee.vn/en/md/docs/banking/create-va.md): Use this API to create a new virtual account (VA) for a Merchant, so you can receive balance notifications and manage cash flows separately. - [Confirm a virtual account (VA)](https://developers.tingee.vn/en/md/docs/banking/confirm-va.md): Use this API to confirm the creation of a virtual account (VA) after the initiation step. It is typically used when the bank requires OTP verification to complete the linking. - [Register for balance notifications (VA Notify)](https://developers.tingee.vn/en/md/docs/banking/register-notify.md): Use this API to register for balance notifications for a virtual account (VA), especially with banks that require a separate webhook registration step, such as ACB. Once registration succeeds, Tingee - [Confirm balance notification registration (VA Notify)](https://developers.tingee.vn/en/md/docs/banking/confirm-register-notify.md): Use this API to confirm the registration for balance notifications (VA Notify) after you have started the request via the register-notify API. This step usually requires an OTP sent by the bank to com - [Delete a virtual account (VA)](https://developers.tingee.vn/en/md/docs/banking/delete-va.md): Use this API to delete a previously created virtual account (VA). It is typically used when a Merchant wants to cancel VAs that are no longer in use. - [Confirm virtual account (VA) deletion](https://developers.tingee.vn/en/md/docs/banking/confirm-delete-va.md): Use this API to confirm the deletion of a virtual account (VA) after you have sent a deletion request. It is typically used when the bank requires OTP verification to complete the cancellation. - [Register for debit notifications](https://developers.tingee.vn/en/md/docs/banking/create-debit.md): Use this API to register for notifications of debit transactions (money out) on an ACB original account number. Once registration succeeds, every time money is deducted from the account, TINGEE sends - [Cancel debit notification registration](https://developers.tingee.vn/en/md/docs/banking/delete-debit.md): Use this API to cancel a debit transaction notification registration created with the Register for debit notifications API. If the account is also registered for credit notifications, the credit regis - [Transaction history](https://developers.tingee.vn/en/md/docs/banking/get-paging-transaction.md): Use this API to query the transaction history (credit and debit) of a Merchant or shop. You can filter by virtual account (VA) number, bank code or a specific time range for reconciliation. - [Bank Link SDK](https://developers.tingee.vn/en/md/docs/bank-link/index.md): The Tingee Bank Link SDK lets partners easily embed Tingee's bank account linking screen directly into their website or mobile app. - [Create a link session](https://developers.tingee.vn/en/md/docs/bank-link/create-session.md): This API lets the partner's server (backend) create a bank account link session (Bank Link Session) on the Tingee system and receive a secure SDK URL. - [Integrate the UI SDK (Frontend Web)](https://developers.tingee.vn/en/md/docs/bank-link/ui-sdk.md): Tingee provides a Web SDK (Frontend) library that lets you embed the bank linking interface directly into your website as a Popup (Modal) or display it Inline on the page. ## Payment solutions - [Payment Gateway](https://developers.tingee.vn/en/md/docs/payment-gateway/index.md): Tingee's payment gateway solution lets partners easily integrate a wide range of payment methods (VietQR, ATM card, Pay-by-Bank) into their website or app through a single payment link. - [Configure the payment gateway](https://developers.tingee.vn/en/md/docs/payment-gateway/config.md): For the payment gateway to work correctly and carry your business's brand identity, you need to configure the basic settings on the Tingee Merchant Portal. - [Create a payment link](https://developers.tingee.vn/en/md/docs/payment-gateway/create-payment-link.md): This API lets you create a payment link (Checkout URL) to send to your customer. When customers open this link, they can pay with any of the methods (VietQR, Card, Pay-by-Bank...) configured for the M - [Integrate the UI SDK (Frontend)](https://developers.tingee.vn/en/md/docs/payment-gateway/ui-sdk.md): Besides redirecting users directly to the Checkout URL, Tingee provides a Frontend SDK that lets you embed the payment experience directly in your website as a Popup (Modal). This keeps customers on y - [Integrate the iOS Native SDK](https://developers.tingee.vn/en/md/docs/payment-gateway/ios-sdk.md): The TingeePaySDK library lets native iOS apps easily embed an intuitive payment screen as a Bottom Sheet or in full screen. - [Integrate the Android Native SDK](https://developers.tingee.vn/en/md/docs/payment-gateway/android-sdk.md): The TingeePaySDK (AAR) library lets you integrate the Tingee payment gateway into a native Android app written in Kotlin or Java. - [QR Code overview](https://developers.tingee.vn/en/md/docs/qr/index.md): QR Code is a modern payment solution that cuts the transaction process down to a few seconds with a single scan in a banking app. - [Static QR code (VietQR)](https://developers.tingee.vn/en/md/docs/qr/static/index.md): A static QR code is a flexible payment solution that is created once and tied to the beneficiary account. It is the optimal choice for fixed points of sale or quick transfers that do not need order tr - [Create a static QR code (VietQR)](https://developers.tingee.vn/en/md/docs/qr/static/generate-viet-qr.md): Use this API to create a static QR code (VietQR) for a fixed bank account. This type of QR suits fixed payment points or models that do not need automatic payment-status tracking for each order. - [Dynamic QR code](https://developers.tingee.vn/en/md/docs/qr/dynamic/index.md): A dynamic QR code is the optimal payment solution for transactions that require absolute accuracy. Each QR code is generated separately for each order and contains the payment information or a referen - [Create a dynamic QR code (Dynamic QR)](https://developers.tingee.vn/en/md/docs/qr/dynamic/generate-dynamic-qr.md): Use this API to create a dynamic QR code for a specific transaction, supporting one-time or recurring payment depending on the configuration. - [Delete a dynamic QR code (Dynamic QR)](https://developers.tingee.vn/en/md/docs/qr/dynamic/delete-dynamic-qr.md): Use this API to delete or deactivate a dynamic QR code you have created. It is typically used when an order is cancelled or the customer changes payment method. - [Get dynamic QR code status](https://developers.tingee.vn/en/md/docs/qr/dynamic/get-status-dynamic-qr.md): Use this API to query the detailed status of a dynamic QR code you have created, so you can check its payment status in real time. - [Deep Link overview](https://developers.tingee.vn/en/md/docs/deeplink/index.md): Pay by Bank is a powerful solution that shortens the customer journey by opening the banking app directly from the payment screen on a mobile device. - [Create a Deep Link](https://developers.tingee.vn/en/md/docs/deeplink/deep-link.md): This API lets partners create a Deep Link that opens the banking app on a mobile device directly with the transaction details prefilled, shortening the user's steps and increasing the conversion rate. - [Deep Link transaction result redirect](https://developers.tingee.vn/en/md/docs/deeplink/deep-link-callback.md): After the user completes the steps in the banking app, Tingee automatically redirects the user back to the partner's app or website along with the transaction result. - [POS terminal payments](https://developers.tingee.vn/en/md/docs/pos-bill/index.md): This set of APIs lets partners create payment orders (POS bills) and push them directly to a POS terminal. The customer pays right on the POS terminal by card or QR code; TINGEE sends the payment resu - [Create a POS order](https://developers.tingee.vn/en/md/docs/pos-bill/create-pos-bill.md): Use this API to create a payment order and push it to a linked POS terminal. The customer pays the order directly on the POS terminal by card or QR code. - [POS order details](https://developers.tingee.vn/en/md/docs/pos-bill/get-detail-pos-bill.md): Use this API to look up the information and payment status of a POS order you created. The data is fetched directly from the Payoo system. - [Cancel a POS order](https://developers.tingee.vn/en/md/docs/pos-bill/update-pos-bill.md): Use this API to cancel a POS order created on a Payoo POS terminal, for example when the customer does not continue with the payment. - [Direct Debit](https://developers.tingee.vn/en/md/docs/direct-debit/index.md): Direct Debit is a payment method that lets partners automatically debit a customer's bank account after receiving valid authorization. It is the ideal solution for recurring billing, subscription rene - [Link an account](https://developers.tingee.vn/en/md/docs/direct-debit/register.md): Use this API to let a user register for and authorize linking a bank account. - [Pay a bill](https://developers.tingee.vn/en/md/docs/direct-debit/payment-bill.md): Use this API to create a bill payment request. - [Unlink an account](https://developers.tingee.vn/en/md/docs/direct-debit/delete-subscription.md): Use this API to unlink an account from the Direct Debit service. - [Refund a transaction](https://developers.tingee.vn/en/md/docs/direct-debit/refund.md): Use this API to refund a transaction paid via the Direct Debit service. - [Update the payment confirmation method](https://developers.tingee.vn/en/md/docs/direct-debit/edit-confirm-payment-method.md): Use this API to update how the customer confirms a bill payment before it is charged via the Direct Debit service. - [Query account status](https://developers.tingee.vn/en/md/docs/direct-debit/get-subscription-status.md): Use this API to query the link status of an account. - [Query transaction status](https://developers.tingee.vn/en/md/docs/direct-debit/get-transaction-status.md): Use this API to query the status of a transaction. - [Query transaction history](https://developers.tingee.vn/en/md/docs/direct-debit/get-paging-transactions.md): Use this API to query a customer's transaction history by time range or with pagination. - [Webhook](https://developers.tingee.vn/en/md/docs/direct-debit/webhook.md): Tingee sends a webhook to your endpoint when important events occur while you use the Direct Debit service. ## Disbursement - [Introduction to Disbursement (Direct Link)](https://developers.tingee.vn/en/md/docs/direct-link/index.md): Disbursement (Direct Link) is an automated payment solution that lets businesses create and manage money transfers directly to recipients' accounts/cards from the partner's system through TINGEE. - [Maker/Checker approval flow](https://developers.tingee.vn/en/md/docs/direct-link/workflow-maker-checker.md): The Maker/Checker approval flow applies to BIDV, which requires a high-security process and multi-level order approval. In this flow, a disbursement order can be saved as a draft (INIT) or submitted f - [Automatic disbursement flow](https://developers.tingee.vn/en/md/docs/direct-link/workflow-direct.md): The automatic disbursement flow is a minimal, fast transaction processing flow. The partner does not need to go through the multi-level security authentication steps of Maker/Checker; it only needs to - [Get authorization URL](https://developers.tingee.vn/en/md/docs/direct-link/get-authorization-url.md):