Network Tokens Setup
Network Tokens is an Enterprise feature and the onboarding process is different between TEST and PRODUCTION Tenants. Start by requesting access from your test tenant in the Basis Theory Portal under Settings → Quotas.
Test Tenant Onboarding
Once enabled, your test tenant will be configured to use the Network Tokens sandbox, providing stubbed responses without forwarding requests to card networks. See Network Tokens Testing for more information.
Production Tenant Onboarding
Once access is enabled, merchants are created and onboarded directly in the Portal. See Onboard a Merchant for the full walkthrough, including the business information and per-network identifiers (Amex Direct SE Number, Discover MID) you will need to collect before you start.
Network Tokens on American Express is limited to merchants on a Direct SE relationship.
Tenant Configuration
The following configuration applies to both TEST and PRODUCTION Tenants after onboarding is completed.
Access Controls
Refer to the implementation guides to learn which Access Controls (applications, permissions, etc.) are required for your use case.
Webhook Configuration
You need to configure a webhook endpoint to receive real-time notifications for critical Network Token lifecycle events. This enables proactive monitoring and automated response to Network Token status changes.
Use the webhook management API or the Portal to register an endpoint URL to receive one or more of the following Network Token events:
network-token.created: Triggered when a new Network Token is successfully creatednetwork-token.cryptogram.created: Triggered when a cryptogram is generated for a Network Tokennetwork-token.deleted: Triggered when a Network Token is permanently deletednetwork-token.updated: Triggered when a Network Token is updated by the card network or the state of the Network Token is changed