---
title: "Create Loan Payment"
method: POST
path: "/1.0/createLoanPayment"
tags: ["Loan"]
---

# Create Loan Payment

`POST /1.0/createLoanPayment`

## Request

- Base URL: `lending-{corename}.{env}.gpsrv.com/lending/` (relative, and the document’s source URL is not known)
- URL: `lending-{corename}.{env}.gpsrv.com/lending/1.0/createLoanPayment`
- Auth: none declared

Use the Create Loan Payment endpoint when a customer requests to make a payment on a loan. The endpoint supports two types of payments today - payments from a primary account where Galileo orchestrates debiting the DDA and paying the loan, or payments from an 'external' account where the program manager accepts the funds and Galileo only manifests the loan payment.

 For optional parameters, do not pass an empty string or null value.

## Request body `application/x-www-form-urlencoded`

- object
  - `apiLogin` string, required: Provider's web service username, as provided by Galileo for the requesting IP address. Pattern: Max 50 characters Example: `"AbC123-9999"`
  - `apiTransKey` string, required: Web service password, as provided by Galileo for the requesting IP address. Pattern: Max 15 characters Example: `"4sb62fh6w4h7w34g"`
  - `providerId` integer, required: Galileo-issued unique provider identifier. Pattern: Max 10 digits Example: `9999`
  - `transactionId` string, required: A provider-generated ID that is unique to each API call. A UUID is preferred. Do not reuse this identifier for multiple API calls. Pattern: Max 60 characters Example: `"984513-395483653-4483483478"`
  - `providerTransactionId` string: An optional provider-generated ID for the API request. Pattern: Max 60 characters Example: `"47823438032233777"`
  - `providerTimestamp` string: An optional provider-generated timestamp for the API request. Pattern: Max 60 characters Example: `"2017-05-01 13:01:01"`
  - `paymentAmount` number, required: The amount of payment to be applied to the loan.
  - `paymentSource` 'USRP' | 'SYSP' | 'CRDP' | 'CSRP' | 'IVRP' | 'DFRL' | 'DWRO' | 'PCRP' | 'MCRP' | 'RCRP' | 'ADLP', required: Code indicating the source of this payment, as passed in the Create Loan Payment `paymentSource` field. Possible values: `USRP`, `SYSP`, `CRDP`, `CSRP`,`IVRP`,`DFRL`,`DWRO`,`PCRP`,`MCRP`,`RCRP`.
  - `loanId` string, required: Unique identifier for the loan. Pattern: Max 30 characters Example: `"450825953"`.
  - `subProductId` string, required: Identifier for the loan subproduct. Pattern: Max 15 characters. Example: `"442824720"`.

## Response `200`

Success

- object
  - `status_code` integer, nullable, required: The response status code. May return a string for some statuses.
  - `status` string, nullable, required: The condition of a process or response
  - `processing_time` number, float, nullable, required: The time elapsed in processing the transaction
  - `echo` object, nullable, required: A structure that contains transaction ID information
    - `transaction_id` string, nullable, required: An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required: Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required: Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required: A system generated timestamp
  - `rtoken` string, nullable, required: A Galileo-generated ID used for tracking
  - `errors` string[]: A list of errors generated while the request was processed
  - `response_data` object, nullable, required: A structure for the response data. It can be empty but usually will contain information.
    - `amount` number, required: The total amount of the payment transaction.
    - `current_installment_balance` number, required: Total amount remaining on the current loan installment. If the loan is paid off and the loan status is `Completed`, this amount is $0.00.
    - `current_installment_due_date` string, date, required: Date that the payment for the current loan installment is due.
    - `principle_balance` number, required: Current principal balance remaining on the loan.
    - `loan_status` string: Status of the loan.
    - `payoff_amount` number, required: The total amount needed to pay off the remaining principal, accrued interest, and outstanding fees of a loan
    - `per_diem_interest_amount` number, required: Daily interest charged on the loan. This amount will update as installments are paid.
    - `loan_payment_status` string: Overall status of payments made on the loan. See the list of values in the <a href="doc:reports-for-installment-loans#reports-for-installment-loans#loan-payment-status-and-loan-status-table" target="_blank">Loan Payment Status and Loan Status table</a> in the *Reports for Installment Loans* guide.
    - `initial_projected_maturity_date` string, date, required: Projected date when the loan will be paid off. This date is calculated only when a loan is simulated or created and cannot be sent again.
    - `dda_new_balance` number: Remaining account balance, if the payment on the loan was made from an account within the Galileo system.
    - `loan_payment_number` string: Galileo-generated unique identifier for the payment on the loan

---

[API](https://skmtc.dev/galileo-ft/apis/loan-api.md) - [All operations](https://skmtc.dev/galileo-ft/apis/loan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/loan-api/revisions/64783a0f7d15?raw)