Skip to main content
If you are currently using Marqeta widgets for Activate Card or Set PIN functionality, follow this guide to migrate to Synctera widgets.
For Reveal Card functionality (displaying PAN, CVV, and expiration date), the Synctera Reveal Card Widget is now available.For PIN reveal functionality (the legacy Marqeta pinReveal flow), the Synctera Reveal PIN Widget is now available — see its migration table.

Activate Card Migration

API Changes

Code Changes

Before (Marqeta):
After (Synctera):

Backend Changes

Before (Marqeta):
After (Synctera):

Set PIN Migration

API Changes

Code Changes

Before (Marqeta):
After (Synctera):

Backend Changes

Before (Marqeta):
After (Synctera):

Key Differences

Event Handling

Marqeta widgets used postMessage or URL callbacks. Synctera widgets dispatch standard DOM events:

Customization

Marqeta widgets had limited customization. Synctera widgets support themes and custom labels:

Token Expiration

Both widget types use tokens that expire. Generate a new token on each page load:

Migration Checklist

  • Update backend API calls from /v0/cards/card_widget_url to /v1/cards/{card_id}/widget_token
  • Change HTTP method from GET to POST for token endpoint
  • Add widget script to your HTML (<script type="module" src="...">)
  • Replace <iframe> elements with web components (<activate-card> or <set-pin>)
  • Update event handling to use DOM event listeners
  • Test in sandbox environment before deploying to production
  • (Optional) Add custom theming and labels

Need Help?

If you encounter issues during migration, refer to the full documentation: