Overview

Fundiin provides a set of Application Programming Interfaces (APIs) to enable various capabilities, such as the payment capability. You can use the POST method to send HTTPS requests and receive responses accordingly.

Request structure

Request URL

The request URL is https://{host}/{endpoint}, where:

• host

Environment	Host
Sandbox	gateway-sandbox.fundiin.vn
Production	gateway.fundiin.vn

• endpoint is the path to the interface

Request method

POST method is used to make an HTTP request.

Request header

The request header mainly contains the following fields.

Attribute	Required	Description
Content-Type		Content-Type: application/json; charset=UTF-8
Request-Time		Time at which request is being sent. Format: YYYY-MM-DD hh:mm:ss
Client-Id		A unique ID that is assigned by Fundiin to identify a Partner.
Signature		Checksum string created using HMAC Signature method.
Idempotency-Key		A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

Make sure you code for case-insensitive HTTP headers.

Signature

HMAC Signature to confirm information. Secure transaction in HMAC SHA-256 with format:

HMAC_SHA256(<Request-Body>, secretKey)

• Client-Id: A unique ID that is assigned by Fundiin to identify a Partner.

• Request-Body: The body of the request.

• secretKey: The secret key provided by Fundiin during the registration process.

Request body

The request body contains the detailed request information in JSON format. Fields enclosed in the request body vary depending on services. For more information, see the specific API specification.