📀Tài liệu kết nối VietQR

Mở Tài khoản VIetQR VN & Tự động khai báo kết nối Test

API Nhận biến động số dư

- Request mẫu

// Some code
curl --location –request
POST 'https://api-agency.trueconnect.vn/payment/VietQR/tanviet/transaction-sync' \
--header 'Content-Type: application/json' \
--data-raw '{
  "transactionId": "0a4cc317-3af3-4055-bc83-7296adb624bf",
  "transactionTime": "2024-05-1701:53",
  "referencenumber": "0a4cc317-3af3-4055-bc83-7296adb624bf",
  "amount": "100000",
  "content": "Chuyenkhoan",
  "bankAccount": "0362626234",
  "transType": "C",
  "orderId":"0a4cc317-3af3-4055-bc83-7296adb624bf",
  "signature": "241fad517529e1abfef81756f615a6edd0a765846f0e926563ee88540c4a9ef1"
}'

Trong đó:

Response:

{
    "error": false,
    "errorReason": "000",
    "toastMessage": "0a4cc317-3af3-4055-bc83-7296adb624bf",
    "messageError": "Success"
}

Trong đó:

1. Cách tạo signature

Secret: “YWN0aXZlX3NpZ24ga2V5LiBLZWVwIGl0IHNlY3JldCE=”

Gồm 2 thành phần là data và secret

Data dạng chuỗi

“ 0a4cc317-3af3-4055-bc83-7296adb624bf00001000002024-05-1701:530a4cc317-3af3-4055-bc83-7296adb624bf ”

Mô tả: chuỗi dạng

$“{transactionId}{Giá tiền dạng 10 chữ số}{transactionTime}{orderId}”

Ví dụ: với request mẫu ở mục 1

B1: Chuyển đổi chuỗi data và secret thành mảng byte sử dụng mã hóa UTF-8.

B2: Sử dụng mảng byte của secret như là khóa để tạo một đối tượng HMACSHA256 , một loại mã hóa được sử dụng để tạo giá trị băm (hash) với thuật toán SHA-256.

B3: Tính toán giá trị băm của mảng byte sinh từ data. Kết quả thu được là một mảng byte

B4: Duyệt qua từng mảng byte và chuyển đổi từng phần tử thành 1 chuỗi hex ghép lại thành signature cần tạo

Code mẫu .net

public static string HmacSha256Digest(string data, string secret)
  {
      if (string.IsNullOrEmpty(data)) return string.Empty;
      UTF8Encoding encoding = new();
      byte[] keyBytes = encoding.GetBytes(secret);
      byte[] messageBytes = encoding.GetBytes(data);
      HMACSHA256 cryptographer = new(keyBytes);

      byte[] bytes = cryptographer.ComputeHash(messageBytes);
      return bytes.ToHex();
  }

PreviousAPI Refund Transaction

Last updated 5 months ago

// Some code curl --location –request POST 'https://api-agency.trueconnect.vn/payment/VietQR/tanviet/transaction-sync' \ --header 'Content-Type: application/json' \ --data-raw '{ "transactionId": "0a4cc317-3af3-4055-bc83-7296adb624bf", "transactionTime": "2024-05-1701:53", "referencenumber": "0a4cc317-3af3-4055-bc83-7296adb624bf", "amount": "100000", "content": "Chuyenkhoan", "bankAccount": "0362626234", "transType": "C", "orderId":"0a4cc317-3af3-4055-bc83-7296adb624bf", "signature": "241fad517529e1abfef81756f615a6edd0a765846f0e926563ee88540c4a9ef1" }'

public static string HmacSha256Digest(string data, string secret) { if (string.IsNullOrEmpty(data)) return string.Empty; UTF8Encoding encoding = new(); byte[] keyBytes = encoding.GetBytes(secret); byte[] messageBytes = encoding.GetBytes(data); HMACSHA256 cryptographer = new(keyBytes); byte[] bytes = cryptographer.ComputeHash(messageBytes); return bytes.ToHex(); }