Skip to main content

Fundiin Merchant BNPL API Overview

Fundiin provides merchant-facing APIs for BNPL checkout and payment operations. You can use the POST method to send HTTPS requests and receive responses accordingly.

Request structure​


Fundiin API request structure

Request URL​

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

  • host
EnvironmentHost
Sandboxgateway-sandbox.fundiin.vn
Productiongateway.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.

AttributeRequiredDescription
Content-TypeContent-Type: application/json; charset=UTF-8
Request-TimeTime at which request is being sent.
Format: YYYY-MM-DD hh:mm:ss
Client-IdA unique ID that is assigned by Fundiin to identify a Partner.
SignatureChecksum string created using HMAC Signature method.
Idempotency-KeyA 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.

Contents