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=submitted
curl 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

FieldDescription
first_nameOwner's first name
last_nameOwner's last name
phone_numberOwner's phone number
email_addressOwner's email address

Business fields

FieldDescription
legal_nameRegistered legal name of the business
addressBusiness address object: line1, line2, city, state, postal_code, country
business_categoryMCC code of the business
psic_codePSIC code derived from the MCC; empty when the MCC has no PSIC mapping
psic_descriptionHuman-readable PSIC description; empty when unmapped
business_sizeSize of the business (for example less_than_10)
business_ageAge 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_information is 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, and outstanding_dst_amount set 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.


Did this page help you?