Batch Account Updater API
Batch Account Updater Testing
Ensure your Batch Account Updater integration works correctly by simulating Account Updater responses in a sandbox environment.
You can use the following test values and responses in the sandbox for both Batch and Real-Time Account Updater.
Step 1: Request Access
The Account Updater sandbox is not available for self-signup at this time. If you’re interested in Batch Account Updater, contact us to request a demo. The Pagos Accounts team will email you with an invitation to our sandbox environment. Follow the link in the invitation to confirm your email address, create a Sandbox password, and complete your account setup.Step 2: Generate Your Sandbox API Keys
When you first onboard with Batch Account Updater, open the Pagos Sandbox Service Panel to generate an API Key pair:These API Keys are universal across the sandbox and will be used for testing both Account Updater and Network Tokenization. If you have already created an API key, you don’t need to create a new one.
1
Click your profile icon at the bottom of the main navigation.
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 the Sandbox using our Sandbox testing 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:
- The sandbox 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 |