Bắt đầu nhanh

Tích hợp ThueAPI trong 5 phút

Hướng dẫn này giúp bạn nhận webhook giao dịch đầu tiên từ ThueAPI.VN.

Bước 1: Tạo tài khoản và API Key

1. Truy cập thueapi.vn/register và đăng ký
2. Vào Dashboard → API Keys → Tạo mới
3. Sao chép API key (chỉ hiển thị 1 lần)

Bước 2: Liên kết tài khoản ngân hàng

1. Vào Dashboard → Tài khoản ngân hàng → Thêm mới
2. Chọn ngân hàng và nhập thông tin
3. Xác nhận OTP nếu được yêu cầu

Bước 3: Tạo webhook endpoint

Tạo file webhook.php trên server của bạn:

<?php
// webhook.php — Nhận thông báo giao dịch từ ThueAPI.VN

// Bí mật webhook — lấy từ Dashboard > Webhooks
$webhookSecret = 'YOUR_WEBHOOK_SECRET';

// Lấy raw body và signature
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';

// Xác thực chữ ký HMAC-SHA256
$expectedSignature = hash_hmac('sha256', $payload, $webhookSecret);
if (!hash_equals($expectedSignature, $signature)) {
    http_response_code(401);
    echo json_encode(['error' => 'Invalid signature']);
    exit;
}

// Xử lý giao dịch
$data = json_decode($payload, true);
foreach ($data['transactions'] as $transaction) {
    $amount    = number_format($transaction['transferAmount']);
    $content   = $transaction['content'];
    $type      = $transaction['transferType']; // IN hoặc OUT
    $bank      = $transaction['gateway'];
    $txNumber  = $transaction['transactionNumber'];

    // TODO: Lưu vào database, cập nhật đơn hàng, gửi email, v.v.
    error_log("Giao dịch {$type}: {$amount} VND từ {$bank} - {$content} (#{$txNumber})");
}

// Phản hồi thành công — BẮT BUỘC trả về {"success": true}
http_response_code(200);
echo json_encode(['success' => true]);

Bước 4: Cấu hình webhook trên ThueAPI

1. Vào Dashboard → Webhooks → Thêm mới
2. Nhập URL: https://your-domain.com/webhook.php
3. Chọn sự kiện: Tất cả (IN + OUT)
4. Lưu và sao chép Webhook Secret

Bước 5: Test

Thực hiện giao dịch chuyển khoản vào tài khoản đã liên kết và kiểm tra log server của bạn. Webhook sẽ được gửi trong vòng <1 giây.