API BIDV

API BIDV (Ngân hàng TMCP Đầu tư và Phát triển Việt Nam) sử dụng OpenAPI được cung cấp chính thức từ ngân hàng thông qua sự hợp tác giữa BIDV và Công ty CP Fute (Công ty mẹ của Pay2S ) là giải pháp công nghệ cho phép các ứng dụng, phần mềm và nền tảng số của khách hàng tích hợp trực tiếp với hệ thống dịch vụ ngân hàng. Điều này giúp khách hàng kết nối và trao đổi dữ liệu với BIDV một cách nhanh chóng, đồng bộ giao dịch tức thời, bảo mật cao và hiệu quả.

Giới thiệu

Ngân hàng TMCP Đầu tư và Phát triển Việt Nam (tên giao dịch tiếng Anh là Joint Stock Commercial Bank for Investment and Development of Vietnam), được gọi tắt là BIDV, là ngân hàng thương mại lớn nhất Việt Nam tính theo quy mô tài sản năm 2019 và là doanh nghiệp đứng thứ 10 trong danh sách 1000 doanh nghiệp đóng thuế thu nhập doanh nghiệp lớn nhất năm 2018

BIDV có hệ thống chi nhánh ở hầu hết các tỉnh thành, trong đó mạng lưới giao dịch khá dày ở các địa bàn phát triển như Hà Nội, Thành phố Hồ Chí Minh, Hải Phòng, Đà Nẵng, Phú Quốc, Nha Trang, Cần Thơ, Sa Pa…

Ngân hàng được xếp hạng thứ 13 (thứ 3 trong các ngân hàng sau Vietcombank và Techcombank) trong danh sách những nơi làm việc tốt nhất Việt Nam vào năm 2018.

Ngân hàng BIDV nhận 4 giải thưởng về dịch vụ dành cho khách hàng cá nhân 2022

Logo BIDV

Tên ngân hàng	Ngân hàng TMCP Đầu tư và Phát triển Việt Nam
Tên giao dịch tiếng Anh	Joint Stock Commercial Bank for Investment and Development of Vietnam
Viết tắt	BIDV
BIN	970418
Swift	BIDVVNVX
Website	https://www.bidv.com.vn

Chứng nhận hợp tác giữa Ngân hàng BIDV và Pay2S (Công ty CP Fute)

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

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 BIDV

• 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-Type: application/json

Request parameter

Key	Type	Required	Description
partnerCode	String	✓	Định danh duy nhất cho mỗi yêu cầu.
partnerName	String		Tên đối tác.
requestType	String(50)	✓	Định danh kiểu của request.
ipnUrl	String	✓	API nhận kết quả thanh toán của đối tác.
redirectUrl	String	✓	URL chuyển hướng sau khi thanh toán.
orderId	String	✓	Mã đơn hàng của đối tác.
amount	Long	✓	Số tiền cần thanh toán (VND).
orderInfo	String	✓	Thông tin đơn hàng.
bankAccounts	String	✓	Mảng chứa các số tài khoản và Bank Code.
requestId	String	✓	Định danh duy nhất cho mỗi yêu cầu.
signature	String	✓	Chữ 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": "BIDV"
    },
    {
        "account_number": "222629219",
        "bank_id": "BIDV"
    }
],
  "requestId": "1540456472575",
  "signature": "fd37abbee777e13eaa0d0690d184e4d7e2fb43977281ab0e20701721f07a0e07"
}

Code mẫu và demo

• Code mẫu: https://github.com/ThaiDuyKhang/collection-link-pay2s
• Demo: https://docs.pay2s.vn/example-collection-link/

Webhook truy vấn lịch sử giao dịch ngân hàng BIDV (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

• Bước 1: Hướng dẫn tạo webhook ghi nhận giao dịch từ Pay2S (nếu đã có webhook hãy bỏ qua bước này)
• Bước 2: Hướng dẫn tích hợp webhook Pay2S