API Ngân hàng TPBank

Thanh Toán Qua TPBank Với ApiPay

Kết nối tài khoản cá nhân, doanh nghiệp hoặc hộ kinh doanh TPBank vào ApiPay để nhận chuyển khoản tự động, gửi webhook realtime và quản lý payment request trên một giao diện duy nhất.

ApiPay - API Ngân hàng TPBank
Giao diện thanh toán ApiPay cho tích hợp TPBank

Bảo mật cao cấp

Dữ liệu thanh toán được mã hóa, xác thực đầy đủ và quản lý truy cập theo từng tài khoản API.

Thanh toán tức thời

Ngay khi khách chuyển khoản, ApiPay sẽ gửi thông báo giao dịch để hệ thống của bạn xử lý ngay.

API rõ ràng

REST API nhất quán, payload dễ đọc và có sẵn tài liệu để đội ngũ kỹ thuật vào việc nhanh.

Đa ngân hàng

Mở rộng từ một tài khoản hiện có sang nhiều ngân hàng khác mà không cần thay đổi quy trình thanh toán.

Webhook linh hoạt

Nhận webhook theo từng giao dịch để đối soát, cập nhật đơn hàng hoặc kích hoạt dịch vụ tự động.

Dashboard quản lý

Theo dõi tài khoản đã liên kết, payment request, doanh thu và trạng thái xử lý tại một nơi.

Yêu cầu trước khi kết nối

Tài khoản TPBank cá nhân, doanh nghiệp hoặc hộ kinh doanh đang hoạt động và có thể nhận chuyển khoản nội địa.

Liên kết xác nhận trong ứng dụng TPBank (TPBank Connect). Không cần kích hoạt thủ công bởi ApiPay.

Tài khoản ảo (VA) hiển thị dưới dạng tài khoản phụ của tài khoản gốc.

Thông tin CCCD / mã số thuế, tên chủ tài khoản, số tài khoản và số điện thoại liên kết.

Tài khoản ApiPay đã tạo access key và secret key để gọi API.

Kết nối ngân hàng

Kết nối tài khoản TPBank tại Dashboard > Ngân hàng. Cả ba loại tài khoản xác nhận trong ứng dụng TPBank, không qua kích hoạt thủ công.

Mở Dashboard ApiPay và vào mục Ngân hàng.
Chọn TPBank, chọn loại tài khoản, điền thông tin tài khoản và CCCD/mã số thuế.
Xác nhận Cho phép trong ứng dụng TPBank và chọn tài khoản nhận tiền. Sau đó sao chép bankPublicId để tạo payment request.
API mẫu cho TPBank

Tạo yêu cầu thanh toán với TPBank

JavaScriptTạo yêu cầu thanh toán
const auth = Buffer.from('${ACCESS_KEY}:${SECRET_KEY}').toString('base64');

const response = await fetch('https://app.apipay.vn/v1/client/payment-requests', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${auth}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    bankPublicId: 'tpb_public_id',
    amount: 500000,
    content: 'ORDER-TPB-001',
  }),
});

const {data} = await response.json();
console.log(data.payUrl);
PythonVí dụ RestAPI
import base64
import requests

token = base64.b64encode(b'your_access_key:your_secret_key').decode()

response = requests.post(
    'https://app.apipay.vn/v1/client/payment-requests',
    headers={
        'Authorization': f'Bearer {token}',
        'Content-Type': 'application/json',
    },
    json={
        'bankPublicId': 'tpb_public_id',
        'amount': 500000,
        'content': 'ORDER-TPB-001',
    },
    timeout=30,
)

print(response.json()['data']['payUrl'])
FAQ

Câu hỏi thường gặp

Sẵn sàng tích hợp?

Bắt đầu với TPBank ngay hôm nay

Tạo tài khoản miễn phí, kết nối ngân hàng trong Dashboard và đưa luồng thanh toán vào vận hành mà không cần đổi hệ thống hiện tại.