Danh sách deeplink các ngân hàng được hỗ trợ
Trả về danh sách deeplink các ngân hàng được hỗ trợ
- application/json
- application/x-www-form-urlencoded
Request Body required
API dùng để lấy danh sách deeplink các ngân hàng được hỗ trợ
- app_id string required
Định danh cho ứng dụng (web, app, pos ...) hay dịch vụ (auto-debit, disbursement ...) của Merchant được cấp khi đăng ký tích hợp phương thức thanh toán với Zalopay.
- bank_codes string required
Danh sách mã Ngân hàng mà Doanh nghiệp cần lấy thông tin deeplink, được phân tách bởi ký tự "," và không có khoảng trắng.
Ví dụ: BIDV,VCB. - os_type string required
Nền tảng di động. Giá trị:
ios
hoặcandroid
. - order_token string required
Giá trị
order_token
được trả về khi sử dụng API tạo đơn hàng (Create order). Giá trị này truyền vào, sẽ hỗ trợ sắp xếp Danh sách deeplink trả về theo thứ tự ưu tiên Ngân hàng hỗ trợ tự động điền thông tin thanh toán lên trước.
Chú ý: Khuyến khích truyền giá trị này vào, để nhận được thông tin các Ngân hàng hỗ trợ điền thông tin thanh toán. - mac string required
Thông tin chứng thực: mac = HMAC(hmac_algorihtm, mac key, hmacinput), chi tiết như bên dưới:
- hmac_algorihtm: là phương thức bảo mật được Merchant đăng ký với Zalopay, mặc định là HmacSHA256.
- mac key: được cung cấp bởi Zalopay.
- hmac_input = app_id +|
+ bank_codes +|
+ os_type +|
+ order_token.Xin vui lòng tham khảo phần truyền dữ liệu an toàn để biết thông tin chi tiết.
Request Body required
API dùng để lấy danh sách deeplink các ngân hàng được hỗ trợ
- app_id string required
Định danh cho ứng dụng (web, app, pos ...) hay dịch vụ (auto-debit, disbursement ...) của Merchant được cấp khi đăng ký tích hợp phương thức thanh toán với Zalopay.
- bank_codes string required
Danh sách mã Ngân hàng mà Doanh nghiệp cần lấy thông tin deeplink, được phân tách bởi ký tự "," và không có khoảng trắng.
Ví dụ: BIDV,VCB. - os_type string required
Nền tảng di động. Giá trị:
ios
hoặcandroid
. - order_token string required
Giá trị
order_token
được trả về khi sử dụng API tạo đơn hàng (Create order). Giá trị này truyền vào, sẽ hỗ trợ sắp xếp Danh sách deeplink trả về theo thứ tự ưu tiên Ngân hàng hỗ trợ tự động điền thông tin thanh toán lên trước.
Chú ý: Khuyến khích truyền giá trị này vào, để nhận được thông tin các Ngân hàng hỗ trợ điền thông tin thanh toán. - mac string required
Thông tin chứng thực: mac = HMAC(hmac_algorihtm, mac key, hmacinput), chi tiết như bên dưới:
- hmac_algorihtm: là phương thức bảo mật được Merchant đăng ký với Zalopay, mặc định là HmacSHA256.
- mac key: được cung cấp bởi Zalopay.
- hmac_input = app_id +|
+ bank_codes +|
+ os_type +|
+ order_token.Xin vui lòng tham khảo phần truyền dữ liệu an toàn để biết thông tin chi tiết.
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema
- return_code integer
Mã trạng thái.
Vui lòng tham khảo mã trạng thái để biết thêm chi tiết. - return_message string
Mô tả mã trạng thái.
- sub_return_code integer
Mã trạng thái chi tiết.
Vui lòng tham khảo mã trạng thái để biết thêm chi tiết. - sub_return_message string
Mô tả mã trạng thái chi tiết.
data object
Danh sách deep link các ngân hàng được hỗ trợ.
bank_code stringMã định danh Ngân hàng của hệ thống Zalopay.
short_name stringTên rút gọn Ngân hàng.
full_name stringTên đầy đủ Ngân hàng.
logo_url stringĐường dẫn chứa logo Ngân hàng.
is_auto_fill boolean-
true
: hỗ trợ điền thông tin.
-false
: không hỗ trợ điền thông tin.deep_link stringThông tin deep link của ứng dụng Ngân hàng.
- is_auto_fill = true : mở ứng dụng Ngân hàng bằng deeplink loại này, ứng dụng Ngân hàng sẽ tự động điền thông tin thanh toán để cho khách hàng xác nhận thanh toán.
- is_auto_fill = false : mở ứng dụng Ngân hàng bằng deeplink loại này, người dùng cần nhập thông tin chuyển khoản hoặc upload mã VietQR và xác nhận thanh toán.
{
"return_code": 0,
"return_message": "string",
"sub_return_code": 0,
"sub_return_message": "string",
"data": {
"bank_code": "string",
"short_name": "string",
"full_name": "string",
"logo_url": "string",
"is_auto_fill": true,
"deep_link": "string"
}
}