Batch Account Updater API
Batch Account Updater Testing
Ensure your Batch Account Updater integration works correctly by simulating Account Updater responses in our test environment.
You can use the following test values and responses in Test Mode for both Batch and Real-Time Account Updater.
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 Keys
In Test Mode, generate an API key pair for the Batch Account Updater API.These API keys are universal across Test Mode and will be used for testing both Account Updater and Network Tokenization. If you have 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.
2
Under Developers, click API Keys.
3
Click the Action API tab.
4
Under the Action API Keys header, click Create API Key to add a new key pair to your account. A side panel will open with the new Client and Private key values.
5
Copy your new API key pair and store it somewhere secure. You can only view the Private key one time.
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
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 |