Embedded Premium Finance Error Reference
The table below describes the error codes returned by the Embedded Premium Finance API. These codes help identify specific issues encountered when working with embedded premium finance features, such as invalid or missing parameter values, processing errors, or unauthorized actions.
| Error Code | Description | Status Code |
|---|---|---|
| Key_AccountNumberCannotBeEmptyOrNULL | The 'accountNumber' cannot be null or empty. Please provide a valid account number. | 400 |
| Key_DownPaymentIsRequired | A down payment is required for this endorsement. Include the down payment details in your request. | 400 |
| Key_EsignIsNotRequired | An e-signature is not required for this premium finance agreement. Remove any e-signature data from your request. | 400 |
| Key_GetErrorFromEndorsement | The endorsement update request returned an unknown error. Please try again or contact support. | 400 |
| Key_InvalidMerchant | The merchant ID provided is invalid. Verify the merchant ID and try again. | 400 |
| Key_InvalidPaymentIntent | The 'paymentIntentId' provided is invalid. Check the payment intent ID and resubmit your request. | 400 |
| Key_InvalidQuoteKey | The 'quoteKey' provided is invalid. Please provide a valid quote key. | 400 |
| Key_InvalidQuoteStatus | The quote status is invalid. Ensure the quote is in a valid state for this operation. | 400 |
| Key_MerchantCannotBeEmptyOrNULL | The 'merchantReference' cannot be null or empty. Include a valid merchant reference in your request. | 400 |
| Key_MerchantInActive | The merchant account is inactive. Contact support to reactivate your account. | 400 |
| Key_MerchantReferenceShouldUnique | The 'merchantReference' value must be unique. Use a different merchant reference and try again. | 400 |
| Key_NewPolicyNumberCannotBeEmptyOrNULL | The 'newPolicyNumber' cannot be empty or null. Provide a valid policy number. | 400 |
| Key_PaymentIntentDisabled | The specified payment intent has been disabled. Use an active payment intent to proceed. | 400 |
| Key_PaymentIntentExpired | The specified payment intent has expired. Create a new payment intent to continue. | 400 |
| Key_PaymentIntentIdCannotBeNullOrEmpty | The 'paymentIntentId' cannot be null or empty. Provide a valid payment intent ID. | 400 |
| Key_PFANotFound | The premium finance agreement was not found. Verify the agreement details and try again. | 400 |
| Key_PolicyNotFound | The 'PolicyId' was not found. Check the policy ID and resubmit your request. | 400 |
| Key_PremiumCannotBeEmptyOrNULL | The 'premium' amount cannot be empty or null. Include the premium amount in your request. | 400 |
| Key_QuoteIsAlreadyEsigned | The quote has already been e-signed. No further action is required. | 400 |
| Key_QuoteIsNotOfEndorsementType | The quote is not of endorsement type. This operation is only applicable to endorsement quotes. | 400 |
| Key_QuoteKeyCannotBeEmptyOrNULL | The 'quoteKey' cannot be empty or null. Provide a valid quote key. | 400 |
| Key_ReCaptchaTokenInvalid | The ReCAPTCHA token provided is invalid. Refresh the token and try again. | 400 |
| Key_SignedPFANotFound | The signed premium finance agreement was not found. Ensure the agreement has been signed. | 400 |
| Key_SignPFAFailed | The e-sign process failed for the premium finance agreement. Please try again or contact support. | 400 |
| Key_UnsignedPFANotFound | The unsigned premium finance agreement was not found. Verify the agreement details and try again. | 400 |