Add New Parent-Child Payment

This request allows you to process a payment for loans with a parent-to-child relationship.

   Click here to learn more about this request


Loans can be linked together in a parent-to-child relationship. This is useful when one borrower has multiple loans and would like their payments to apply to each loan. Here's what you need to know about this request:

  • You will need to link the loans before you can begin processing payments.
  • The parent loan must be the loan used in the endpoint. Parent-child payments can only be made through the parent loan's account.
  • In case you're unfamiliar with how payments work within LoanPro, the software handles two types of payments: logged and logged and processed. Here's a breakdown of each category:
    • Logged payments are those that are processed externally from LoanPro. In other words, a transfer of money was made, but LoanPro was not directly involved in the transfer. Cash payments, check payments, and payments processed outside of LoanPro fall into this category.
    • Logged and processed payments are those that are processed via LoanPro. In other words, a transfer of money was made, and LoanPro was directly involved in the transfer. Payments made via a bank account or a credit card fall into this category.

For an example of how parent-child payments work within the UI, take a look at our Parent-Child Loan Linking article.

Database

For information on parent-child payment database tables, see the following articles:

// This is a payment made on a parent loan that has two child loans. The child loans are set up to receive 75% and 25% of the total payment on the parent loan.

{
    "Payments": {
        "results": [
            {
                "selectedProcessor": 0,
                "paymentMethodId": 3,
                "early": 0,
                "echeckAuthType": "payment.echeckauth.WEB",
                "amount": "100",
                "date": "2022-04-20",
                "info": "04/20/2022 Credit/Debit Card",
                "paymentTypeId": 1,
                "active": 1,
                "resetPastDue": 0,
                "payoffPayment": false,
                "quickPay": "",
                "CustomFieldValues": {
                    "results": [
                        {
                            "customFieldId": 8,
                            "customFieldValue": "0"
                        },
                        {
                            "customFieldId": 9,
                            "customFieldValue": "1"
                        }
                    ]
                },
                "_saveProfile": 0,
                "extra": "payment.extra.tx.principal",
                "_$childrenLoans": [ //This array is NOT required for your payload. 
                    {
                        "id": "3578",
                        "displayId": "3578",
                        "daysPastDue": "0",
                        "collateralInfo": null,
                        "loanSetupInterestRate": 5,
                        "amountDue": "0.00",
                        "percentage": 0.75,
                        "payoff": "4800.66",
                        "principalBalance": "4800.00",
                        "transactionAmount": "75.00",
                        "relationshipId": 36,
                        "__id": "3578",
                        "__update": true
                    },
                    {
                        "id": "3579",
                        "displayId": "3579",
                        "daysPastDue": "0",
                        "collateralInfo": null,
                        "loanSetupInterestRate": 4.5,
                        "amountDue": "0.00",
                        "percentage": 0.25,
                        "payoff": "3000.37",
                        "principalBalance": "3000.00",
                        "transactionAmount": "25.00",
                        "relationshipId": 37,
                        "__id": "3579",
                        "__update": true
                    }
                ],
                "loansLinkFeeOptins": "loan.splitFee.option.3",
                "__processorName": "{\"id\":\"98\",\"key\":\"anet\",\"name\":\"Anet Default processor\",\"default\":\"1\"}",
                "paymentAccountId": 289,
                "chargeFeeType": "loan.cardfee.types.1",
                "chargeFeeAmount": 5,
                "chargeFeePercentage": 5,
                "payoffFlag": 0,
                "__splitPaymentInLoans": "[]",
                "TransactionChilds": {
                    "results": [
                        {
                            "loanChildId": 36,
                            "percentage": 0.75,
                            "childEntityId": "",
                            "entityId": "",
                            "entityType": "Entity.Payment",
                            "amount": "75.00"
                        },
                        {
                            "loanChildId": 37,
                            "percentage": 0.25,
                            "childEntityId": "",
                            "entityId": "",
                            "entityType": "Entity.Payment",
                            "amount": "25.00"
                        }
                    ]
                }
            }
        ]
    }
}
// This is a payment made on a parent loan that has one child loan. The child loan is set up to receive 100% of the total payment on the parent loan.

{
    "Payments": {
        "results": [
            {
                "selectedProcessor": "",
                "paymentMethodId": 1,
                "early": 0,
                "echeckAuthType": "payment.echeckauth.WEB",
                "amount": "250",
                "date": "2022-04-20",
                "info": "04/20/2022 Cash",
                "paymentTypeId": 1,
                "active": 1,
                "resetPastDue": 0,
                "payoffPayment": false,
                "quickPay": "",
                "CustomFieldValues": {
                    "results": [
                        {
                            "customFieldId": 8,
                            "customFieldValue": "0"
                        },
                        {
                            "customFieldId": 9,
                            "customFieldValue": "1"
                        }
                    ]
                },
                "_saveProfile": 0,
                "extra": "payment.extra.periods.principalonly",
                "cardFeeType": "loan.cardfee.types.1",
                "cardFeeAmount": 25,
                "cardFeePercent": 0,
                "_$childrenLoans": [ //This array is NOT required for your payload. 
                    {
                        "id": "9709",
                        "displayId": "9119",
                        "daysPastDue": "0",
                        "collateralInfo": "2017 Honda Civic",
                        "loanSetupInterestRate": 5,
                        "amountDue": "0.00",
                        "percentage": 1,
                        "payoff": "9504.73",
                        "principalBalance": "9435.29",
                        "transactionAmount": "250.00",
                        "relationshipId": 18,
                        "__id": "9709",
                        "__update": true
                    }
                ],
                "__logOnly": true,
                "payoffFlag": 0,
                "__splitPaymentInLoans": "[]",
                "TransactionChilds": {
                    "results": [
                        {
                            "loanChildId": 18,
                            "percentage": 1,
                            "childEntityId": "",
                            "entityId": "",
                            "entityType": "Entity.Payment",
                            "amount": "250.00"
                        }
                    ]
                }
            }
        ]
    }
}

🚧

Try It Instructions

Our requests often provide sample payload information so that you can receive a 200 response from simply hitting the Try It button. This request is a bit different.

We have included sample values for this request, but they won't result in a 200 response for you—they're purely for show. But, if you’d like to see a sample of a 200 response, click the response examples located under the Try It button.

To receive a 200 response from the Try It button, you will have to try this request with your own tenant credentials. If you plan on doing so, make sure to change the headers to match your own authentication information.

Language
Authorization
Click Try It! to start a request and see the response here!