API Vietinbank

API Vietinbank (Ngân hàng TMCP Công Thương Việt Nam ) sử dụng chuẩn OpenAPI để cung cấp khả năng tích hợp liền mạch giữa các ứng dụng, phần mềm và nền tảng số của khách hàng với các dịch vụ ngân hàng. Với OpenAPI, việc kết nối được thực hiện một cách nhanh chóng, đáng tin cậy và đảm bảo giao dịch gần như đồng bộ tức thời.

Giới thiệu

Ngân hàng TMCP Công Thương Việt Nam (tên giao dịch tiếng Anh là Vietnam Joint Stock Commercial Bank For Industry And Trade), được thành lập từ năm 1988 sau khi tách ra từ Ngân hàng Nhà nước Việt Nam. Tên giao dịch ban đầu là INCOMBank. Năm 2008, INCOMBank đổi tên thành VietinBank. VietinBank hiện có 1 Sở giao dịch, 150 Chi nhánh và trên 1000 Phòng giao dịch/ Quỹ tiết kiệm trải rộng trên toàn quốc.

Theo trang chủ của ngân hàng Vietinbank:

  • Có quan hệ đại lý với trên 900 ngân hàng, định chế tài chính tại hơn 90 quốc gia và vùng lãnh thổ trên toàn thế giới.
  • Là ngân hàng đầu tiên của Việt Nam được cấp chứng chỉ ISO 9001:2000.
  • Là thành viên của Hiệp hội Ngân hàng Việt Nam, Hiệp hội ngân hàng châu Á, Hiệp hội Tài chính viễn thông Liên ngân hàng toàn cầu (SWIFT), Tổ chức Phát hành và Thanh toán thẻ VISA, MASTERCARD quốc tế.
  • Là ngân hàng đầu tiên tại Việt Nam mở chi nhánh tại châu Âu, đánh dấu bước phát triển vượt bậc của nền tài chính Việt Nam trên thị trường khu vực và thế giới.

Logo Vietinbank

Tên ngân hàngNgân hàng TMCP Công Thương Việt Nam
Tên giao dịch tiếng AnhVietnam Joint Stock Commercial Bank For Industry And Trade
Viết tắtVietinbank
BIN970436
SwiftICBVVNVX
Websitehttps://www.vietinbank.vn

API Vietinbank tra cứu lịch sử giao dịch theo khoảng thời gian

POST
https://my.pay2s.vn/userapi/transactions
curl --location --request POST 'https://my.pay2s.vn/userapi/transactions'
--header 'pay2s-token: xxxxxxxxxxxxxxxxxxx'
--header 'Content-Type: application/json'
--data '{
    "bankAccounts": "006101991",
    "begin": "01/09/2024",
    "end": "15/10/2024"
}'

Trong đó:

  • pay2s-token: Bạn sẽ cần lấy Secret Key từ menu Tích hợp > Website/Application trên hệ thống của Pay2S, dùng ngôn ngữ lập trình phù hợp với website, ứng dụng của bạn để mã hóa chuỗi Secret Key thành Base64. Sau đó thay chuỗi Secret Key vừa mã hoá vào chuỗi xxxxxxxxxxxxxxxxxxx của pay2s-token để thêm vào header.
  • bankAccounts: “Số tài khoản của bạn đã kết nối trên hệ thống Pay2S”
  • begin: “Ngày bắt đầu”
  • end: “Ngày kết thúc”

API truy vấn lịch sử giao dịch ngân hàng Vietinbank

  • Bước 1: Liên kết tài khoản vào Pay2S
  • Bước 2: Lấy mã tương ứng tại mục Tích hợp > Website/Application
    • Partner Code: Định danh duy nhất của tài khoản P2S của bạn
    • Access Key: Mã cấp quyền truy cập vào hệ thống Pay2S.
    • Secret Key: Dùng để tạo chữ ký điện tử digital signature.
  • Bước 3: Cấu hình HTTP request
    • POST
      https://payment.pay2s.vn/v1/gateway/api/create
    • Content-Typeapplication/json

Request parameter

KeyTypeRequiredDescription
partnerCodeStringĐịnh danh duy nhất cho mỗi yêu cầu.
partnerNameStringTên đối tác.
requestTypeString(50)Định danh kiểu của request.
ipnUrlStringAPI nhận kết quả thanh toán của đối tác.
redirectUrlStringURL chuyển hướng sau khi thanh toán.
orderIdStringMã đơn hàng của đối tác.
amountLongSố tiền cần thanh toán (VND).
orderInfoStringThông tin đơn hàng.
bankAccountsStringMảng chứa các số tài khoản và Bank Code.
requestIdStringĐịnh danh duy nhất cho mỗi yêu cầu.
signatureStringChữ ký xác nhận giao dịch.
Sử dụng thuật toán Hmac_SHA256 với data theo định dạng: 1 chuỗi String được sort theo thứ tự alphabet:

accessKey=$accessKey&amount=$amount&accountNumber=$accountNumber&ipnUrl=$ipnUrl&orderId=$orderId&orderInfo=$orderInfo&partnerCode=$partnerCode&redirectUrl=$redirectUrl&requestId=$requestId&requestType=$requestType

Example value

{
  "partnerCode": "PAY2Sxxxxxxxxxxx",
  "partnerName": "Pay2S - Giải pháp thanh toán tự động, biến động số dư",
  "requestType": "PAY2S",
  "ipnUrl": "https://pay2s.vn",
  "redirectUrl": "https://pay2s.vn",
  "orderId": "P2S1540456",
  "amount": 150000,
  "orderInfo": "WEB2M Team",
  "bankAccounts": [
    {
        "account_number": "737478888",
        "bank_id": "ACB"
    },
    {
        "account_number": "222629219",
        "bank_id": "ACB"
    }
],
  "requestId": "1540456472575",
  "signature": "fd37abbee777e13eaa0d0690d184e4d7e2fb43977281ab0e20701721f07a0e07"
}

Code mẫu và demo

Webhook truy vấn lịch sử giao dịch ngân hàng Vietinbank (Khuyến nghị)


Sử dụng Webhook giúp xử lý thông tin theo thời gian thực mà không tiêu tốn nhiều tài nguyên.

Việc tích hợp rất đơn giản với PHP, NodeJS hoặc bất kỳ ngôn ngữ lập trình nào khác, chỉ cần khai báo điểm nhận dữ liệu, sau đó hệ thống sẽ tự động nhận phản hồi từ Pay2S và xử lý dữ liệu giao dịch ngay trên nền tảng của bạn.

Các bước tạo và tích hợp webhook

5/5 – (172 votes)

Bài viết khác

API MoMo

API MoMo (Ví điện tử MoMo) cung cấp khả năng tích hợp liền mạch giữa các ứng dụng, phần mềm và nền tảng số của…