Skip to main content

📦 API v1.2.2 – Purchase invoices, POS payments and ACB debit notifications

v1.2.2 documents 11 new APIs across 3 feature groups, and reviews and standardizes all parameter, error code and code sample documentation to match the actual behavior of the system.

🧾 Purchase invoices​

Automatically retrieve a business's purchase invoices from the General Department of Taxation (provider XCyber supported). See the Purchase invoices overview.

  • POST /v1/e-invoice/input/connect – Connect a tax account
  • POST /v1/e-invoice/input/disconnect – Disconnect a tax account
  • POST /v1/e-invoice/input/sync – Sync purchase invoices
  • POST /v1/e-invoice/input/list – List purchase invoices
  • POST /v1/e-invoice/input/detail – Purchase invoice details
  • POST /v1/e-invoice/input/preview-base64 – Download the PDF rendition

🏪 POS payments​

Create an order and push it directly to a Payoo POS terminal so the customer can pay by card or QR. See POS payments.

  • POST /v1/create-pos-bill – Create a POS order
  • GET /v1/get-detail-pos-bill – POS order details
  • PUT /v1/update-pos-bill – Cancel a POS order

🏦 Debit notifications (ACB)​

Register for notifications of outgoing transactions on an ACB source account.

🛠️ Documentation improvements​

  • Consistent code samples in 5 languages (cURL, NestJS, C#, Java, PHP) for every API, with tested signatures. The samples pin the UTC+7 time zone and do not escape non-ASCII characters when signing, which avoids errors 90, 91 and 97.
  • Your chosen programming language is remembered across all pages.
  • The error code list adds a System error codes group and API rate limits; every API has its own error code table.
  • Parameters standardized to match the live system, including these changes to note when integrating:
    • VietinBank disbursement: use debitAccountNumber, records[].creditAccountNumber, records[].creditBankBin (instead of sender* / receiver*).
    • BIDV disbursement: use creditBankBin, creditIssueDate, creditIssueAddress; paginate lookups with skipCount / maxResultCount.
    • Direct Debit: look up transactions by transactionId.
    • Business account configuration: accountType accepts business-account / business-household-account.

✨ Documentation site experience​

  • 🌐 Multi-language (Tiếng Việt / English): the API and SDK documentation is now available in English at developers.tingee.vn/en. Switch languages with the VI | EN button in the navigation bar; you stay on the same page. The English version covers the latest documentation version; the Sandbox is currently available in Vietnamese only.
  • 🤖 Ask AI on every page: a toolbar under each page title offers Ask AI (opens ChatGPT, Claude, Perplexity, Grok or Cursor with the page content), Copy Markdown to paste into AI tools, and .md to view the page as Markdown.
  • 🧰 Developer resources per language: OpenAPI, the Postman Collection and llms.txt / llms-full.txt come in Vietnamese (at the root) and English (under /en/), e.g. https://developers.tingee.vn/en/openapi.json. See Developer toolkit.
  • 🌙 Improved dark mode: code blocks, sample responses, Sandbox banners, flow diagrams and the version badge now use dark backgrounds that are easier to read in dark mode.
  • 📱 Navigation menu in sync with the sidebar: the mobile "Main features" menu and the desktop navigation bar show every documentation section (now including Important notes, Changelog...) and follow the version you are viewing.
  • 🎨 New look: the header, sidebar and table of contents are rounded cards aligned in a single frame. The right-hand table of contents highlights the section you are reading; on medium screens (1000–1200px) it sticks below the header and always shows the current section. A Sandbox shortcut card now sits under the table of contents.
  • 🧪 Tidier Sandbox: the "Back" bar and page content of every Sandbox now line up with the header.