Skip to main content

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

  1. Go to SePay Login and sign in to your account.

  2. Visit Bank Connection - SePay to connect your bank account. Bank Connection List

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

ACB Bank Setup


Step 2: Company Configuration

  1. 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) Company Configuration

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.

API Access List


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

Webhook Configuration

Webhook Authentication Configuration


Step 6: Integrate SePay into Uni8

  1. Sign in to your community admin account at Sign in | uni8.

Uni8 Login

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

Admin Panel

  1. Go to SettingsPayment Gateway → connect SePay.

Payment Gateway

  1. Enter your SePay bank account information:
FieldValue
Select bankThe bank you added in SePay
Beneficiary nameAccount holder name
Account numberBank account number
Order prefixThe "Prefix" field in Payment Code Structure (step 3)
Maximum suffix charactersThe "To" value in the "Suffix" section of Payment Code Structure (step 3)
Suffix typeThe "Is" value in the "Suffix" section of Payment Code Structure (step 3)

SePay Bank Information Form

  1. Click Submit to complete the connection.

Next Steps