Business account configuration

The Business account configuration API group lets Merchants and Master Merchants set up and manage the configuration that connects business bank accounts to the TINGEE system.

Before you start

• Base URL: https://uat-open-api.tingee.vn (UAT) · https://open-api.tingee.vn (PROD)
• Authentication: Every request must include the x-client-id and x-request-timestamp headers and the x-signature signature (HMAC SHA512). See How to get an API Key & generate the signature.
• Result: The API always returns HTTP 200; check the code field (00 = success). See Error codes.

Once connected, a business Merchant can create Virtual Accounts (VA) to receive payments and sync transactions in real time via Webhook (IPN).

Who uses it

User	Description
Merchant	Configures its own business bank account.
Master Merchant	Configures on behalf of its sub-Merchants by also passing merchantId.

Flow

1. Call Create / Update configuration to configure the bank information.
2. (ACB only) Call Configure business account to configure the ACB business account information and receive a confirmId.
3. (ACB only) Complete the confirmation by calling Create / Update configuration with the confirmId.
4. Use List configurations to check the information.

ACB business account configuration flow

← Swipe to see more →

API list

Function	Method	Endpoint
List configurations	POST	/v1/merchant/get-paging-config
Create / Update configuration	POST	/v1/merchant/create-or-update-config
Delete configuration	POST	/v1/merchant/delete-config
[ACB] Configure business account	POST	/v1/merchant/config-account-business
[ACB] Delete business account configuration	POST	/v1/merchant/delete-config-account-business