Setup for Digital First
This guide describes developer implementation for the Digital First product. For general information, see Digital First cards in the Choose a Card Strategy guide.
Prior setup
You must provide a digital card template to Galileo, as shown in the Design a Card guide:
- For cards that are provisioned to mobile wallets, see Tokenized card design.
- For other cards, see Digital card design.
Creating the card account
For new customers, use the Create Account endpoint. For existing customers, use the Add Account endpoint.
The sequence of events for card creation is slightly different for Digital First cards than for conventional cards. You must also arrange with Galileo to set up the event webhooks:
- You call Create Account or Add Account.
- Galileo creates the account and card records.
- Because the card is active upon creation, Galileo sends the
BACT: card_activated
event message. - The emboss process places an emboss record in a file to send to the embosser. This process runs once per day.
- When the emboss record is placed in the file, Galileo sends the
SHIP: card_shipped
event message.
Note
When using the Create Account endpoint for a Digital First product, the
CAPP: app_completed
event message is not sent.
Protecting the physical card
Because the card is in an active state upon creation, there is a risk of the physical card being intercepted and used while in transit to the cardholder. To prevent the physical card from being used before it reaches the cardholder, set a block when the account is created, and then when the cardholder sets the PIN for the physical card, remove the block. (This type of block does not prevent the account from receiving deposits.)
At the time of account creation, call the Set Account Feature endpoint. (Alternatively, you can ask Galileo to set the account feature automatically upon card creation.) According to your use case, choose one of two types of block:
- If you do not provide your cardholders with the PAN immediately, set Feature 20 so that the physical card cannot be used online or at physical points of sale. However, provisioning a card to a mobile wallet and mobile wallet transactions are permitted, as well as card loads.
featureType: 20
featureValue: Y
- If you provide the PAN to your cardholders to use immediately, set Feature 21, which prevents the physical card from being used at physical points of sale but does not block card loads. This setting permits card-not-present and mobile wallet transactions.
featureType: 21
featureValue: Y
Note
Account Features 20 and 21 are mutually exclusive—only one can be set to
Y
at a time.
Your next steps depend on how the PIN was set:
- If your cardholders use the IVR to set the PIN, Feature 20 or 21 will be automatically set to
N
, and you will receive thePINC: PIN_changed event
. Your IVR process must specifically be configured for Digital First for this automation to work. - If your cardholders use another method besides the IVR to set the PIN, you will receive notification of the PIN set through the Account Events webhook, by arrangement with Galileo. When you receive notification that the PIN has been set, call the Set Account Feature endpoint again with these parameters, depending on which one you set previously:
featureType: 20
orfeatureType: 21
featureValue: N
Pausing the emboss
Depending on your business requirements, you may want to delay embossing a card until you know that the cardholder intends to continue with the account. For example, you can prevent a card from being embossed in the case that the cardholder cancels the account shortly after signing up for it.
Immediately after creating the account with the Create Account endpoint, call Set Account Feature with these parameters:
featureType: 30
featureValue: Y
startDate:
as desired; default is current date-timeendDate:
as desired; default is 3000-01-01
You can set the end date to a predetermined number of hours from the current time, or you can accept the default of the year 3000 (which is "never"). To resume the emboss process for the card, you can let the feature expire, or you can call Set Account Feature again to set feature type 30 to N
.
Presenting the digital card
Choose one of these options:
- To provision the digital card to a mobile wallet, follow the Setup for Mobile Wallets guide.
- To retrieve a digital image of the physical card, see Digital card image procedure in the Retrieving Card Information guide.
Lost or stolen Digital First cards
With cards in the Digital First program, the physical replacement card is activated at the same time it is created, and then it is sent to the embosser. The digital version of the card is created at the same time, which can be used until the physical card arrives. When the lost or stolen card is in a mobile wallet, the replacement card is not automatically updated in the wallet—the cardholder must input it manually or you can push-provision it.
See the Lost/stolen Digital First card process in the Lost, Stolen, or Damaged Cards guide for instructions.
If a cardholder reports a mobile wallet on a phone as lost or stolen, you can call Set Account Feature to set feature 22 to Y
, which blocks all mobile wallet transactions but permits card-present and card-not-present transactions.
Reissuing Digital First cards
When a cardholder reports the physical card as damaged, you can reissue the card using the same reissue process as for other card types:
- Reissue Card endpoint
- Modify Status endpoint with
type: 12
ortype: 19
A reissued Digital First card is not activated upon creation, and so there is no need to set account features to protect the reissued card in transit. No digital version of the reissued card is created, because the existing card is usable in mobile wallets and online until the reissued card is activated. See Card activation in Setting Up a Card Program for information on activation options.
When a Digital First card is about to expire, Galileo automatically reissues the card. The number of days before expiration is configurable, with a default of 30 days. There is no need to protect the physical card while in transit and no digital version of the card is created.
Galileo setup
These internal product parameters must be set at Galileo.
Parameter | Value | Description |
---|---|---|
FEMBO | Y | Forces cards to be embossed regardless of card status after account creation. |
CHITR | Y | Set when the Digital First card is to be provisioned to a mobile wallet. |
NNEXP | Y | Prevents a new expiration date from being generated by the card-emboss process, so that the digital and physical cards have the same expiry. |
XAACT | YNN | Activates both the card and the account immediately after calling the Create Account endpoint. Bypasses the standard account/card setup processes to create a digital card that is active and ready to use immediately. |
Updated 4 days ago