SePay Integration Guide
Step-by-step instructions to connect SePay with your Uni8 community, enabling bank transfer payments via VietQR.
Step 1: Create and Set Up SePay Account
-
Go to SePay Login and sign in to your account.
-
Visit Bank Connection - SePay to connect your bank account.

-
Enter your bank information and follow SePay's instructions.

Step 2: Company Configuration
- Go to Configuration - SePay to set up company settings.
In the configuration section, make sure to enable and activate these 2 important settings:
- Payment Code Recognition
- Payment Code Structure (DH code)

Step 3: Create API Token
Visit API Access - SePay to create an API Token for authentication. Enter a name (e.g., uni8) and select status "Active" to create the API Token.

Step 4: Add Webhooks
Go to Webhooks - SePay and select "Add webhook".
Fill in the webhook information with the following configuration:
- Name: your choice (e.g., thanh toán uni8)
- Send webhook when: select "Money in"
- When bank account is: select the bank you just added
- Skip if transaction content has no payment code?: select Yes
- Call to URL:
https://uni8.ai/webhook/sepay - Is this a payment verification webhook?: select "Yes"
- Retry webhook when?: check this option
- Authentication type: select API Key
- Request Content type: select application/json
- API Key: enter the API Token created in step 3


Step 6: Integrate SePay into Uni8
- Sign in to your community admin account at Sign in | uni8.

- Select "Admin panel" at the bottom of the sidebar.

- Go to Settings → Payment Gateway → connect SePay.

- Enter your SePay bank account information:
| Field | Value |
|---|---|
| Select bank | The bank you added in SePay |
| Beneficiary name | Account holder name |
| Account number | Bank account number |
| Order prefix | The "Prefix" field in Payment Code Structure (step 3) |
| Maximum suffix characters | The "To" value in the "Suffix" section of Payment Code Structure (step 3) |
| Suffix type | The "Is" value in the "Suffix" section of Payment Code Structure (step 3) |

- Click Submit to complete the connection.