Review loan application
Application and approval
Merchants apply from the Dashboard. Receiving an application is the signal to begin your credit review. Listing and reviewing applications:
curl https://api.paymongo.com/v1/capitals/lenders/applications?status=submittedcurl https://api.paymongo.com/v1/capitals/lenders/applications/{application_id}The detail endpoint returns the application with supporting document URLs. Application status values: submitted, under_review, approved, rejected.
Applicant information
When a merchant submits an application, PayMongo captures a snapshot of their owner and business details and attaches it to the application as applicant_information. The snapshot is frozen at submit time — it reflects exactly what the merchant confirmed during onboarding, even if their profile changes later.
applicant_information is returned at the top level of the application detail response:
{
"applicant_information": {
"owner": {
"first_name": "Juan",
"last_name": "Dela Cruz",
"phone_number": "+639171234567",
"email_address": "[email protected]"
},
"business": {
"legal_name": "Juan's Bakery Inc.",
"address": {
"line1": "123 Rizal St",
"line2": "Unit 4B",
"city": "Makati",
"state": "Metro Manila",
"postal_code": "1200",
"country": "PH"
},
"business_category": "5462",
"psic_code": "1071",
"psic_description": "Manufacture of bakery products",
"business_size": "less_than_10",
"business_age": "between_2_and_5_years"
}
}
}applicant_information is null for applications submitted before this field was introduced — no backfill is performed. The field appears only on the detail endpoint; list responses do not include it.
Owner fields
| Field | Description |
|---|---|
first_name | Owner's first name |
last_name | Owner's last name |
phone_number | Owner's phone number |
email_address | Owner's email address |
Business fields
| Field | Description |
|---|---|
legal_name | Registered legal name of the business |
address | Business address object: line1, line2, city, state, postal_code, country |
business_category | MCC code of the business |
psic_code | PSIC code derived from the MCC; empty when the MCC has no PSIC mapping |
psic_description | Human-readable PSIC description; empty when unmapped |
business_size | Size of the business (for example less_than_10) |
business_age | Age range of the business (for example between_2_and_5_years) |
Submission validation
PayMongo validates that the merchant's profile is complete when they submit an application. If required fields are blank or whitespace-only, the submission fails with 422 and one applicant_information_incomplete error per missing field. The source.pointer identifies the exact missing field:
{
"errors": [
{
"code": "applicant_information_incomplete",
"detail": "Applicant information is incomplete",
"source": { "pointer": "/applicant_information/owner/phone_number" }
}
]
}Required owner fields: first_name, last_name, phone_number, email_address. Required business fields: legal_name, address.line1, business_category, business_size, business_age. All other fields are stored as empty when not present in the merchant's profile.
If PayMongo cannot fetch the merchant's owner or business details at submit time, the submission fails with 503 and the detail "Applicant information is unavailable, please try again". This is a transient error; the merchant should retry.
These errors are returned to the merchant during the application submit flow. As a lender, you will only receive applications that have passed this validation —
applicant_informationis always populated (never absent or incomplete) on applications you review.
Approving an application
curl -XPOST https://api.paymongo.com/v1/capitals/lenders/applications/{application_id}/decide -H "Content-Type: application/json" -d \
'{
"approved_amount": 30000000,
"currency": "PHP",
"decision": "approved"
}'On approval, PayMongo:
- Creates a Contract (the loan agreement between lender and merchant).
- Creates a Loan under that contract, with
outstanding_principal_amount,outstanding_interest_amount, andoutstanding_dst_amountset from the approved terms. - Triggers disbursement of the approved amount to the merchant's PayMongo wallet via the Capital disbursement workflow.
You do not need to take action between approval and disbursement — contract creation and funding are platform-operated. Use the Capital event webhooks to trigger your internal bookkeeping.
Rejecting an application
curl -XPOST https://api.paymongo.com/v1/capitals/lenders/applications/{application_id}/decide -H "Content-Type: application/json" -d \
'{
"decision": "rejected",
"remark": "insufficient transaction history"
}'On rejection, the application moves to rejected (terminal state). The merchant is notified via Dashboard and email. No contract or loan is created. A rejected application cannot be reopened — if the merchant wishes to reapply at a later date, they must submit a new application.
Updated 18 days ago
