Step 1: Create a Pagos Account or Sign In
If you’re interested in Batch Account Updater, 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 Batch Account Updater 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.
1
Click your settings icon in the top-right corner of your Pagos Service Panel.
2
Under Developers, click API Keys.
3
In the API Keys tab, click Create API Key to add a new key to your account.
4
In the side panel that opens, set your Key Name, then click Create API Key.
5
Copy your new API Key and store it somewhere secure.
This is the only time you can view this key!
6
Click I’ve Copied My Keys to confirm and exit the side panel.
Step 3: Test Batch Account Updater
Follow the instructions in our Batch Account Updater API Overview guide to perform the following actions in Test Mode using our test values:- Authenticate to confirm your access to the Batch Account Updater service
- Set up webhooks to receive notifications when important events occur
- Register encryption keys
- Prepare your data to be transferred securely to Pagos
- Submit Card Update Inquiries via the API
- Check the status of your inquiry jobs
- Receive updated card details
Keep in Mind:
- Test Mode is a stateless system that responds with simulated responses and processes in a synchronous manner
- When you submit test values, you’ll receive the expected response and corresponding webhook immediately
Test Values
You can use the following test values and responses in Test Mode for both Batch and Real-Time Account Updater.
Visa
| Visa Test Card Details | Response Code | Error Code | Response Code Description | Updated Card Details (If Applicable) |
|---|---|---|---|---|
| LAE | Change in account number or change in account number and expiration date |
| |
| LAE | Change in account number or change in account number and expiration date |
| |
| LCA | Closed account | ||
| LED | Change in expiration date |
| |
| LCC | Contact cardholder | ||
| LNB | Non-participating BIN | ||
| LNM | Participating BIN - No match | ||
| LNC | No change in account details | ||
| LCO | Card holder opt-out | ||
| LE02 | Account number invalid | ||
| LE03 | Account number format invalid | ||
| LE04 | Expiration date invalid | ||
| LE05 | Merchant not registered |
Mastercard
| Mastercard Test Card Details | Response Code | Error Code | Response Code Description | Mastercard Updated Card Details (If Applicable) |
|---|---|---|---|---|
| LAE | Change in account number or change in account number and expiration date |
| |
| LAE | Change in account number or change in account number and expiration date |
| |
| LCA | Closed account | ||
| LED | Change in expiration date |
| |
| LNB | Non-participating BIN | ||
| LNM | Participating BIN - No match | ||
| LNC | No change in account details | ||
| LNC | No change in account details | ||
| LE03 | Account number format invalid | ||
| LE04 | Expiration date invalid | ||
| LE05 | Merchant not registered | ||
| LE06 | Sub-merchant not registered |
Discover
| Discover Test Card Details | Response Code | Error Code | Response Code Description | Discover Updated Card Details (If Applicable) |
|---|---|---|---|---|
| LAE | Change in account number or change in account number and expiration date |
| |
| LAE | Change in account number or change in account number and expiration date |
| |
| LCA | Closed account | ||
| LED | Change in expiration date |
| |
| LCC | Contact cardholder | ||
| LBC | Brand conversion | ||
| LCP | Corrected previous update | ||
| LE01 | Undefined error | ||
| LE02 | Account number invalid | ||
| LE04 | Expiration date invalid |
American Express
| Amex Test Card Details | Response Code | Error Code | Response Code Description | Amex Updated Card Details (If Applicable) |
|---|---|---|---|---|
| LAE | Change in account number or change in account number and expiration date |
| |
| LAE | Change in account number or change in account number and expiration date |
| |
| LCA | Closed account | ||
| LED | Change in expiration date |
| |
| LCC | Contact cardholder for updated Account Information | ||
| LE02 | Account number invalid | ||
| LE03 | Account number format invalid | ||
| LE04 | Expiration date invalid | ||
| LE05 | Merchant not registered |