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" 
}'

All fields below are required. max_amount must exceed min_amount. The offer is created in active status immediately and is available for account invitations.

FieldTypeDescription
namestringDisplay name for the offer. Shown to merchants in the Capital Dashboard.
loan_typestringterm or revolving. See Loan offer for behavioral differences.
min_amountintegerMinimum principal a merchant can request, in centavos.
max_amountintegerMaximum principal a merchant can request, in centavos. Must exceed min_amount.
amount_incrementintegerStep size for principal selection, in centavos (e.g., 1000000 = PHP 10,000 increments).
interest_feeintegerInterest charged on the loan. Interpreted as basis points when interest_fee_type is bps.
interest_fee_typestringbps (basis points, e.g. 500 = 5%) or fixed (fixed centavo amount).
repayment_rateintegerPercentage of daily settled proceeds collected toward repayment. Interpreted as basis points when repayment_rate_type is bps.
repayment_rate_typestringbps (basis points, e.g. 1000 = 10%) or fixed (fixed centavo amount per cycle).
min_termintegerMinimum loan term length.
min_term_typestringUnit for min_term: week or month.
max_termintegerMaximum loan term length.
max_term_typestringUnit for max_term: week or month.