Bắt đầu nhanh

Mục tiêu của hướng dẫn này là giúp hệ thống của bạn nhận thông báo ngay khi tài khoản ngân hàng có tiền vào.

Cách PayFS hoạt động

Bạn không cần liên tục gọi PayFS để kiểm tra giao dịch mới. PayFS sẽ chủ động gọi đến endpoint của bạn.

Bốn bước

1. Tạo Workspace và kết nối ngân hàng

Thực hiện trên Client Portal. Xem Tạo Workspace và Kết nối ngân hàng.

2. Dựng một endpoint nhận webhook

Endpoint cần công khai trên Internet và trả về HTTP 200.

const express = require('express');
const app = express();
app.use(express.json());

app.post('/payfs-webhook', (req, res) => {
  const apiKey = req.headers['x-client-api-key'];
  if (apiKey !== process.env.PAYFS_WEBHOOK_API_KEY) {
    return res.status(401).json({ error: 'Unauthorized' });
  }

  const tx = req.body;
  if (tx.transfer_type === 'credit') {
    console.log('Tiền về:', tx.amount, 'VND —', tx.content);
  }

  res.status(200).json({ status: 'ok' });
});

app.listen(3000);

3. Khai báo endpoint trong Client Portal

Vào phần thông báo của Workspace, tạo webhook rồi dán URL endpoint. PayFS sẽ tạo sẵn API key và secret cho webhook đó.

4. Thử một giao dịch thật

Chuyển một khoản nhỏ vào tài khoản đã kết nối. Endpoint của bạn sẽ nhận webhook trong vài giây.

Tiếp theo