Xác thực và chữ ký

Đăng nhập cổng dùng đúng hai trường Fintwin cấp: company code và authorization key.

Đăng nhập

Không có tự đăng ký. Fintwin cấp company code và authorization key sandbox sau bước làm việc. Key production không gọi được từ cổng vì cổng chỉ cấu hình host sandbox.

Khi cấp key cho cổng, IP egress của portal phải nằm trong danh sách IP của key. Key chỉ gắn IP máy đối tác sẽ không đi qua được cổng.

Header khi tích hợp thật

  • Authorization: khóa API.
  • Content-Type: application/json.
  • Signature: chữ ký toàn vẹn body trên các API yêu cầu chữ ký. Khóa ký cấp cùng đợt, không nhập trên form đăng nhập.
  • Timestamp: thời điểm yêu cầu trên API liên kết và thanh toán.

Ủy quyền trích nợ

Payload nghiệp vụ được mã hóa AES-256-CBC thành trường data. Khóa dài 32 byte và vector dài 16 byte, cấp riêng, không lưu trên cổng. Trang API mô tả payload trước khi mã hóa. Khi gọi sandbox, Try hỏi key và vector, mã hóa trong trình duyệt, rồi in body { data } đã gửi.

Sau đăng nhập, Try gọi sandbox cho mọi API. Cổng gắn header Signature khi đã cấu hình khóa ký của company code. Chưa có khóa thì request đi không kèm chữ ký và sandbox trả lỗi thật.