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.

FieldTypeRequiredDescription
namestringYesDisplay name for the offer. Shown to merchants in the Capital Dashboard.
loan_typestringYesterm or revolving. See Loan offer for behavioral differences.
currencystringYesMust be PHP.
min_amountintegerYesMinimum principal a merchant can request, in centavos. Must be greater than 0.
max_amountintegerYesMaximum principal a merchant can request, in centavos. Must be greater than or equal to min_amount.
amount_incrementintegerNoStep size for principal selection, in centavos (e.g., 1000000 = PHP 10,000 increments). Must be 0 or greater.
interest_feeintegerNoInterest charged on the loan. Interpreted as basis points when interest_fee_type is bps.
interest_fee_typestringYesbps (basis points, e.g. 500 = 5%) or fixed (fixed centavo amount).
repayment_rateintegerYesPercentage 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_typestringYesbps (basis points, e.g. 1000 = 10%) or fixed (fixed centavo amount per cycle).
min_termintegerYesMinimum loan term length. Must be greater than 0.
min_term_typestringYesUnit for min_term: week or month.
max_termintegerYesMaximum loan term length. Must be greater than 0.
max_term_typestringYesUnit for max_term: week or month.
term_incrementintegerNoStep size for term selection, in term_increment_type units.
term_increment_typestringNoUnit for term_increment: week or month.
daily_cap_enabledbooleanNoWhen 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_feeintegerNoFee 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_typestringNobps 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 flat processing_fee amount, 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:

Conditiondetail
processing_fee is non-zero and processing_fee_type is missingprocessing_fee_type is required when processing_fee is set
processing_fee_type is not bps or fixedprocessing_fee_type must be bps or fixed
processing_fee is negative, or 10000 or more when processing_fee_type is bpsprocessing_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_amountfixed processing_fee must be less than min_amount
The computed fee is not less than the loan principalprocessing 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".



Did this page help you?