Link your bank account

Ha Tang learns about payments by reading the incoming transfers of your own bank account. You link that account once; from then on every transfer appears under Payments → Transactions, and transfers carrying a payment's code mark it paid. Ha Tang only reads the account: it can never move money out of it.

Linking needs the Manage level on the Payments module. Link the account in the environment you are working in: the simulated bank in Development, your real bank in Production (see How Ha Tang Payments works).

Before you start

• The account number and the holder's name exactly as the bank has it.
• For some banks, the national ID (CCCD) of a personal account holder or the tax code of a business account.
• The account holder, or someone they authorised, available at that moment: depending on the bank, they receive a code by SMS, approve on the bank's own page, or register a service at the bank.

Link the account

1. Open Payments → Payments settings, tab Bank accounts, and click Add bank account.
2. Pick your bank. Each bank links in its own way, and the form changes accordingly.
3. Fill in the form, tick the consent box if there is one, and click Send code or Link.
4. Finish with the bank, as described below.

After 5 wrong codes, the code stops working and you start again.

Pay2S step by step

Pay2S reads accounts at Vietcombank, VietinBank, Techcombank, BIDV, ACB, MB and TPBank and forwards each transaction to Ha Tang.

1. In Ha Tang, pick Pay2S. The form shows Endpoint for the Hook on Pay2S; copy it.
2. On my.pay2s.vn: link your bank account, then go to Webhooks → Add webhook. Pick the account, the event "All" or "Money in", and paste the endpoint.
3. Press the key icon in the Token column and copy the token. It is the long string, not the account number shown in that dialog's title.
4. Back in Ha Tang, choose the Bank, enter the Account number as Pay2S writes it, the holder's name, paste the Pay2S webhook token and click Link.
5. The account waits for Pay2S to send its first transaction, then becomes active. Make a small transfer into it if you want to activate it at once.

Account statuses

Each account shows when it was linked and its last transaction. If customers say they paid but nothing appears for hours, look at that date first.

Matching and notifications

Under each account, open Matching and notifications:

These settings only change what is reported to your systems. Payments are always matched.

Recover transfers the bank missed

Banks occasionally fail to report a transfer. Under Import a bank statement, upload a CSV made from your bank's statement, or paste it, and click Import. The columns are reference, booked_at, direction, amount, description, and optionally counterparty_account and counterparty_name.

Transfers Ha Tang already has are skipped, so importing an overlapping period is safe. Imported transfers are matched exactly like reported ones: a transfer carrying a payment's code marks it paid.

Unlink an account

Click Unlink on the account. MB Bank confirms with a code, like linking; other banks are unlinked at once. Unlinking an ACB account also withdraws the consent at ACB. For BIDV and Pay2S, also turn off the notification service or the Hook on their side.

Payments already made are kept. New payments can no longer be created into that account.

Troubleshooting

Developers can link and configure accounts through the API; see Bank connections in the developer hub.