Tổng quan
Fundiin cung cấp API đễ hỗ trợ tích hợp cho các chức năng về thanh toán, sử dụng method POST
cho các request HTTPS
Request structure
Request URL
The request URL là https://{host}/{endpoint}
, trong đó:
host
Môi trường | Host |
---|---|
Sandbox | |
Production |
-
endpoint
là đường dẫn tới các api được cung cấp
Request method
Phương thức POST
được sử dụng để gửi yêu cầu HTTP.
Request header
The request header bao gồm các trường sau.
Thuộc tính | Bắt buộc | Mô tả |
---|---|---|
Content-Type | Content-Type: application/json; charset=UTF-8 | |
Request-Time | Thời gian khi yêu cầu được gửi. Định dạng: YYYY-MM-DD hh:mm:ss | |
Client-Id | ID duy nhất được cung cấp bởi Fundiin để xác định Đối tác. | |
Signature | Chuỗi checksum được tạo bằng phương thức HMAC Signature method. | |
Idempotency-Key | Một định danh duy nhất cho tin nhắn với tối đa 64 ký tự (chúng tôi đề xuất sử dụng UUID). |
Đảm bảo mã hóa các trường header HTTP không phân biệt chữ hoa/chữ thường.
Signature
HMAC Signature để xác nhận thông tin. Giao dịch an toàn với định dạng HMAC SHA-256
:
HMAC_SHA256(<Request-Body>, secretKey)
-
Client-Id
: ID duy nhất được cung cấp bởi Fundiin để xác định Đối tác. -
Request-Body
: The body of the request. -
secretKey
: Key được cung cấp bởi Fundiin trong quá trình đăng ký
Request body
The request body dưới định dạng JSON. Data sẽ thay đổi tùy thuộc vào yêu cầu. Để biết thêm thông tin, hãy xem cụ thể về các API