API MBBank
API MBBank trong Open Banking cho phép các ứng dụng, phần mềm và nền tảng số của khách hàng kết nối, trao đổi dữ liệu với các dịch vụ ngân hàng một cách nhanh chóng, đảm bảo tốc độ đồng bộ giao dịch gần như tức thời.
Giới thiệu
Ngân hàng Thương mại Cổ phần Quân đội (tên giao dịch tiếng Anh là Military Commercial Joint Stock Bank), gọi tắt là ngân hàng Quân đội, viết tắt là MBBank, là một ngân hàng thương mại cổ phần của Việt Nam, một doanh nghiệp trực thuộc Bộ Quốc Phòng.
Các cổ đông chính của Ngân hàng Quân đội là Viettel, Tổng công ty Đầu tư và Kinh doanh Vốn Nhà nước, Tổng Công ty Trực thăng Việt Nam và Tổng Công ty Tân Cảng Sài Gòn. Ngoài dịch vụ ngân hàng, Ngân hàng Quân đội còn tham gia vào các dịch vụ môi giới chứng khoán, quản lý quỹ, kinh doanh địa ốc, bảo hiểm, quản lý nợ và khai thác tài sản bằng cách nắm cổ phần chi phối của một số doanh nghiệp trong lĩnh vực này. Hiện nay, Ngân hàng Quân đội đã có mạng lưới khắp cả nước với trên 100 chi nhánh và trên 190 điểm giao dịch trải dài khắp 48 tỉnh thành phố. Ngân hàng còn có văn phòng đại diện tại Liên bang Nga, chi nhánh tại Lào và Campuchia.
Logo MBBank
Tên ngân hàng | Ngân hàng TMCP Quân đội |
Tên giao dịch tiếng Anh | Military Commercial Joint Stock Bank |
Viết tắt | MBBank |
BIN | 970422 |
Swift | MSCBVNVX |
Website | https://www.mbbank.com.vn |
API tra cứu lịch sử giao dịch ngân hàng theo khoảng thời gian
curl --location --request POST 'https://my.pay2s.vn/userapi/transactions' \
--header 'pay2s-token: NTQ0MzI0ZjNlMzJiNGE4NjRkYTM5YjM5ZmUzY2ZhNzE0YTJjMjdlMGUyMTMyNDRjZGE2ZGU1Y2RkMmFlYmFiYw==' \
--header 'Content-Type: application/json'
--data '{
"bankAccounts": "006101991",
"begin": "01/09/2024",
"end": "15/10/2024"
}'
API truy vấn lịch sử giao dịch ngân hàng MBBank
- 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 Web/App
- 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
-
POSThttps://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": "ACB"
},
{
"account_number": "222629219",
"bank_id": "ACB"
}
],
"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 MBBank (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