Skip to main content

📝 API Update – BaoKim integration & Disbursement parameter update

This update brings the BaoKim e-wallet into the Disbursement service and standardizes the parameter that classifies the receiving account in the API.

🚀 BaoKim integration (Disbursement – Direct Link)​

Tingee now officially supports the BaoKim e-wallet. Partners can sync their wallet for both Collection and Disbursement.

  • Identifier BIN: BAOKIM
  • Supported API flows:
    • Create a disbursement order (single orders only; batch orders have been removed)
    • Beneficiary account inquiry (Account Inquiry)
    • Transaction status inquiry (Transaction Inquiry)
    • Wallet account integration (wallet sync with the BAOKIM identifier)
    • The APIs in the Banking & Identification group

👉 See: Create a disbursement order (VietinBank, BaoKim)

🔄 Standardized disbursement parameter (creditAccountType)​

To unify the payment data structure and support routing to more partners such as BaoKim and BIDV, we standardized the account type parameter of the Create disbursement order API.

Changes to the /v1/direct-link/create-transfer API:

  • Field replaced: paymentMethod (to-acc, to-id) has been removed and fully replaced by the creditAccountType field.
  • How it works: creditAccountType can be set at both the global level (Global Parameter) and the record level.
  • New supported values:
    • ACCOUNT: transfer to an account number
    • CARD: transfer to a card number
    • WALLET: transfer to an e-wallet
    • ID: transfer to an identity document (ID card / citizen ID / passport)

This gives the payload a consistent structure and makes it easier to add new payment channels in the future.