Create a loan offer
Use this endpoint to define the lending parameters for a new offer — amount range, interest, repayment rate, and term length. For a full overview of the offer object and its lifecycle, see Loan Offers.
curl -XPOST https://api.paymongo.com/v1/capitals/lenders/offers -H "Content-Type: application/json" -d \
'{
"name": "SME Working Capital Q2",
"loan_type": "term",
"currency": "PHP",
"min_amount": 10000000,
"max_amount": 50000000,
"amount_increment": 1000000,
"interest_fee": 500,
"interest_fee_type": "bps",
"repayment_rate": 1000,
"repayment_rate_type": "bps",
"min_term": 1,
"min_term_type": "month",
"max_term": 12,
"max_term_type": "month",
"processing_fee": 300,
"processing_fee_type": "bps"
}'max_amount must be greater than or equal to min_amount, and max_term must cover at least min_term. The offer is created in active status immediately and is available for account invitations.
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name for the offer. Shown to merchants in the Capital Dashboard. |
loan_type | string | Yes | term or revolving. See Loan offer for behavioral differences. |
currency | string | Yes | Must be PHP. |
min_amount | integer | Yes | Minimum principal a merchant can request, in centavos. Must be greater than 0. |
max_amount | integer | Yes | Maximum principal a merchant can request, in centavos. Must be greater than or equal to min_amount. |
amount_increment | integer | No | Step size for principal selection, in centavos (e.g., 1000000 = PHP 10,000 increments). Must be 0 or greater. |
interest_fee | integer | No | Interest charged on the loan. Interpreted as basis points when interest_fee_type is bps. |
interest_fee_type | string | Yes | bps (basis points, e.g. 500 = 5%) or fixed (fixed centavo amount). |
repayment_rate | integer | Yes | Percentage of daily settled proceeds collected toward repayment. Must be between 1 and 9999. Interpreted as basis points when repayment_rate_type is bps. |
repayment_rate_type | string | Yes | bps (basis points, e.g. 1000 = 10%) or fixed (fixed centavo amount per cycle). |
min_term | integer | Yes | Minimum loan term length. Must be greater than 0. |
min_term_type | string | Yes | Unit for min_term: week or month. |
max_term | integer | Yes | Maximum loan term length. Must be greater than 0. |
max_term_type | string | Yes | Unit for max_term: week or month. |
term_increment | integer | No | Step size for term selection, in term_increment_type units. |
term_increment_type | string | No | Unit for term_increment: week or month. |
daily_cap_enabled | boolean | No | When true, each daily repayment is capped at the loan's daily cap — (principal + interest + DST) ÷ term days — so a single high-sales day cannot trigger an outsized repayment. Defaults to false. |
processing_fee | integer | No | Fee withheld from the disbursement amount. Interpreted as basis points when processing_fee_type is bps, or a fixed centavo amount when fixed. Defaults to 0 when omitted. |
processing_fee_type | string | No | bps or fixed. Required when processing_fee is non-zero. Defaults to fixed when omitted. |
Processing fee
The processing fee is withheld from each disbursement, so the merchant receives principal − processing fee. It is charged once per loan:
bps:principal × processing_fee / 10000, rounded down to the centavo. It is not prorated over the term.fixed: the flatprocessing_feeamount, charged on every loan — including each withdrawal under a revolving contract.
The fee stays in your lender wallet; only the net amount is transferred to the merchant.
When a merchant submits an application, the offer's current processing_fee and processing_fee_type are copied onto the application and later onto the contract. Changing the fee on an offer with PUT /v1/capitals/lenders/offers/{offer_id} only affects applications submitted after the change. On PUT, omitted fee fields keep their current values.
Validation
Invalid values return 422 with code invalid_request_body:
| Condition | detail |
|---|---|
processing_fee is non-zero and processing_fee_type is missing | processing_fee_type is required when processing_fee is set |
processing_fee_type is not bps or fixed | processing_fee_type must be bps or fixed |
processing_fee is negative, or 10000 or more when processing_fee_type is bps | processing_fee must be at least 0, and below 10000 when processing_fee_type is bps |
A non-zero fixed fee is not less than min_amount | fixed processing_fee must be less than min_amount |
| The computed fee is not less than the loan principal | processing fee must be less than the principal amount |
The last check runs when a loan is created: at approval for term loans, and at each withdrawal for revolving contracts.
Offers created before processing fees were introduced have processing_fee: 0 and processing_fee_type: "fixed".
Updated about 1 month ago
