Submitting Funding Request

INFO

This documentation is work in progress and subject to change. If you have any questions or feedback, please reach out to us via Support.

After completing the KYC onboarding process, you can then start submitting a funding request on behalf of approved borrower. Zetl will immediately return an approval or rejection decision that you can present to your customer.

In this tutorial we will be submitting an Instant Settlement request:

HTTP

POST /v1/instant-settlements HTTP/1.1
Host: api.zetl.com
Content-Type: application/json
Authorization: Bearer <your-private-key>

{
  "customer_id": "b8a1dfe0-c575-4d5c-9840-2fca96b5d96a",
  "currency": "HKD",
  "amount": 100000,
  "account_chargeback_rate": 0.03,
  "account_refund_rate": 0.03,
  "settlement_period": 7,
  "transactions": {
    "transaction_list": [
      {
        "transaction_id": "c6241b71-4340-4710-a304-0409124ff87c",
        "transaction_date": "2021-01-01",
        "transaction_currency": "HKD",
        "transaction_amount": 100000,
        "transaction_status": "success",
        "transaction_type": "sale",
        "transaction_settlement_date": "2021-01-08",
        "settlement_status": "settled"
      }
    ],
    "transaction_count": 1,
    "total_amount": 100000
  }
}

curl

curl --request POST \
  --url https://api.zetl.com/v1/instant-settlements \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <your-private-key>' \
  --data '{
  "customer_id": "b8a1dfe0-c575-4d5c-9840-2fca96b5d96a",
  "currency": "HKD",
  "amount": 100000,
  "account_chargeback_rate": 0.03,
  "account_refund_rate": 0.03,
  "settlement_period": 7,
  "transactions": {
    "transaction_list": [
      {
        "transaction_id": "c6241b71-4340-4710-a304-0409124ff87c",
        "transaction_date": "2021-01-01",
        "transaction_currency": "HKD",
        "transaction_amount": 100000,
        "transaction_status": "success",
        "transaction_type": "sale",
        "transaction_settlement_date": "2021-01-08",
        "settlement_status": "settled"
      }
    ],
    "transaction_count": 1,
    "total_amount": 100000
  }
}'

Successful API call will return the following response body in JSON format:

JSON

{
  "funding_id": "c6241b71-4340-4710-a304-0409124ff87c",
  "customer_id": "b8a1dfe0-c575-4d5c-9840-2fca96b5d96a",
  "currency": "HKD",
  "amount": 100000,
  "account_chargeback_rate": 0.03,
  "account_refund_rate": 0.03,
  "settlement_period": 7,
  "interest_rate": 0.0049,
  "transactions": {
    "transaction_list": [
      {
        "transaction_id": "c6241b71-4340-4710-a304-0409124ff87c",
        "transaction_date": "2023-11-29",
        "transaction_currency": "HKD",
        "transaction_amount": 100000,
        "transaction_status": "success",
        "transaction_type": "sale",
        "transaction_settlement_date": "2023-12-07",
        "settlement_status": "settled"
      }
    ],
    "transaction_count": 1,
    "total_amount": 100000
  },
  "status": "approved",
  "created_at": "2023-12-01T00:02:00Z",
  "updated_at": "2023-12-01T00:02:00Z"
}

INFO

Refer to Instant Settlement resource for a detailed description on each property on the request and response body.

When you submit the Instant Settlement funding request, our API will immediately return the funding offer interest rate for the full loan period. This value represents the total cost of the loan.

Auto-Accepted Offer

Some partner might skip the next Accepting a Funding Request step and found their funding offer auto-accepted depending on partnership configuration

To finalise the funding request flow, you can start Accepting a Funding Request offer.