Tổng quan

Các thông tin được KLB Pay cung cấp

Tên trường	Ý nghĩa
Host	Máy chủ KLB Pay
clientId	Mã định danh
encryptKey	Key dùng để mã hóa
secretKey	Key dùng ký xác thực

Truy cập KLB Pay Portal để lấy các thông tin tích hợp.

Cấu trúc request

Trong đó:

• Host:

Môi trường	Host
Sandbox	https://api-staging.kienlongbank.co/pay
Production	https://api.kienlongbank.co/pay

• Path: Path tương ứng với từng API.

• Method: POST

• Headers:

Key	Type	Require	Value
x-api-client	String	✓	Mã định danh
x-api-time	Long	✓	Timestamp tại thời điểm giao dịch, duy nhất cho từng client
x-api-validate	String	✓	Chữ ký xác thực sử dụng kỹ thuật băm HMAC-SHA256.

x-api-validate: HMAC-SHA256({clientId}|{String.valueOf(timestamp)}|{encryptedData}, secretKey)

• Body:

Key	Type	Require	Value
data	String	✓	Payload dạng string JSON được mã hóa đối xứng bằng giải thuật AES. encryptedData = AES(payload, encryptKey)

Request mẫu:

    curl --request POST 'http://api-staging.kienlongbank.co/pay/api/payment/v1/create' \
    --header 'x-api-client: 28057182-3beb-4f7b-b313-f6d0781e87de' \
    --header 'x-api-validate: 63f56c5f859f15b9a4442cfa10d1509261354d670447ca4518d8cb5d70056e3d' \
    --header 'x-api-time: 1669019715524' \
    --header 'Content-Type: application/json' \
    --data-raw '{"data":"Sp956eLGvXwnbpgllC1roAtG4vVW9chLBvn7+ixH9gm0vuN5fLEoHay/L0VSDwov"}'

Cấu trúc response

• Headers: cấu trúc tương tự như Request
• Body: Payload dạng JSON được mã hóa đối xứng bằng giải thuật giải thuật AES. Cách mã hóa giống với data của Request.
• Response Status: 200 OK, request thành công

Response mẫu:

    {
        "code": 0,
        "message": "Success",
        "data": "iM63cIgTnquisKk56BVLGmXgLv/B+LjTwdIk9C4gHULjQMESveA1BJN5JnpafMht0c+fAkiZ1PdVqWZLPtFKrw=="
    }