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.

Approving an application

curl -XPOST https://api.paymongo.com/v1/capitals/lenders/applications/{application_id}/approve -H "Content-Type: application/json" -d \
'{
  "approved_amount": 30000000,
  "currency": "PHP"    
}'

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}/reject -H "Content-Type: application/json" -d \
'{
  "reason": "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.