> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synctera.com/llms.txt
> Use this file to discover all available pages before exploring further.

# A Typical Card Workflow

> A worked example following one physical debit card from the moment you offer it through to the customer cancelling it, with the API calls and webhooks at each step.

An example covering a physical debit card from creation to cancellation, activated by barcode.

## Requesting Card Issuance

1. You offer a card product to a customer. Call [List Card Products](/v2/reference/listcardproducts) and note the `id` of the product you want to offer.
2. The customer signs up and accepts the card disclosure. Disclosure is generally handled as part of account onboarding, but can be a separate process. See [Record Disclosure Acceptance](/v2/docs/record-disclosure-acceptance).
3. You call [Issue a Card](/v2/reference/issuecard) with the customer, account, card product, embossed name, and optional shipping information. The response contains the card object and its ID.
4. You receive `CARD.UPDATED` webhooks as the card is ordered, manufactured, and shipped, so you can keep the customer informed and react if the card is rejected.

```mermaid mermaid theme={"system"}
%%{init: {"fontFamily": "sans-serif"}}%%
sequenceDiagram
FinTech->>Customer: Offer card product
Customer->>FinTech: Sign me up
FinTech->>Synctera Platform: "Issue a Card"
Synctera Platform->>FinTech: CARD.CREATED webhook
Synctera Platform->>FinTech: CARD.UPDATED webhooks<br>(ordered, shipped)
```

## Activating a Card

1. Your customer receives the card, logs into your app, and scans the barcode with their phone camera.
2. Your app translates the barcode into its value.
3. You call [Activate Card](/v2/reference/activatecard) with that value and the customer ID.
4. The Cards API requests activation through the card vendor.
5. You prompt the customer to set a PIN using the Set PIN widget.
6. The widget sends the PIN directly to the card vendor.
7. The card vendor activates the card and notifies the Synctera platform.
8. The card's status becomes `ACTIVE`, and you receive a `CARD.UPDATED` webhook.

```mermaid mermaid theme={"system"}
%%{init: {"fontFamily": "sans-serif"}}%%
sequenceDiagram
Customer->>FinTech: Scan barcode on card
FinTech->>FinTech: Translate barcode to value
FinTech->>Synctera Platform: Send barcode value:<br>"Activate Card"
Synctera Platform->>Card Vendor: Activate card
Customer->>FinTech: Set PIN through widget
FinTech->>Card Vendor: Widget sends PIN
Card Vendor->>Card Vendor: Activate card
Card Vendor->>Synctera Platform: Card is active
Synctera Platform->>FinTech: CARD.UPDATED: ACTIVE
```

## Reissuing a Card

1. Your customer reports that they lost the card.
2. You call [Issue a Card](/v2/reference/issuecard) with the same details as the original, plus `reissue_reason` of `LOST` and `reissued_from_id` of the lost card. You can also do this from the Synctera dashboard.
3. Synctera immediately terminates the lost card with the card vendor and sets its status to `TERMINATED`.
4. The new card is issued and activated just as the lost card was — with a new PAN, but the same PIN.

```mermaid mermaid theme={"system"}
%%{init: {"fontFamily": "sans-serif"}}%%
sequenceDiagram
Customer->>FinTech: I lost my card
FinTech->>Synctera Platform: "Issue a Card"<br>reissue_reason: LOST
Synctera Platform->>Card Vendor: Terminate card
Synctera Platform->>Synctera Platform: Old card: TERMINATED
Synctera Platform->>Card Vendor: Issue new card
Card Vendor->>Customer: New card, new PAN, same PIN
```

## Cancelling a Card

1. The customer cancels the card.
2. You call [Update Card](/v2/reference/updatecard) to set the status to `TERMINATED`. You can also do this from the Synctera dashboard.
3. Synctera notifies the card vendor.
4. The card vendor terminates the card.

```mermaid mermaid theme={"system"}
%%{init: {"fontFamily": "sans-serif"}}%%
sequenceDiagram
Customer->>FinTech: Cancel my card
FinTech->>Synctera Platform: "Update Card" to<br>TERMINATED status
Synctera Platform->>Card Vendor: Terminate card
Card Vendor->>Card Vendor: Terminate card
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Card Lifecycle" href="/v2/docs/card-issuance-management" icon="arrows-rotate">
    The states behind each step above.
  </Card>

  <Card title="Issue a Card" href="/v2/docs/issue-a-card" icon="credit-card">
    The full issuance and activation reference.
  </Card>
</CardGroup>