Disburse a loan
To disburse a loan, use the Disburse loan v2 endpoint.
Your system
Sends a POST to /lending/v2/loans/:loanId/disburse. In the following example request, loanId is "2717a296-124a-47cc-b2a1-91e80dc723eb":
curl --request POST \
--url https://sandbox.pismolabs.io/lending/v2/loans/2717a296-124a-47cc-b2a1-91e80dc723eb/disburse \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"disbursement_account": {
"account_type": "INTERNAL"
}
}
'Pismo platform
Generates a Loan disbursement V2 status changed event:
{
"loan_id": "2717a296-124a-47cc-b2a1-91e80dc723eb",
"org_id": "TN-89e56522-726a-453e-ba6d-796b03245128",
"disbursement_id": "89e56522-726a-453e-ba6d-796b03245128",
"idempotency_key": "48704d83-0412-431f-816a-50ba81451148",
"currency": "USD",
"created_at": "2026-10-24T21:34:47",
"updated_at": "2026-10-24T21:34:47",
"previous_disbursement_status": "SCHEDULED",
"current_disbursement_status": "PROCESSING",
"disbursement_amount": 1234.56,
"disbursement_account": {
"account_type": "INTERNAL",
"account_id": 221123
},
"authorization_id": 1231231,
"authorization_tracking_id": "ded913af-abc9-4769-b179-068ed6181ec5",
"disbursement_date": "2026-10-24"
}The current disbursement status is stored in the loan object as disbursement_schedule. The status can be SCHEDULED or DONE. It also includes the date of the scheduled or actual disbursement.
Use the Get loan details endpoint to view information about a loan’s disbursement.
Depending on your lending rules, you can perform instant disbursement into a customer’s account, or, in the case of BNPL, a merchant’s account. Instant disbursement means the loan life cycle can begin much quicker. If your organization allows, you can disburse funds on the same day using the disbursement_date parameter.
You also have the flexibility to disburse funds to an account registered on the Pismo platform or to an external account.
- To disburse funds to an account registered on the Pismo platform, use the
INTERNALDISBURSETOparameter in the Disburse loan endpoint. - To disburse funds to an external account, use the
EXTERNALDISBURSETOparameter in the Disburse loan endpoint.
You can also deduct fees or charges from the disbursement amount. To do this, use the disbursement_schedule parameter when you simulate the loan.
This API request example includes these required fields.
| Field | Description |
|---|---|
disbursement_date | The date to disburse the loan. You can find this date in the loan simulation. |
disbursement_amount | The amount disbursed for the loan. You can find this amount in the loan simulation. |
disbursement_account | The account on the Pismo platform to which the loan funds are disbursed. |
{
"disbursement_date": "2026-06-24",
"disbursed_amount": 1000.00,
"disbursement_account": {
"type": "INTERNAL",
"account_id": 103614168
}
}After you disburse the loan, the API response includes the disbursement_id. This ID is the identifier that confirms the loan disbursement.
{
"loan_id": "5d9d9339-3b5e-4c33-b129-8155e4d4946b",
"disbursement_id": "c1eb9f28-e1c9-4705-b2b5-f986b3bc7455",
"created_at": "2026-06-27T14:19:30.194249",
"updated_at": "2026-06-27T14:21:00.318043",
"product_id": "fb525f7e-4317-45da-84d5-ccb1b0da3f14",
"disbursement_status": "PROCESSING",
"loan_amount": 1000.00,
"disbursed_amount": 1000.00,
"disbursement_account": {
"type": "INTERNAL",
"account_id": 103296044
}
}Updated about 3 hours ago