To avoid misuse, new cards are shipped to Account Holders in an “inactive” state. This means that the card cannot be used for any 

until the Account Holder activates it. Activation also includes setting a card PIN, as the new card is shipped without one for security reasons. In this article, you learn about:

• Activating card
• Setting card PIN

Before you begin

Before you explore Fusion's card APIs, we recommend that you familiarize yourself with various card related concepts mentioned in Card orders.

Activate card

The process of card activation depends on your business use-case and implementation. For example, Account Holders can use the mobile app to scan the QR code printed on the welcome letter. On successful verification, the card is activated.

Set card PIN

Use the /setPin API to set a new PIN for card. The API doesn’t require old PIN.

Endpoint URI

/api/v1/ifis/{ifiID}/cards/{cardID}/setPin

Input parameters

• ifiID: Required. Unique identifier of the IFI.
• cardID: Required. Unique identifier of the card whose PIN is to be set.
• newPin: Required. New PIN to be set. The old PIN will no longer be valid.
• nonce: Required. Current Unix epoch time.

Example

In the following example, we generate a new 4-digit PIN for the Account Holder’s card:

curl -X POST 'https://fusion.preprod.zeta.in/api/v1/ifis/140827/cards/811b678a-0201-4756-8370-5a48d7950149/setPin' \
-H 'Authorization: {{AUTH_TOKEN}}' \
-H 'Content-Type: application/json' \
--data-raw '{
"newPin": "1234",
"nonce": 1587478923
}'

N/A