LElead
User Credit Balance

Create a Credit Balance

Changed on

Create a User Credit Balance under an existing User Account. user_account_id comes from the URL path, not the request body. New User Credit Balances have status: active.

post/v2/user_accounts/{user_account_id}/user_credit_balances

Request

  • Base URL
    https://api.sandbox.lead.bank
  • URL
    https://api.sandbox.lead.bank/v2/user_accounts/{user_account_id}/user_credit_balances
  • Auth
    HTTP bearer

Path parameters

user_account_idstring required

The parent User Account's ID

Headers

Idempotency-Keystring required

Idempotency key

Request body

namestring required
currency_code'USD' required

A three-letter currency code as defined in ISO 4217.

autopay_method'ach' | 'debit_card' | 'wire' | 'virtual_wallet' | 'credit_card' | 'none' required
metadataMetadata

A set of key-value pairs that can be used to store additional information related to this object.

Example request

{
  "currency_code": "USD",
  "interest": {
    "rate": "5.250000",
    "effective_rate": "5.250000",
    "effective_apr": "5.250"
  }
}

Response

Credit Balance created successfully

idstring
user_account_idstring

The parent User Account's ID.

namestring

Human-readable name.

status'active' | 'inactive' | 'closed' | 'reporting_stopped'
status_reason'active' | 'frozen' | 'dormant' | 'other' | 'entity_closed' | 'client_closed' | 'paid_off' | 'charged_off' | 'canceled' | 'receivables_sold_to_partner' | 'data_not_available'
currency_code'USD'

A three-letter currency code as defined in ISO 4217.

amountinteger

Signed, minor units.

amount_in_usdinteger

Signed, minor units, in USD.

autopay_method'ach' | 'debit_card' | 'wire' | 'virtual_wallet' | 'credit_card' | 'none'
metadataMetadata

A set of key-value pairs that can be used to store additional information related to this object.

created_atstring date-time
updated_atstring date-time
closed_atstring date-time nullable

Example response

{
  "name": "Personal Loan - Jane Smith",
  "currency_code": "USD",
  "interest": {
    "rate": "5.250000",
    "effective_rate": "5.250000",
    "effective_apr": "5.250"
  }
}

Changes