Network Tokenization API Testing

Ensure your integration with the Network Tokenization API works correctly by simulating network tokenization in Test Mode. If you’re interested in Network Tokenization, you can try it out in Test Mode. Sign up for a Pagos account or log into your existing account, then click the environment toggle in the top-right corner; a yellow bar will appear across the top of the Pagos Service Panel to confirm you’re in Test Mode.

Step 2: Generate Your Test Mode API Key

In Test Mode, generate an API Key for the Network Tokenization API.

These API Keys are universal across Test Mode and will be used for testing all Pagos API products. If you’ve already created an API key in Test Mode, you don’t need to create a new one.

To generate your API key:

Click your settings icon in the top-right corner of your Pagos Service Panel.

Under Developers, click API Keys.

In the API Keys tab, click Create API Key to add a new key to your account.

In the side panel that opens, set your Key Name, then click Create API Key.

Copy your new API Key and store it somewhere secure.

This is the only time you can view this key!

Click I’ve Copied My Keys to confirm and exit the side panel.

Step 3: Test Provisioning a Network Token

Use our test PANs to test provisioning a network token in Test Mode.

Step 4: Test Transacting With a Token

You can test fetching a cryptogram on the tokenRefId returned for a card you successfully tokenized.

{
    "cryptogram": "eY1KRnm18Uawh78qUjzWeQ==",
    "token": "4552981839633026",
    "eci": "07",
    "metadata": null,
    "expirationDate": {
        "year": "2026",
        "month": "06"
    }
}

Step 5: Test Requesting Account Data

You can test requesting account data on the tokenRefId returned for a card you successfully tokenized. The response for your /account call will include a cardArt array containing URLs to the card image file(s).

Amex and Discover cards don’t support card art at this time.

{
    "cardNetworkName": "visa",
    "tokenAccount": {
        "last4": "0002",
        "expirationDate": {
            "month": "06",
            "year": "2026"
        },
        "par": "V2831416512995186306443704057"
    },
    "backgroundColor": "0xffffff",
    "foregroundColor": "0x000000",
    "labelColor": null,
    "contactName": null,
    "contactWebsite": null,
    "contactEmail": null,
    "contactNumber": null,
    "termsAndConditionsUrl": null,
    "privacyPolicyUrl": null,
    "shortDescription": "Test Visa Dark Card",
    "longDescription": null,
    "cardArt": [
        {
            "url": "https://assets.sandbox.pagos.ai/card-art/visa/522e753f-3873-4cb7-90ae-18a458dcfc6f.png",
            "description": null,
            "height": 100,
            "width": 100,
            "type": "card_art"
        },
        {
            "url": "https://assets.sandbox.pagos.ai/card-art/visa/b58c78b7-32a6-4e87-80e2-b3a3b0c12a91.png",
            "description": null,
            "height": 969,
            "width": 1536,
            "type": "card_art"
        }
    ],
    "metadata": null,
    "assetStatus": "available"
}

Step 6: Test Requesting the Status of a Token

You can test requesting a token’s status using the tokenRefId returned for a card you successfully tokenized. The response for your /status call will include random year and month values, following the examples below:

{
    "tokenRefId": "visa-8e9c3493ce9a2e299b7242b43254b625",
    "expirationDate": {
        "year": "2024",
        "month": "09"
    },
    "status": "active",
    "cardNetworkName": "visa",
    "panLast4": "1100"
}

Step 7: Test Token Status Changes

Network Tokenization Test Mode is stateful, meaning all token status actions will persist for the life of a token.

Use the tokenRefId returned for a card you successfully tokenized to test the following status changes:

Test PANs

All test PANs will pass Luhn verification checks.

VISA TEST PAN	PROVISIONING RESPONSE
`4000000000000002`	Success
`4000000000000010`	ProvisionDataExpired
`4000000000000028`	CardVerificationFailed
`4000000000000036`	CardNotEligible
`4000000000000044`	CardNotAllowed
`4000000000000051`	CardDeclined
`4000000000000069`	ProvisionNotAllowed
`4000000000000077`	InvalidTokenStatus
`4000000000000085`	Success
`4000000000000093`	Success

MASTERCARD TEST PAN	PROVISIONING RESPONSE
`5100000000000008`	Success
`5100000000000024`	CardNotEligible
`5100000000000032`	IssuerDeclined
`5100000000000040`	InvalidInput
`5100000000000057`	InvalidInput
`5100000000000065`	Success
`5100000000000073`	Success

DISCOVER TEST PAN	PROVISIONING RESPONSE
`6011000000000004`	Success
`6011000000000012`	ProvisionDataExpired
`6011000000000020`	CardVerificationFailed
`6011000000000038`	CardNotEligible
`6011000000000046`	CardNotAllowed
`6011000000000053`	CardDeclined
`6011000000000061`	ProvisionNotAllowed

AMEX TEST PAN	PROVISIONING RESPONSE
`370000000000002`	Success
`370000000000010`	CardMarketNotSupported
`370000000000028`	CardNotEligible
`370000000000036`	CardCannotBeTokenized
`370000000000044`	IssuerNotSupported
`370000000000051`	CardCancelled
`370000000000069`	Success
`370000000000077`	Success

Authentication

Data & Response Codes

Data Ingestion

Pagos MCP Server

BIN Database

Account Updater

Network Tokenization

Network Tokenization API Testing

Step 2: Generate Your Test Mode API Key

Step 3: Test Provisioning a Network Token

Step 4: Test Transacting With a Token

Step 5: Test Requesting Account Data

Step 6: Test Requesting the Status of a Token

Step 7: Test Token Status Changes

Test PANs

Authentication

Data & Response Codes

Data Ingestion

Pagos MCP Server

BIN Database

Account Updater

Network Tokenization

​Step 1: Create a Pagos Account or Sign In

​Step 2: Generate Your Test Mode API Key

​Step 3: Test Provisioning a Network Token

​Step 4: Test Transacting With a Token

​Step 5: Test Requesting Account Data

​Step 6: Test Requesting the Status of a Token

​Step 7: Test Token Status Changes

​Test PANs

Step 1: Create a Pagos Account or Sign In

Step 2: Generate Your Test Mode API Key

Step 3: Test Provisioning a Network Token

Step 4: Test Transacting With a Token

Step 5: Test Requesting Account Data

Step 6: Test Requesting the Status of a Token

Step 7: Test Token Status Changes

Test PANs