Loan offer
The offer object
The canonical offer resource. Offers are product templates that define lending parameters; they are not targeted at individual merchants until you invite specific accounts. Fields below are the primary ones; consult the API Reference for every field and its constraints.
{
"id": "offer_01HX0000000000000000000000",
"name": "Flexible Financing",
"loan_type": "term",
"status": "active",
"currency": "PHP",
"min_amount": 10000000,
"max_amount": 50000000,
"amount_increment": 1000000,
"interest_fee": 500,
"interest_fee_type": "bps",
"processing_fee": 300,
"processing_fee_type": "bps",
"repayment_rate": 1000,
"repayment_rate_type": "bps",
"min_term": 1,
"min_term_type": "month",
"max_term": 12,
"max_term_type": "month",
"daily_cap_enabled": false
}All amounts are integers in centavos. Fee and rate amounts are in basis points when their corresponding *_type is bps (e.g. 1000 bps = 10%), or a fixed centavo amount when fixed. loan_type is term or revolving. status is active, inactive, or deleted. *_term_type is week or month. term_increment and term_increment_type are included only when set.
processing_fee and processing_fee_type are optional fields set by the lender. When the fee is non-zero, it is withheld from each disbursement so the merchant receives only the net amount. See Create a loan offer for the full list of accepted values and validation rules.
Differences between term and revolving loan types:
| Behavior | Term | Revolving |
|---|---|---|
| Interest calculation | Pre-calculated at loan creation; fixed for the life of the loan | Starts at zero; accrues daily on outstanding principal during repayment |
| Loan creation on approval | A Loan is auto-created and disbursed immediately on application approval | Only a Contract is created on approval; the merchant draws individual loans separately |
| Contract completion | Contract moves to completed when the single loan is fully repaid | Contract stays active after a loan is repaid; further draws remain available |
Updated about 1 month ago
