Create card in LMS + Secure Payments

From a LoanPro perspective (and a real-world one, too), a Card is an instrument for accessing funds tied to a line of credit account. Note the following when creating cards:

This request initiates the card creation process. Cards are created within Secure Payments, but this request uses the LoanPro API to initiate the card creation process within Secure Payments. The card creation process is a collection of asynchronous tasks, which include creating the card entity, associated the card with other entities, pushing card information back into LoanPro, and more. Creating cards this way is advantageous by ensuring that the card information exists in both LoanPro and Secure Payments. However, there is an alternative request that creates the card only in LoanPro if preferred, To create a card only within LoanPro, see Create card in LMS ↗

Cards within LMS are associated both with a Customer and a Line of Credit account. Both entities are required when creating a card, and they must already be associated with each other.

Creating a card requires certain information to exist within the associated customer's profile. The associated customer profile must have a SSN or ITIN, email address, and phone number.

Once a card is created, its UUID is used to authorize swipes. However, please note that the card's UUID is generated by Secure Payments and pushed back into LoanPro via an asynchronous process. There is a short delay between the creation of the card and the storing of its UUID in LoanPro. Once returned, the card's UUID is stored within the "merchantCardToken" field of the Cards entity within LoanPro. To pull the card's UUID, use Get Card UUID ↗

Sample Payloads

{
    "entityType": "Entity.LineOfCredit",
    "entityId": 82983,
    "bucketId": 1,
    "customerId": 2245,
    "cardName": "Card for Account 82983",
    "programId": 3
}

{
    "programId": 779,
    "cardName": "Cashback Rewards",
    "bucketId": 1,
    "customerId": 261,
    "shippingAddress": {
        "address1": "161 Gerrard St E",
        "address2": null,
        "zipcode": "m5a2e4",
        "city": "Vancouver",
        "state": "geo.province.ON",
        "country": "company.country.can"
    },
    "billingAddress": {
        "address1": "161 Gerrard St E",
        "address2": null,
        "zipcode": "m5a2e4",
        "city": "Vancouver",
        "state": "geo.province.ON",
        "country": "company.country.can"
    },
    "entityId": 195,
    "cardCurrency": "USD",
    "spendLimit": 500,
    "spendLimitInterval": "monthly",
    "swipeRestrictions": [
        {
            "attribute": "merchant-mcc",
            "attributeValues": "5411",
            "attributeWhitelist": false,
            "authorizeWhenEmpty": false
        },
        {
            "attribute": "merchant-name",
            "attributeValues": "Amazon",
            "attributeWhitelist": false,
            "authorizeWhenEmpty": true
        }
    ],
    "cardType": "hybrid",
    "shippingMethod": "Standard",
    "entityType": "Entity.LineOfCredit"
}