May 2026

New acquirer_reference_number Field for Reconciliation Webhook Events

A new acquirer_reference_number field has been added to the following webhook events:

• reconciliation_success
• reconciliation_manual_adjustment

An Acquirer Reference Number (ARN) is a unique 23-digit identification number assigned by the acquirer to each Visa clearing transaction. ARN is used to track and trace transactions through Visa's system, especially for reconciliation purposes.

This change is additive and backwards compatible. Review your integration to ensure the new field does not affect existing processing logic.

Updated documentation can be found here: Webhook Notification

Release date:
This change will be released in May 5, 2026

April 2026

2026.04.17

Update: Removal of BLOCKED_BY_FRAUD from Update Card Status API

The BLOCKED_BY_FRAUD status will no longer be accepted in the Update Card Status API request and will be reserved for internal use only.

Please note that BLOCKED_BY_FRAUD remains a valid enum value and may still appear in API responses. However, it can no longer be used when sending requests.

Moving forward, please use one of the following statuses when updating card status:
ACTIVE, SUSPENDED, LOST, STOLEN, PERM_BLOCK, INACTIVE

Key Details:
Endpoint: PUT/api/v1/issuing_plans/{issuing_plan_opaque_id}/users/{customer_opaque_id}/cards/{contract_opaque_id}/status
Change: BLOCKED_BY_FRAUD removed from accepted request values

Release date:
This change will be released in 29 April 2026

March 2026

2026.03.02

Improvement: Transaction List API Enhancement

We are pleased to announce a performance improvement to the GET /transactions endpoint to ensure faster and more reliable responses.

The Transaction List API now includes a timeout to improve overall system stability and response times. Queries that take longer than 10 seconds will return an HTTP 504 response with error code XFC504001 instead of hanging indefinitely.

Key Details: Endpoint: GET /transactions Timeout: 10 seconds per request Error Response: If a query exceeds the timeout, you will receive an HTTP 504 with error code XFC504001 and message Query timeout exceeded

Recommended Actions: If you experience timeout errors, consider narrowing your query by using filters such as start_date, end_date, or reducing the page_size. This will help ensure your requests complete within the allowed duration.

Release date: This change will be released in 5 March 2026

February 2026

Create Limit API Behavior Change

Changed

• Create Spend Limit endpoint https://docs.straitsx.com/v1-CARDS/reference/create-spend-limit : Added validation to prevent updating existing spend limits. The endpoint now returns a 409 Resource Conflict with code XFC409001 error when attempting to create a spend limit that already exists.

Migration Guide

• If you were previously using the Create Spend Limit API to update existing limits, you must now use the dedicated Update Spend Limit endpoint instead.
• Check for Resource Conflict responses and handle them appropriately in your integration.
• To update an existing spend limit, use https://docs.straitsx.com/v1-CARDS/reference/update-spend-limit instead.

January 2026

December 2025

2025.12.24

Card Management and Transaction

• To enhance flexibility and better support different acquirer PIN flows, we now support both 4-digit and 6-digit PINs.

Note

Action required (Non-PCI merchants):

If you want to support 4-digit PINs, please update your PIN setup / PIN change input template to use a 4-digit PIN pad when users set or update their PIN.

PCI-compliant merchants: You may encrypt and submit a 4-digit PIN directly via our PIN setup or PIN reset APIs. No changes are required if you continue using 6-digit PINs.

2025.12.22

Card Management

• Added List Merchant BIN endpoint to view all available BINs and associated card products for your issuing group.
  • Merchant BIN indicates the starting and end range of your card program
• Added a Create Card Product endpoint to create new card products with custom embossing file name prefixes for physical card designs.
• Enhanced Card Configuration Update endpoint to allow updating card product designs before printing, as well as modifying the embossing name.

Note

• Card design changes and embossing name are only permitted before a card is scheduled for printing. New card product can reuse the same merchant bin.
• API documentation will be updated following deployment.

2025.12.15

Remote Host Authorization

• CVV2 verification results are now included in the metadata section of RHA calls for improved risk handling and issuer verification visibility.

Settlement

• settlement_summary Webhook now includes the total_atm_decline field when applicable.
• New settlement_offset webhook event has been added to notify you whenever a settlement offset occurs, allowing for improved tracking of credits and debits.

General

• All changes are additive and backwards compatible. Review your integration to ensure new fields and webhooks do not affect existing processing logic.