API Shinhan Bank

SHBVN API

Tích hợp giao dịch Shinhan Bank

Khai thác giao dịch Shinhan Bank qua API token để đưa dữ liệu thanh toán vào phần mềm của bạn. Kết nối này phù hợp cho doanh nghiệp, dịch vụ định kỳ và hệ thống đối soát giao dịch.

Tài liệu API theo phiên bản

Chọn phiên bản tương ứng trong trang quản lý tài khoản Shinhan Bank để xem tham số và dữ liệu trả về.

curl --request GET \
  "https://thueapibank.vn/historyapishinhan/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapishinhan/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapishinhan/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "type": "IN",
      "transactionID": "FT26091912345678",
      "amount": 450000,
      "description": "DH1024 THANH TOAN",
      "transactionDate": "2026-09-19 10:24:36"
    }
  ]
}

curl --request GET \
  "https://thueapibank.vn/historyapishinhanv2/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapishinhanv2/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapishinhanv2/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "type": "IN",
      "transactionID": "FT26091912345678",
      "amount": 450000,
      "description": "DH1024 THANH TOAN",
      "transactionDate": "2026-09-19 10:24:36"
    }
  ]
}

Response thực tế có thể bổ sung trường riêng của Shinhan Bank. Luôn kiểm tra trường tồn tại trước khi đọc.

Luồng xử lý khuyến nghị

1. 1
   Lưu mã giao dịch

   Dùng transactionID làm khóa chống xử lý trùng.

2. 2
   Chỉ xử lý tiền vào

   Kiểm tra type === "IN" trước khi ghép đơn.

3. 3
   Ghép đúng đơn hàng

   So khớp số tiền và mã đơn trong nội dung chuyển khoản.

4. 4
   Đối soát lại

   Chạy tác vụ định kỳ để bù các webhook bị chậm hoặc thất bại.

Tài liệu liên quan

API Vietcombank→API Vietcombank Biz→API MBBank→API ACB→