This request creates 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.
Note the following when using 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. See the GET issuer account request for more information.
This request will generate a job_uuid that can be used in the GET job updates request.
Programs fit within the Secure Payments hierarchy like the following:
Secure Payments account > Issuers > Card Programs > Cards > Swipes > Swipe Events
{
"program": {
"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": {
"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
}
}
Results
Returns the card program's job_uuid after a successful card program creation. An error results in a message indicating the type of error (e.g. missing a required field).