Physical card embossing

There are three types of physical (plastic/metal) card:

• Mag stripe card – Card data is stored in a magnetic strip. A customer swipes the card to use it. This type of card is easy to counterfeit, because the data in the strip is static.
• EMV contact card – Card data is stored in a chip. A customer dips (inserts) the card to use it. The cryptography in the chip creates tumbling security codes, making it much harder to counterfeit, but it costs more to issue.
• Dual interface card – Card data is stored in a chip. There is also an embedded antenna, so a customer can either dip or tap to use the card. This is the most convenient type of card for the customer, but it's the most expensive to issue.

You can use the Pismo platform to issue physical cards using your chosen embossing provider or providers. After setting up your program, you need to meet with your Pismo representative to configure your embossing provider(s) and schedule.

The embossing process occurs daily according to your requested schedule, which can run at different times on different days. During an embossing run, Pismo submits all eligible cards and their required data via an encrypted file to the embosser(s) via OFTP or SFTP.

The following API endpoints allow you to view or revise your personalized embossing configuration information:

• Get nominal card embossing information
• Update nominal card embossing group
• Get noname card embossing information
• Update noname card embossing group

For nominal cards, a customer is designated the cardholder at card creation. Noname cards are batch-generated and not initially associated with customers, which occurs later.

🚧

The embossing layouts used for noname and named embossing processes are different. If you plan to use both noname and named cards, you need to set up layouts for both with your chosen embosser.

The printed name on cards is set when you create an account. After that, you can call the Update card information endpoint to revise it.

Embossers

The following are embossers Pismo currently work with:

• JallCard
• Gemalto (Thales)
• Alterosa
• EM1
• Idemia
• Intelcav
• Seshasai
• Valid

If you have an embosser not listed here that you would like to work with, please let us know.

Embossing rules

A nominal card may not be embossed for the following reasons:

• Card's account does not have a registered address
• Address with special characters (non-UTF-8 standard characters)
• A printed name with special characters (non-UTF-8 standard characters)
• Does not have a CREATED status
• The card password has not been updated, unless configured otherwise (see section following).

When a card is initially created, nominal or noname, Pismo randomly generates a password (PIN). Except for noname cards, the user needs to create their own password before embossing, which the issuer typically prompts them to do. Noname cards are automatically embossed, but before being used, they need to be associated with a customer who then has to change the password before the card is activated.

On demand embossing - override card password updated requirement

By default, cards enter the embossing window when the card's password is updated. Once that happens, they are embossed in the next embossing window present in your embossing configuration.

If your embossing configuration includes the ONDEMAND option , the password update is no longer the trigger for the card to enter the next embossing window. On-demand customers can emboss cards with NORMAL, BLOCKED, PENDING, and WARNING statuses, in addition to CREATED.

With this option, there are two endpoints you can use to emboss the card:

• Add card to next scheduled embossing
• Get encrypted card data for embossing
• Resend cards for embossing

Talk to your Pismo representative about setting this or open a JIRA ticket with type = Settings.

Embossing API endpoints

You can use the following API endpoints to generate embossed cards:

• Create card
• Reissue physical card
• Create noname card bulk - After this call, you need to call Start noname card bulk process to begin the embossing process.

All of these calls have an embossing_custom_field you can use to send data to your embosser. This field is a string that can store up to 1000 characters, allowing you to personalize it with, for example, a delivery tracking code or to indicate whether the card should be plastic or metal.

Embossing events

Embossed cards generate the following sequence of events:

As described above, when a card is added to the file to be sent to an embosser or rejected, it generates an Card embossing notification received event. For a noname card bulk, this means that up to 10,000 events could potentially be generated.

For example (success)

{
   "event_id":"09a3fbd1-8e36-5350-a004-a31c741f3c49",
   "timestamp":"2021-03-19T01:01:29Z",
   "domain":"cards",
   "event_type":"embossing",
   "schema_version":1,
   "org_id":"TN-ddce7e50-0485-49ec-a910-866dff0bfd0f",
   "cid":"83e07ddf-f453-4f8c-b905-2a588283dac3",
   "data":{
      "account_id":100105000,
      "customer_id":100102000,
      "program_id":1234,
      "card_id":5560000,
      "card_status":"CREATED",
      "tracking":"EM1008.202103190101001234",
      "error_message":""
   }
}

See Event data for more information about events.

See our Data and reporting guide for more information on events and setting up event notifications.