API Danh sách bankCode

a. Tổng quan

- Phương thức gửi nhận: POST JSON

- HTTP Request: POST <BASE_URL> /get-list-banks

b. Data Request (Thông tin gửi sang Alepay)

Tên trường

Định dạng

Bắt buộc

Mặc định

Mô tả

tokenKey

String

T

  

Mã token key do alepay cung cấp khi đăng ký tài khoản trên alepay

signature

String

T

  

Chữ ký để kiểm tra thông tin. Xem hướng dẫn tạo Signature.

 

c. Data Response (Thông tin nhận về từ Alepay)

Tên trường

Định dạng

Mô tả

code

String

Mã lỗi

message

String

Mô tả lỗi

data

Array

Danh sách phương thức thanh toán

Tham số data là một mảng danh sách các phương thức thanh toán mà ngân hàng đó hỗ trợ và mã các ngân hàng thanh toán tương ứng với phương thức thanh toán đó, các trường được mô tả như sau:

Tên trường

Định dạng

Mô tả

bankCode

String

Mã ngân hàng trả góp

bankFullName

String

Tên ngân hàng cho phép thanh toán

tradeName

String

Tên thương mại của ngân hàng cho phép thanh toán

urlBankLogo

String

Logo của ngân hàng cho phép thanh toán nội địa

bankId

Long

ID của ngân hàng thanh toán nội địa

methodCode

String

Phương thức thanh toán

  • ATM_ON: thanh toán bằng thẻ ATM

  • IB_ON: thanh toán bằng tài khoản IB

  • QRCODE: thanh toán bằng cách quét mã QRCODE (tạm đóng)

  • VIETQR: thanh toán bằng cách quét mã QRCODE napas247 (ví điện tử)

  • BANK_TRANSFER_ONLINE: thanh toán bằng hình thức chuyển khoản tự động thành công (tạm đóng)

  • VA: Thanh toán quét mã VietQr (QRcode Napas247) | chuyển khoản 24/7

 

d. Demo API

- Data Request:

  {
      "signature": "0a8763c7327d1520bedb5f2da260de0335e7d6f399a6190b117bb5f6daaca4c5",
      "tokenKey": "SI85PMt00k9SfmIbupQinvHVPCHYUd"
  }

- Data Response:

  {
      "code": "000",
      "message": "Thành công",
      "data": [
          {
              "methodCode": "ATM_ON",
              "bankFullName": "NH TMCP Xuất Nhập Khẩu Việt Nam",
              "tradeName": "Eximbank",
              "bankCode": "EXIMBANK",
              "urlBankLogo": "/avatar/2016/12/19/-eximbank.png",
              "bankId": 91
          },
          {
              "methodCode": "IB_ON",
              "bankFullName": "NH TMCP Xuất Nhập Khẩu Việt Nam",
              "tradeName": "Eximbank",
              "bankCode": "EXIMBANK",
              "urlBankLogo": "/avatar/2016/12/19/-eximbank.png",
              "bankId": 91
          },
          {
              "methodCode": "VA",
              "bankFullName": null,
              "tradeName": null,
              "bankCode": null,
              "urlBankLogo": null,
              "bankId": 0
          },
          {
              "methodCode": "VIETQR",
              "bankFullName": "Ví Điện Tử MoMo",
              "tradeName": "Ví Điện Tử Momo",
              "bankCode": "MOMO",
              "urlBankLogo": "/bank_logo/2021/9/24/163247693408720201011055543momo_logo.png",
              "bankId": 137
          }
      ]
  }