WorldFirst DocsWorldFirst Docs

Apply for loans from WorldFirst

WorldFirst provides a series of APIs that can help Partners to achieve a variety of financing fund management capabilities.

The following table summarizes the financing management functions and the corresponding APIs specifically supported by WorldFirst.

Supported functions

Definition

APIs to be integrated

Credit grant

Query the available loan quota and request a credit grant.

Loan management

Apply for a loan and query the loan order's information.

Repayment management

Query the repayment information.

Before you begin

  • Make sure you have a valid WorldFirst HK account with a level above L3.
  • Make sure you have applied for VC invoice financing products in the WorldFirst portal.

Develop and integrate

We recommend that you follow the steps below when developing and integrating your product. Repeat the following steps if you were to make multiple credit granting and loan application.

(Optional) Step 1: Query the available loan quota

Before requesting a credit grant, call the queryCreditQuota API to query your financing quota information. Once the query is successful, WorldFirst will return your cap limit amount (the maximum credit amount that you can be granted from WorldFirst), the total granted amount, and other information.

Note:

  • This queryCreditQuota API has no step dependency with other APIs and it is optional to use. However, as a best practice, we recommend that you call this API to query the current quota information before applying for the credit grant.
  • You can call this API to query information such as cap limit amount and total granted amount in any step of the integration process.
  • You can refer to the formula to calculate your available credit grant quota: Approvable credit quota ≤ capLimitTotalAmount - grantTotalAmount.

Step 2: Apply for a credit grant

When the financing limit query is completed, you can call the relevant APIs to initiate a fund credit application.

1. Call the submitAttachment API to upload the required invoice attachments. Once an attachment is successfully uploaded, WorldFirst returns the fileKey and fileName parameters, which are the inputs needed to call for subsequent API like applyCreditGrant.

Note:

The submitAttachment API can only upload a single attachment at one time. You can call this API multiple times as needed to upload other valid invoices.

2. After the attachment is uploaded, call the applyCreditGrant API to apply for a credit grant. If the request is successful, WorldFirst will return the credit grant number.

3. Call the queryCreditGrant API to query the credit application results, including the credit grant amount, annualized rate, and the due date of credit grant.

The following figure shows the integration process of initiating a credit grant application:

20250526095641.jpg

Figure 1. Workflow to apply for a credit grant

Step 3: Apply for a loan

After a credit grant is successfully applied, you can call the relevant APIs to apply for loans and query the information of loan orders.

1. With reference to the creditGrantNo parameter obtained by calling the applyCreditGrant API, call the consultLoan API to to consult the relevant loan order's details, including the total loan amount, interest rate, repayment method and other information.

2. Call the applyLoan API to apply for a loan. If the API call is successful, WorldFirst will return the loan order number.

3. Call the queryLoanList API or queryLoanDetail API where necessary to query the list of loan orders.

The following figure shows the integrated process of applying for funds:

20250527103822.jpg

Figure 2. Workflow to apply for a loan

Step 4: Query the repayment information

After the loan is utilized and the repayment has been made, you can call the relevant APIs to query the repayment records.

1. Call the queryRepaymentList API to query the repayment records in a given timeframe, status or repayment entity. WorldFirst will return the repayment order number, repayment type, total repayment amount, repayment penalty interest, and other information.

2. Call the queryRepaymentDetail API to query the repayment details of a particular repayment made, based on the repayOrderNo parameter obtained from calling the queryRepaymentList API.

The following figure shows the integration process for querying repayment information:

20250527102613.jpg

Figure 3. Workflow to query the repayment information

Troubleshooting

If an error occurs when you call the API, Do NOT attempt to retry. Kindly record the traceId and contact WorldFirst Technical Support.