Update card program

This request updates a Card Program.

   Click here to learn more about this request

Card Programs are configurable templates for the cards that are issued to borrowers. From an Issuer's perspective, a Program serves both as a template for the card that's issued to a borrower and container for a collection of cards. Such is the same within Secure Payments.

Here's what you need to know about this request:

  • Card Programs act as templates for Cards where the values chosen become defaults. When creating a card and using the minimum required payload, the Program will autofill the remaining fields. Adding fields to the minimum payload, such as available_balance and swipe_enrichment, will override the default values for that individual card.
  • Card Programs are associated with an Issuer ↗.
  • This request will generate a job_uuid that can be used to pull the Program's ID ↗.
  • Programs fit within the Secure Payments hierarchy like the following:
    • Secure Payments account > Issuers > Card Programs > Cards > Swipes > Swipe Events

Sample Payloads

{
    "program": {
        "id": 314,
        "issuer_product_id": "1537-jhgf-!@#$kj",
        "name": "Traveler Rewards",
        "status": "active",
        "card_status": "pending activation",
        "card_title": "VISA Traveler Rewards TM",
        "issuer_account_id": 312,
        "swipe_enrichment": false,
        "display_card_attributes": "YES",
        "card_background": "image",
        "card_color": "128,128,128",
        "card_text_color": "255,255,255",
        "card_type": "virtual",
        "network": "visa",
        "card_currency": "USD",
        "processing_type": "credit",
        "available_balance": 5000,
        "available_advance_balance": 1000,
        "spend_limit": 5000,
        "spend_limit_interval": "monthly",
        "shipping_method": "standard",
        "bin": 410500,
        "authorization_expiration_days": 25,
        "card_metadata": "{\"tenantId\": \"5200243\"}",
        "swipe_expiration_exceptions": [
            {
                "attribute": "merchant-name",
                "attribute_values": "Hilton",
                "authorization_expiration_days": 5
            }
        ],
        "swipe_restrictions": [
            {
                "attribute": "merchant-category-code",
                "attribute_values": "3500,3501,3502,3549-4000",
                "authorize_when_empty": true,
                "attribute_whitelist": true
            }
        ]
    }
}
{
    "program": {
        "id": 314,
        "status": "active",
        "card_status": "pending activation",
        "processing_type": "credit",
        "issuer_product_id": "1537-jhgf-!@#$kj",
        "name": "Traveler Rewards",
        "card_title": "VISA Traveler Rewards TM",
        "issuer_account_id": 312,
        "available_balance": 5000,
        "available_advance_balance": 1000,
        "bin": 410500,
        "authorization_expiration_days": 25
    }
}
Language
Authorization
Click Try It! to start a request and see the response here!