On This Page
Release Notes
These release notes cover all releases to the production server for the week ending
October 30, 2026
.Announcements
These announcements are for
October 30, 2026
.SOAP Toolkit Authentication Update
will no longer support username- and password-based
authentication for merchants who use the
SOAP Toolkit key
. You must remove
username- and password-based authentication from your SOAP Toolkit integration and
transition to certificate-based authentication by these dates:- Test Environment: April 15, 2026
- Production validation test (shock test): September 30, 2026. This applies only to selected merchants.
- Production Environment: October 7, 2026
Your API requests to will be rejected if
you do not implement P12 authentication by the required dates.
Batch Upload Service IP Address Updates
The legacy IP address for the Batch Upload service will be replaced by two new IP
addresses. We recommend that you use domain names instead of IP addresses.
The new addresses will take effect at these URLs and times:
Testing Environment
batchtest.cybersource.com
July 28, 2026, at 4:00 a.m. UTC
Production Environment:
batch.cybersource.com
September 15, 2026, at 4:00 a.m. UTC
Enhanced Webhook URL Review and Approval Process
We have introduced an enhancement to webhook subscription processing to improve security,
compliance, and visibility for webhook-related URLs. Webhook URLs are now validated and
reviewed before they can be used. This includes both new subscriptions and existing
subscriptions currently on file.
Introduced Changes
Introduced Changes
When a webhook subscription is created or updated, the URLs associated with that subscription
are evaluated through a validation and approval process.
Applies to:
- Webhook URL (required)
- OAuth URL (if applicable)
- Health Check URL (if applicable)
As part of this enhancement, user-facing statuses have been added:
- PENDING_REVIEW
- BLOCKED
The existing INACTIVE status remains unchanged and continues to indicate that the subscription
is approved and ready within the current lifecycle.
Status Descriptions
Status | Description |
|---|---|
PENDING_REVIEW | One or more submitted URLs are being
validated or awaiting required security approval. |
BLOCKED | One or more URLs were rejected or
identified as unsafe or non-compliant. The subscription cannot
proceed until the URLs are updated. |
INACTIVE | All required approvals are complete,
and the subscription is ready under the existing activation
flow. |
How the New Process Works
How the New Process Works
- A webhook subscription is created or updated.
- Submitted URLs are checked against existing approval records.
- New or unknown URLs are evaluated through automated validation.
- If additional review is required, the subscription status changes to PENDING_REVIEW.
- If any URL is rejected or blocked, the subscription status changes to BLOCKED.
- If all required URLs are approved, the subscription status changes to INACTIVE.
In cases where a subscription status is changed to BLOCKED, merchants are expected to perform
these tasks:
- Review the affected endpoints.
- Update the URLs to an acceptable endpoint.
- Resubmit the subscription for processing.
For New Subscriptions
For New Subscriptions
New webhook-related URLs might go through validation and, if necessary, security review before
the subscription can proceed.
Why We Are Making This Change
Why We Are Making This Change
This enhancement provides these benefits:
- Reduce security riskby preventing outbound calls to unapproved endpoints.
- Improve compliancethrough stronger review and approval controls.
- Increase transparencywith clearer merchant-visible statuses.
- Support scalethrough a standardized and repeatable validation process.
Message-Level Encryption Upcoming Mandate
An updated version of message-level encryption (MLE) will become required in order for
merchants to use the APIs. Portfolio owners must enable this updated version of MLE in
order for their merchants by
March 1, 2027
.This required MLE update encrypts all data in your API response messages. The previous
version of MLE encrypted only request messages. If your merchants are already using custom
JSON Web Token messaging, they must also update how their system constructs JWTs.
Merchants
who are using HTTP signature messaging must migrate their system to JWT messaging.
You risk transaction failures if you do not implement this MLE
update.
Overview of MLE
MLE is a robust security protocol designed to encrypt individual messages or payloads
at the application layer. By protecting sensitive data at the message level, MLE ensures
that your information remains secure as it moves through systems and networks, providing a
layer of security beyond traditional transport encryption.
Enabling MLE requires you to create a REST API key for request messages and a
REST
– API Response MLE
key for response messages. If your organization is using
a meta key, the portfolio account or merchant account user who created the meta key
must also create the REST – API Response MLE key.- Update Methods
- Create or update your custom MLE integration using JWTs with P12 certificates. For more information, see the Enable Message-Level Encryption section in theGetting Started with REST Developer Guide. For a method using shared secret key pairs, see the HTTP Messaging Migration to JWT Messaging section.
- Update your REST API SDK. For more information, see theREST API related productssection in the Cybersource GitHub.
JSON Web Token Construction Update
There are new requirements for how to construct JSON Web Tokens (JWTs) to
send API request messages. If you use a custom integration to construct JWTs, you must
update your system to remain compliant. This update is necessary to support the new MLE requirements.
- Update Methods
- See Construct JWT Messages Using aP12 Certificatein theGetting Started with REST Developer Guide
- See Construct JWT Messages Using aShared Secret Key Pairin theGetting Started with REST Developer Guide
HTTP Messaging Migration to JWT Messaging
By
March 1, 2027
, all merchants using HTTP signature messaging must migrate to
JWT messaging to support MLE. Merchants already using HTTP signature messaging with
shared secret key pairs can now continue using their existing keys with JWT
messaging. - Update Method
- See Construct JWT Messages Using aShared Secret Key Pairin theGetting Started with REST Developer Guide
Network Routing Architecture Update
endpoints will be migrated from the current routing model to a new
architecture using updated IP subnet ranges.
This enhancement improves the performance, resiliency, and reliability of
transaction delivery over the Internet. It will also enable seamless transaction routing
across multiple Visa data centers, supporting more consistent and reliable transaction
processing.
Endpoints and IP Addresses Included
Current Application and endpoints:
CAS/Test
: apitest.cybersource.com
(current IP address:
66.185.182.49
)Production
: api.cybersource.com
(current IP address:
66.185.182.149
)Potential Impact
Merchants who connect to the REST API endpoints (
apitest.cybersource.com
and
api.cybersource.com
) use a Domain Name System (DNS) should not be
affected. DNS records will be updated automatically to use the new routing
architecture.Merchants with networks configured to allowlist IP addresses or who have hardcoded IP addresses
will likely be impacted. These merchants should update proxy or firewall settings to
include the new Visa IP address ranges.
There are no changes to TLS/SSL certificates or supported ciphers as part of this
migration. However, continues to recommend trusting the root TLS
certificates for all secure endpoints.
Migration Timeline
CAS/Test
: October 15, 2026Production
: January 31, 2027Now Available
This technology is now available in both the test and production environments through
these domains:
CAS/Test
: apitest.visaacceptance.com
Production
: api.visaacceptance.com
Deploying in the CAS/Test Environment provides a safe environment to test and validate access.
When testing is complete, you may migrate production processing.
How to Adopt This Change
To use the new routing architecture, your firewall or your commerce platform provider's
firewall must be configured to permit outbound traffic to the Visa cloud.
This large, dynamic IP address space represents a significant change from current access
configurations. Therefore, it is critically important to test firewall configurations
and confirm that connections are successful before migrating production traffic.
Merchants who require IP address allowlists can use one of these options:
Option 1
: Merchants can add these specific subnet ranges to IP address allowlists:- 198.217.128.0/17
- 198.241.128.0/17
- 66.185.176.0/20
Option 2
: Merchants can add these generic subnet ranges to IP address allowlists:- 198.241.206.0/24
- 198.241.207.0/24
Secure Acceptance Sunset
Secure Acceptance is being sunset as part of a move toward web-based payment acceptance
solutions. The target date for merchants to complete migration from Secure Acceptance
was September 30, 2026.
Unified Checkout is available as the recommended migration path. It provides a low-code
payment acceptance experience with support for expanded payment options and integrated
services.
For more details about this change and guidance on how to migrate, see this knowledge
base article: Secure Acceptance Sunset (KA-11531).
Review your migration plans and take the necessary steps to move from Secure Acceptance before
the deadline. If you need assistance, contact your Visa representative.
Transaction Search Performance Update
is aware of an intermittent issue that impacts transaction
search performance. The search functions in the APIs and
Business Center
are
served from a shared search platform that is used by all Transaction Management module
customers. An issue can occur when there is unusually high search activity, which places
a heavy load on the shared search service. applied traffic
controls to reduce the impact and is rolling out additional safeguards to prevent
recurrence.This issue does not impact payment processing transactions.
To improve transaction search performance and provide more consistent response times, the
transaction search platform is being updated for requests that use multiple search
identifiers. As part of this enhancement, searches that include multiple identifiers
will support up to 15 identifiers per request. Merchants whose integrations currently
submit larger batches should update their systems to divide searches into smaller
requests.
Merchant Impact
- You might occasionally experience slower response times or timeouts.
- For API integrators, an HTTP429response often indicates that there are too many request responses on Transaction Search, Case Search, or the Find Similar Transactions feature, particularly for large, broad, or long-date-range searches.
Recommended Actions
- Keep multi-value lookups to 15 identifiers or fewer per search.
- Use the narrowest date range that answers your question. A period of no more than 7 days is recommended for interactive transaction searches.
- Break large bulk lookups into smaller batches instead of using one large combined search.
- Avoid broad wildcard searches, especially searches that use a short prefix and an asterisk (*).
- If a search is slow or times out, wait a moment before retrying instead of retrying immediately.
- For API integrators:
- Limit each request to 15 or fewer identifiers.
- Use the narrowest date range your job needs.
- Implement back off on timeouts or errors instead of tight-loop retries.
- If you receive a429response, honor any Retry-After value and reduce your request rate and batch size rather than immediately retrying.
- If your workflow repeatedly requires a large multi-identifier or long-date-range search, contact your support or account team so that it can be reviewed for the batch and export path or an appropriate exception.
Recommended Next Step
Review your search and integration patterns and adhere to the guidance provided in
the Best Practices for
Implementing Searches section.
Best Practices for Implementing Searches
These best practices apply to searches that you implement using the Transaction
Search API, Case Search API, and the
Business Center
. Following these
practices will help keep your searches and detail lookups fast and reliable.- General Guidance
- Keep multi-value lookups to 15 identifiers or fewer per search. Identifiers include reference numbers, request IDs, or account numbers. For larger lookups, use another method instead of one very large interactive request.
- Use the narrowest date range that answers your question. Use a period of no more than 7 days for interactive transaction searches.
- Break large bulk lookups into smaller batches. For example, implement several searches of less than or equal to 15 identifiers and less than or equal to 7 days instead of implementing one combined search that spans many identifiers and a long date range.
- Retry failed or slow searches manually, using a short pause instead of immediately re-running the identical search in an automated loop.
- Practices to Avoid
- Do not implement broad wildcard searches. These searches scan a large portion of the search index and use the most resources.
- These wildcard validation rules now apply:
- Leading wildcard searches are no longer accepted.
- Wildcard searches must contain a minimum of three characters preceding the wildcard character (*). These examples demonstrate the unsupported and the accepted wildcard formats.Unsupported Wildcard Formats:
- *ABC
- A*
- AB*
- 12*
Accepted Wildcard Formats:- ABC*
- ABCD*
- 123*
- Avoid combining a large number of identifiers with a long date range in the same search. Cost increases roughly with identifiers multiplied by a date range, so a search that is fine alone can be expensive when both are large together.
- Avoid automated rapid-retry on a timeout. An identical search that timed out will typically time out again if re-run immediately, which adds load on the service without improving results.
- API Searches: Request Shape
- Cap each request to 15 or fewer identifiers when using multi-value lookups. If your integration currently sends larger batches, split them into multiple smaller requests.
- Use an end-of-day reconciliation or bulk report instead of paging through many large interactive search calls.
- Use the narrowest date range your job actually needs. Recurring jobs that request a wide window are a common source of avoidable load.
- Avoid wildcard or short-prefix values in identifier fields. Search for an exact full value when it is available.
- API Searches: Retry and Error Handling
- Implement a back-off retry instead of tight-loop retry. If a request times out or errors, wait before retrying, and increase the wait time on repeated failures (exponential back off).
- If you receive a429(rate limited) response, treat it as a signal to slow down, not a bug to route around. Honor any Retry-After value if present, and reduce your request rate/batch size rather than retrying immediately or in parallel.
- Cap your retry attempts for a given request. For example, make 3 to 5 attempts with increasing back-off retries and alert/log instead of retrying indefinitely.
- Watch for repeated identical requests from your own systems. A scheduled job that re-issues the exact same search on every run because a previous run did not complete can create a sustained load without your team realizing it. Add job-level locking or de-duplication search so a stopped run does not stack up.
- Business CenterSearches
- Transaction Search:search on a specific field (order number, request ID, reference number) instead of a broad free-text and keyword term when possible. Keep the date range to 7 days or fewer.
- Quick Search:use a reasonably narrow date range rather than the widest default. If you manage multiple sub-accounts under a parent account, search from the specific sub-account instead of from the top-level parent view when you know the account where the transaction belongs.
- Bulk Export and Reporting:if you need a large number of transactions or cases, use theBusiness Centerreport feature to pull the full set at once instead of repeatedly re-running and paging through search results. If a search is slow or times out, wait a moment and retry once instead of repeatedly clicking search or refresh in quick succession.
Features Introduced This Week
Bulk Actions Permissions Added for Organization Onboarding |
RM-49277
Bulk Actions Permissions Added for Organization Onboarding
|
RM-49277- Description
- A new Bulk Actions module enables resellers to onboard multiple organizations to the platform more efficiently. This enhancement reduces manual effort by supporting bulk onboarding workflows and providing visibility into submitted bulk actions. Users with the appropriate permissions can view previously submitted bulk actions or initiate new bulk onboarding actions through the Bulk Actions module.
- Mandate
- Does not apply.
- Audience
- Some resellers and portfolio managers responsible for onboarding organizations.
- Technical Details
- Access to the Bulk Actions module is controlled by thecanViewBulkActionsandcanManageBulkActionsderived permissions. Users receive these permissions when the Bulk Actions feature and the corresponding onboarding permissions are enabled.
- Important Dates
- Released on October 21, 2026.
Fixed Issues
Automated Clearing House (ACH) eCheck Follow-On Credit Eligibility
Restored | RM-49229
Automated Clearing House (ACH) eCheck Follow-On Credit Eligibility
Restored
| RM-49229- Description
- This release corrects a defect affecting Automated Clearing House (ACH) eCheck transactions. In some cases, follow-on credits were incorrectly unavailable because the system could not accurately calculate transaction age when processing request IDs longer than 26 characters. Following this release, merchants can perform eligible follow-on credits for ACH eCheck transactions for up to 180 days after the original debit transaction, consistent with the intended processor rules.
- Mandate
- Does not apply.
- Audience
- Some merchants processing eCheck transactions through an ACH processor.
- Technical Details
- No API changes are required, and no merchant configuration changes are necessary to use utilize this correction.
- Important Dates
- Released on October 24, 2026.
Known Issues
Blank Batch Response Files for Batch Upload |
EPS-43394
Blank Batch Response Files for Batch Upload
|
EPS-43394- Description
- Some merchants submitting stand-alone credits through Batch Upload might receive a blank response file even when the transaction processes successfully.
- Audience
- Merchants using Batch Upload through Payments 2.0 processing flows, including affected Fiserv merchants.
- Technical Details
- For affected Batch Upload transactions, transaction batch identifiers are not populated during processing through the Payments 2.0 REST/Kafka ingestion channel. As a result, the batch reporting process cannot associate transactions with the submitted batch and returns a blank response file. Transaction processing itself is not affected and successful transactions can continue to be processed normally.
- Workaround
- No known workaround.
Some Click to Pay Authentication Results Misreported | EPS-43856
Some Click to Pay Authentication Results Misreported
| EPS-43856- Description
- Some customers using Unified Checkout Click to Pay (CtP) with Passkey authentication might receive an indication that cardholder authentication was unsuccessful even when authentication has completed successfully.
- Audience
- Merchants and integrators using Unified Checkout Click to Pay (CtP) through the UI.
- Technical Details
- For impacted transactions, the response might returncardholderAuthenticationStatus=falseeven though valid authentication data such as CAVV and XID values is present.
- Workaround
- To determine whether additional 3-D Secure authentication is required, merchants validate the presence of authentication data returned in the Click to Pay payload, including returned 3-D Secure values such as CAVV and XID.
Risk Profile Configuration Not Visible |
EPS-46325
Risk Profile Configuration Not Visible
|
EPS-46325- Description
- Some transactions might be rejected even though the associated risk profile configuration is not visible in theBusiness Center, making it difficult for affected acquirers to determine the source of the rejection or identify the merchants assigned to the profile.
- Audience
- Resellers and acquirers using Partner Risk Control (Parc).
- Technical Details
- Impacted transactions might be rejected with the error messageYour aggregator or acquirer is not accepting this transaction - CARD_CATEGORY_ECI_REFUSED, triggered by aoff_us_domestic_creditconfiguration. In affected cases, the risk profile containing the rule is not displayed inBusiness Center, preventing users from viewing the configuration or determining which merchant IDs (MIDs) are assigned to the profile.
- Workaround
- No known workaround.
Unified Checkout Customer IP Addresses Not Forwarded | EPS-46439
Unified Checkout Customer IP Addresses Not Forwarded
| EPS-46439- Description
- When a Unified Checkout transaction includes a customer's IP address, Decision Manager does not consider the IP address during evaluation.
- Audience
- Some merchants using Unified Checkout with Decision Manager.
- Technical Details
- Some transactions might bypass Decision Manager rules that rely on the customer's IP address because thedeviceInformation.ipAddressvalue is not included in risk evaluation. No API error is returned, and non-IP-based Decision Manager rules continue to function normally.
- Workaround
- No known workaround.