A card is an instrument for drawing on a line of credit account. Cards are represented by the Cards entity in LoanPro and the card entity in Secure Payments. Each card must be associated with an existing customer and Card Program.
Cards are associated with programs and customers while swipes are associated with cards. Each card must be associated with an existing customer and Card Program. You will find the key-value pairs for cards below.
Key-value pairs
| Value: | Definition: |
|---|---|
issuer_product_id | An ID from the issuer that represents the card product offering. |
processing_type | The default card processing type. |
date_last_updated | The card's last updated date. |
display_card_attributes | Determines whether to display the cards' expiration dates, PAN, name, and brand. |
card_color | The card's color. |
shipping_method | The card's shipping method. > This field is used when the card_type field is set to either physical or hybrid. |
card_issuer_id | The card issuer ID. |
card_currency | The card's currency. |
available_balance | The card's available credit limit. |
available_advance_balance | The amount that a borrower can use for cash advance request. |
spend_limit | The amount a borrower can spend during a determined period of time. > The spend_limit is separate from the available_balance and controls the velocity of spending with a card. |
authorization_expiration_days | The number of days after which an "Authorization Expired" type of event should be extended if the authorized amount is still greater than the sum of the cleared amount and the voided amount. |
created_date | The card's creation date time. |
spend_limit_interval | The card's spend limit interval. |
card_metadata | The card's stored metadata. > This fields needs to include the ID of the LMS Tenant that is associated with your Secure Payments account. |
card_title | The card's name. |
card_status | The card's activation status. |
card_text_color | The card's text color. |
network | The card's network. |
uuid | The card's uuid. |
card_background | The card's background image. |
customer_id | The associated customer ID. |
card_type | The card's type. |
swipe_expiration_exceptionsobject | The swipe expiration exceptions. > For more information see the swipe_expiration_exceptions table below. |
billing_addressobject | The card's billing address. > For more information see the billing_address table below. |
swipe_restrictionsobject | The card's swipe restrictions. > For more information see the swipe_restrictions table below. |
shipping_addressobject | The card's shipping address. > For more information see the shipping_address table below. |
Swipe expiration exceptions
This object holds information regarding how swipe expiration exceptions are made.
| Value: | Definition: |
|---|---|
attribute | The exception's type of transaction attribute. |
attribute_values | The value(s) of the attribute(s) selected within the attribute field. > Multiple values can be added with a comma delimiter. |
authorization_expiration_days | The number of days that will be added to the authorization_expiration_days value for swipes that meet the attribute criteria. |
Billing address
This object holds the card's billing address information.
| Value: | Definition: |
|---|---|
address | Line one of the cardholder's street address. |
address2 | Line two of the cardholder's street address. |
zipcode | The cardholder's zip code. |
city | The cardholder's city. |
state | The cardholder's state. |
country | The cardholder's country. |
use_customer_primary | Determines whether to use the customer's primary address. |
Swipe restrictions
This object holds information regarding how swipe restrictions are made.
| Value: | Definition: |
|---|---|
attribute | The exception's type of transaction attribute. |
attribute_whitelist | Determines whether the values provided are allowed or disallowed. |
attribute_values | The value(s) of the attribute(s) selected within the attribute field. > Multiple values can be added with a comma delimiter. |
authorize_when_empty | Determines whether swipes will be authorized or denied when the attribute values are empty. |
Shipping address
This object holds the card's shipping address information.
| Value: | Definition: |
|---|---|
address1 | Line one of the cardholder's street address. |
address2 | Line two of the cardholder's street address. |
zipcode | The cardholder's zip code. |
city | The cardholder's city. |
state | The cardholder's state. |
country | The cardholder's country. |
use_billing | Determines whether to use the customer's billing address. |
use_customer_mailing | Determines whether to use the customer's mailing address. |