Loan Details Changed Event


Event that is fired to relay changes to a loan's state.

Headers:

  • Ce-Type - LoanDetailsChangedEvent
  • Ce-Source - breadpayments.webhooks.servicing
{
  "identity": {
    "tenantID": "dc0dc633-1760-4d43-ba1d-da94ed701f06",
    "buyerID": "dc0dc633-1760-4d43-ba1d-da94ed701f06",
    "merchantID": "dc0dc633-1760-4d43-ba1d-da94ed701f06",
    "partnerID": "dc0dc633-1760-4d43-ba1d-da94ed701f06",
    "programID": "dc0dc633-1760-4d43-ba1d-da94ed701f06"
  },
  "timestamp": "2020-12-31T15:10:55Z",
  "loanID": "dc0dc633-1760-4d43-ba1d-da94ed701f06",
  "loanNumber": "string",
  "productType": "UNKNOWN",
  "paymentProductID": "dc0dc633-1760-4d43-ba1d-da94ed701f06",
  "loanStatus": "UNKNOWN_STATUS",
  "loanSubStatus": "UNKNOWN_SUB_STATUS",
  "disputeStatus": true,
  "balance": {
    "currency": "USD",
    "value": 50000
  },
  "firstPaymentDue": "2020-12-31",
  "pastDue": true,
  "chargebackAmount": {
    "currency": "USD",
    "value": 50000
  },
  "paymentAmount": {
    "currency": "USD",
    "value": 50000
  },
  "loanStartDate": "2020-12-31",
  "loanOriginationDate": "2020-12-31",
  "loanEndDate": "2020-12-31",
  "nextDueDate": "2020-12-31",
  "autopayStatus": true,
  "autopayPaymentMethodID": "dc0dc633-1760-4d43-ba1d-da94ed701f06",
  "interestRate": 0,
  "loanInterval": "BIWEEKLY",
  "loanLength": 12
}

Properties

NameTypeRequiredRestrictionsDescription
identityobjecttruenoneThe claims that determines the access level of the caller.
➥ tenantIDstring(uuid)truenoneAn UUID that represents a tenant.
➥ buyerIDstring(uuid)¦nullfalsenoneAn UUID that represents a buyer.
➥ merchantIDstring(uuid)¦nullfalsenoneAn UUID that represents a merchant.
➥ partnerIDstring(uuid)¦nullfalsenoneAn UUID that represents a partner.
➥ programIDstring(uuid)¦nullfalsenoneAn UUID that represents a program.
timestampstring(date-time)truenoneThe timestamp value formatted per RFC3339. This does not allow nulls.
loanIDstring(uuid)truenoneA universally unique identifier (Version 4) as defined in RFC4122. This does not allow nulls.
loanNumberstringfalsenoneA human-friendly unique ID for a payment agreement.
productTypestringfalsenoneThe type of payment product the loan is classified under.
paymentProductIDstring(uuid)falsenoneA universally unique identifier (Version 4) as defined in RFC4122. This does not allow nulls.
loanStatusstringfalsenoneThe status of a payment agreement.
loanSubStatusstringfalsenoneThe substatus of a payment agreement.
disputeStatusbooleanfalsenoneBoolean that represents whether a loan has a dispute.
balanceobjectfalsenoneRepresents a monetary amount in the specified currency
➥ currencystringtruenoneThe three letter currency code as defined in ISO 4217.
➥ valueinteger(int64)truenoneMonetary value as an integral number of the currency fractional unit e.g for USD: cents
firstPaymentDuestring(date)¦nullfalsenoneThe date value formatted per RFC3339. This allows nulls.
pastDuebooleanfalsenoneBoolean that indicates whether the loan has passed its due date for the latest installment.
chargebackAmountobjectfalsenoneRepresents a monetary amount in the specified currency
➥ currencystringtruenoneThe three letter currency code as defined in ISO 4217.
➥ valueinteger(int64)truenoneMonetary value as an integral number of the currency fractional unit e.g for USD: cents
paymentAmountobjectfalsenoneRepresents a monetary amount in the specified currency
➥ currencystringtruenoneThe three letter currency code as defined in ISO 4217.
➥ valueinteger(int64)truenoneMonetary value as an integral number of the currency fractional unit e.g for USD: cents
loanStartDatestring(date)¦nullfalsenoneThe date value formatted per RFC3339. This allows nulls.
loanOriginationDatestring(date)¦nullfalsenoneThe date value formatted per RFC3339. This allows nulls.
loanEndDatestring(date)¦nullfalsenoneThe date value formatted per RFC3339. This allows nulls.
nextDueDatestring(date)¦nullfalsenoneThe date value formatted per RFC3339. This allows nulls.
autopayStatusbooleanfalsenoneBoolean representing whether the loan is enrolled in autopay.
autopayPaymentMethodIDstring(uuid)¦nullfalsenoneA universally unique identifier (Version 4) as defined in RFC4122. This allows nulls.
interestRatenumber(double)falsenoneNumber indicating the current interest rate for the loan.
loanIntervalstringfalsenoneThe payment interval for the term.
loanLengthinteger(int64)falsenoneLength of the term.

Enumerated Values

Value
UNKNOWN
INSTALLMENTS
SPLITPAY
DEBT_CONSOLIDATION
PERSONAL_LOAN
UNKNOWN_STATUS
OFFERED
ACCEPTED
EXPIRED
REVIEW
OUTSTANDING
PAID
CHARGED_OFF
CANCELLED
CLOSED
UNKNOWN_SUB_STATUS
CURRENT
DELINQUENT_PAST_DUE
PENDING
FULFILLED
CHARGED_OFF_PAID
PAYMENTS_FROZEN
GRACE_PERIOD
PRE_GRACE_PERIOD
NONE
BIWEEKLY
MONTHLY