API ACB
API ACB (Ngân hàng Thương Mại Cổ Phần Á Châu) 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 thương mại cổ phần Á Châu (tên giao dịch tiếng Anh là Asia Commercial Joint Stock Bank), được gọi tắt là Ngân hàng Á Châu (ACB), chính thức đi vào hoạt động kinh doanh ngày 4 tháng 6 năm 1993 được do ông Nguyễn Quang Phúc đảm nhiệm chức vụ Chủ Tịch HĐQT.
Gồm 280 chi nhánh và phòng giao dịch tại những vùng kinh tế phát triển trên toàn quốc: TP Hồ Chí Minh, Hà Nội, Hải Phòng, Thanh Hóa, Hưng Yên, Bắc Ninh, Quảng Ninh, Vĩnh Phúc, Thanh Hóa, Đà Nẵng, Daklak, Gia Lai, Khánh Hòa, Ninh Thuận, Hội An, Huế, Nghệ An, Lâm Đồng, Long An, Tiền Giang, Vĩnh Long, Cần Thơ, Hậu Giang, Đồng Tháp, An Giang, Kiên Giang, Bến Tre và Cà Mau, Đồng Nai, Tây Ninh, Bình Dương, Vũng Tàu
Trên 2.000 đại lý chấp nhận thanh toán thẻ của Trung tâm thẻ ACB đang hoạt động. Khoảng 812 đại lý chi trả của Trung tâm chuyển tiền nhanh ACB-Western Union.
Logo ACB
Tên ngân hàng | Ngân hàng TMCP Á Châu |
Tên giao dịch tiếng Anh | Asia Commercial Joint Stock Bank |
Viết tắt | ACB |
BIN | 970416 |
Swift | ASCBVNVX |
Website | https://www.acb.com.vn |
API ACB 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 ACB
- 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
-
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 ACB (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