API Lấy thông tin thẻ đã liên kết

a. Tổng quan

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

- HTTP Request: POST <BASE_URL> /get-customer-info

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

Tên trường

Định dạng

Mô tả

tokenKey

String

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

customerId

String

ID của người dùng trên Merchant đã thực hiện liên kết thẻ

language

String

Ngôn ngữ hiển thị.
- vi: tiếng việt
- en: tiếng anh

signature

String

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 (được mô tả trong Phụ lục 12.a)

message

String

Mô tả lỗi

firstName

String

Họ người dùng

lastName

String

Tên người dùng

email

String

Email người dùng

phone

String

SĐT người dùng

listCardTokens

Array

Danh sách các thẻ đã được liên kết

Tên trường

Định dạng

Mô tả

token

String

Mã token thanh toán của thẻ(chỉ trả về token trạng thái Đang hoạt động)

cardNumber

String

Số thẻ (6 số đầu và 4 số cuối)
cardHolderName String Tên chủ thẻ
cardExpireMonth String

Tháng hết hạn
cardExpireYear String

Năm hết hạn (2 số cuối)
paymentMethod String Loại thẻ
bankCode String Mã ngân hàng phát hành thẻ

 

d. Demo API

- Data Request:

  {
      "tokenKey": "jWglwAv5WA5B8gguVsHxyitoPBEcco",
      "customerId":"Test",
      "language":"vi",
      "signature":"61b0fe54abdb75dfb0214553cab26c3d9ccdea490e2a4bac48f7919d87db4376"
  }

- Data Response:

  {
      "code": "000",
      "message": "Thành công",
      "firstName": "Nguyen",
      "lastName": "Van A",
      "email": "hanguyen261098@gmail.com",
      "phone": "0394028864",
      "listCardTokens": [
          {
              "token": "036903483a5c1d9c0df856982369d822",
              "cardNumber": "445653-XXXX-1096",
              "cardHolderName": "nguyen thi ha",
              "cardExpireMonth": "03",
              "cardExpireYear": "2025",
              "paymentMethod": "VISA",
              "bankCode": "SACOMBANK"
          },
          {
              "token": "2e4d208878227e93c3b660cbe9229dc1",
              "cardNumber": "445653-XXXX-1005",
              "cardHolderName": "VU THI QUY",
              "cardExpireMonth": "12",
              "cardExpireYear": "2023",
              "paymentMethod": "VISA",
              "bankCode": "SACOMBANK"
          },
          {
              "token": "6e009479f1c8f4e495213bc13d3e911a",
              "cardNumber": "445653-XXXX-1005",
              "cardHolderName": "VU THI QUY",
              "cardExpireMonth": "12",
              "cardExpireYear": "2023",
              "paymentMethod": "VISA",
              "bankCode": "SACOMBANK"
          },
          {
              "token": "920a5491291038b4801191c531447cc6",
              "cardNumber": "445653-XXXX-1005",
              "cardHolderName": "VU THI QUY",
              "cardExpireMonth": "12",
              "cardExpireYear": "2023",
              "paymentMethod": "VISA",
              "bankCode": "SACOMBANK"
          }
      ]
  }