Skip to main content

🚀 API v1.0.0 – First release

v1.0.0 is the first official release of the Tingee API, covering the complete Banking & VA, QR Code, TingeeBox, Deep Link, Webhook and SDK systems.

It is the standard foundation for partners to integrate Tingee's full range of payment and device services.

📦 SDK​

Official SDK libraries for fast integration with the Tingee Open API:

  • NodeJS — npm package, with TypeScript support
  • .NET — NuGet package, compatible with .NET 6+
  • Java — Maven/Gradle, with Spring Boot support
  • PHP — Composer package, compatible with PHP 7.4+

🏦 Banking & VA​

The complete set of APIs for account linking and transaction processing:

  • List supported banks
  • List account numbers
  • Create / link an account number
  • Confirm an account number
  • Register for balance notifications
  • Confirm notification registration
  • Delete an account number
  • Confirm deletion
  • Refund a transaction
  • Transaction history

📱 QR Code​

Supports both static and dynamic QR codes:

Static QR Code:

  • Create a static VietQR code following the NAPAS standard

Dynamic QR Code:

  • Create a dynamic QR code for each specific order
  • Delete a dynamic QR code
  • Check the payment status of a dynamic QR code

📦 TingeeBox​

Integrate the TingeeBox payment device at the point of sale:

  • Have the device read out its security code
  • Read out the transaction amount
  • Show a QR code on the device screen
  • Create and show a dynamic QR code directly on the device
  • Add a device to a shop
  • Update the device link status
  • List devices by Merchant
  • List devices by shop / VA account

🔗 Pay by Bank (Deep Link)​

Accept payments through banking apps with Deep Link:

  • Create a payment Deep Link that opens the banking app directly
  • Receive the payment result via the partner's callback URL

🌐 Webhook (IPN)​

Receive real-time transaction notifications:

  • Payment webhooks for QR and Deep Link
  • Balance notification webhooks for VA accounts
  • Webhook signature verification for security

⚙️ Operations & Extensions​

Multi-level management for Master Merchants:

  • Manage sub-Merchants (create, look up)
  • Manage shops (create, update, look up)
  • Manage devices (reset a device)
  • Business account configuration (create, update, delete)

🔐 Security​

  • API key authentication required for every request
  • HMAC signature verification for IPN webhooks
  • HTTPS enforced on all endpoints
  • Default rate limits and request size limits