# Changelog #### 12 Mar 2026 * Add [guide](/guides/developer/headers/correlation-id) for `X-External-Correlation-Id` header usage * Update error codes for [verify PIN](/api-reference/strong-customer-authentication#verify-pin) and [verify device fingerprint](/api-reference/strong-customer-authentication#verify-device-fingerprint) endpoints #### 9 Mar 2026 * Add [relayed authorisation guide](/guides/product/issue-cards/relayed-authorisation) to card issuance * Update [card transaction api](/api-reference/card-transaction) to include relayed authorisation data * Update [card transaction webhook](/guides/developer/webhooks/event-types#cards-transaction-state-change) to include relayed authorisation data #### 3 Mar 2026 * Add fees and previous instructing agent in [swift-in simulation endpoint](/guides/product/receive-money/test-and-go-live) #### 26 Feb 2026 * Add details for submitting Tax Residency Kyc Requirement [kyc-review#kyc-submit](/api-reference/kyc-review#kyc-submit) #### 20 Feb 2026 * Adds support for providing the following on originators of third-party transfers * `nationality`: for `PRIVATE` originators * `businessRegistrationDate`: for `BUSINESS` originators #### 15 Jan 2026 * Multiple ID fields are now explicitly documented as `int64` (64-bit integer). Please ensure your integration stores these IDs using the appropriate 64-bit type (e.g., Long in Java, BIGINT in SQL). Key fields to note: - transfer ID - approaching the `int32` upper bound - recipient ID - approaching the `int32` upper bound - card transaction ID - past the `int32` upper bound - user ID - profile ID - balance ID - See [detailed data type changelog](/changelog/int64-changes) for all updated fields and endpoints. #### 24 Nov 2025 * Updated all sandbox URLs to point to the new sandbox environment. #### 18 Nov 2025 * Added `creationTime` and `modificationTime` fields in [Payment Token list](/api-reference/push-provisioning/pushprovisioningpaymenttokenslist). #### 5 Nov 2025 * Added missing fields in [Payin Deposit details](/api-reference/payin-deposit-detail/payindepositdetailget). #### 29 Oct 2025 * Updating the description of the [Open Banking Transactions endpoint](/guides/developer/open-banking). * Add details for submitting Account Intent Kyc Requirement [kyc-review#kyc-submit](/api-reference/kyc-review#kyc-submit) #### 21 Oct 2025 * Add new webhook event type [transfers#transfer-suspension](/guides/developer/webhooks/event-types#transfer-suspension) #### 10 Oct 2025 * Add [new strong customer authentication endpoints](/api-reference/strong-customer-authentication). * Deprecated [SCA enrolment factors endpoints](/api-reference/user-security). * Deprecated [SCA verification endpoints](/api-reference/one-time-token). #### 03 Oct 2025 * Update [recipient confirmation API guide](/guides/product/send-money/recipients#confirmations-contract). #### 11 Sep 2025 * Add new simulation endpoint to simulate [verify profile by id](/api-reference/simulation#verification-state-change). #### 09 Sep 2025 * Add new simulation endpoint to simulate [bank transaction import](/api-reference/simulation#bank-transaction-import). #### 08 Sep 2025 * Add `originatorLegalEntityType` field for transfer-requirements to include sender type [transfer-requirements](/api-reference/transfer#transfer-requirements). * Updated the [Transfer resource](/api-reference/transfer#object) documentation, to include the `payinSessionId` field #### 02 Sep 2025 * Update documentation for OpenBanking from v3.1 to v3.1.11 [OpenBanking](/guides/developer/open-banking). #### 26 Aug 2025 * Add `replacementDetails` field in [Card Order creation](/api-reference/card-order/cardordercreate). #### 25 Aug 2025 * Add `cardHolderProfileId` field in [Card Order creation](/api-reference/card-order/cardordercreate). #### 8 Aug 2025 * Updated [Card Issuance guide](/guides/product/issue-cards) to reflect changes in card activation. * Deprecated [complete card order](/api-reference/card-order/cardorderstatusupdate). * Deprecated `unlockSpendingPermissions` in [Card resource](/api-reference/card). #### 28 Jul 2025 * Restructured the hosted KYC guide with clearer content organization. * Updated [Hosted KYC guide](/guides/product/kyc/wise-kyc/hosted-kyc) to include Proactive trigger. #### 24 Jul 2025 * Add new [List KYC Review Items](/api-reference/simulation#hosted-journey-list-requirements) endpoint reference documentation. * Add new [Simulate KYC Review Add requirement](/api-reference/simulation#hosted-journey-add-requirement) endpoint reference documentation. * Add new [Simulate KYC Review Submit requirement](/api-reference/simulation#hosted-journey-submit-requirement) endpoint reference documentation. * Add new [Simulate KYC Review Verify requirements](/api-reference/simulation#hosted-journey-verify-requirements) endpoint reference documentation. #### 18 Jul 2025 * Updated [Get Delivery Estimate](/api-reference/delivery-estimate/deliveryestimateget) to include the new `formattedEstimatedDeliveryDate` field #### 16 Jul 2025 * Updated [Card Transactions Decline Reasons](/api-reference/card-transaction#card-transaction-decline-reasons) to include new decline reason codes #### 9 Jul 2025 * Updated [Simulate Top-Up](/api-reference/simulation#balance-top-up) to include new field (`Channel`) in request body. #### 3 Jul 2025 * Updating [verification-documents](/api-reference/profile/profileverificationdocumentcreate) to state the characters limitation in the unique identifier field. #### 30 Jun 2025 * Updating [Language Support](/guides/developer/language-support) with Danish, Norwegian and Swedish * Add new [payment-returns](/guides/product/receive-money/initiate-a-return) guide. #### 21 May 2025 * Updating the [swift-in#credit webhook](/guides/developer/webhooks/event-types#swift-in-credit) supported subscriptions #### 19 May 2025 * Updating the regions where `occupations` is required in [Create or update an address](/api-reference/address#create) and [Create a Personal Profile](/api-reference/profile/profilepersonalcreate) #### 13 May 2025 * Add new [Create Business Profile V3 (beta)](/api-reference/profile/profilebusinesscreate) endpoint reference documentation. * Add new [Get Business Representative API](/api-reference/profile/profilebusinessrepresentativeget) endpoint reference documentation. * Add new [Transfer Business Representative API](/api-reference/profile/profilebusinessrepresentativeupdate) endpoint reference documentation. * Add new [Update Business Representative API](/api-reference/profile/profilebusinessrepresentativeupdate) endpoint reference documentation. #### 8 May 2025 * Updating hosted KYC webhook trigger references information with card, proactive and bank details information #### 6 May 2025 * Merchant name and location added to the [card transaction state change webhook](/guides/developer/webhooks/event-types#card-transaction-state-change) #### 29 Apr 2025 * Adding new endpoint for US combined receipt for partners servicing US retail consumers (instead of existing receipt endpoint) which is a regulatory requirement. #### 28 Apr 2025 * Add new [Create SCA session](/api-reference/strong-customer-authentication#create-session) endpoint reference documentation. * Updated [SCA over API](/guides/developer/auth-and-security/sca-over-api) guide #### 25 Apr 2025 * Updated [swift-in test message](/guides/product/receive-money/test-and-go-live) in sandbox to accept more custom fields #### 17 Apr 2025 * Updated [Refund Recipient](/api-reference/recipient/recipientcreate) endpoint reference documentation and sample #### 10 Apr 2025 * Added new expiration related fields to [User Token Resource](/api-reference/user-tokens#object) #### 7 Apr 2025 * Updated [dispute sub status and transition diagram](/api-reference/disputes#dispute-sub-status) #### 27 Mar 2025 * The [v3 upload dispute file](/api-reference/deprecated#dispute-file-v3) endpoint will be deprecated in favor of [v4 upload dispute file](/api-reference/disputes/disputefileupload) endpoint that does not require additional permission setup for the endpoint to be accessible. * The `billingAddress` field is now changed to the `address` field. You'll still be able to send `billingAddress` in the [`/card-order`](/api-reference/card-order/cardordercreate) request, but we recommend switching to `address` as soon as possible. We'll deprecate the `billingAddress` field at a later date. #### 21 Mar 2025 * Added guide on [card kiosk collection](/guides/product/issue-cards/card-kiosk-collection#card-kiosk-collection) * Added a new section for card kiosk collection [APIs](/api-reference/card-kiosk-collection) * Added [card production simulation endpoint](/api-reference/simulation#card-production-state-change) to simulate different card production statuses * Added [`cards#card-production-status-change`](/guides/developer/webhooks/event-types#cards-card-production-status-change) webhook #### 21 Mar 2025 * Move '#update-phone-number' of 'card' to 'deprecated-api' * Updated the field description of `phone-number` in the [card object](/api-reference/card-order/cardordercreate) to indicate that it is deprecated and refer them to profile endpoints. #### 20 Mar 2025 * Renamed `triggerReference` field in [KYC Review](/api-reference/kyc-review) to `triggerReferences`. Updated the field in [KYC Review webhook](/guides/developer/webhooks/event-types#kyc-review-state-change) accordingly. #### 18 Mar 2025 * Removed `/features` page. Migrated content into [api-reference](/api-reference) pages. #### 17 Mar 2025 * Added new `includeWise` parameter to [comparison v4](/api-reference/comparison/comparisonget) #### 12 Mar 2025 * Remove `purge_timestamp` from [cards#transaction-state-change](/guides/developer/webhooks/event-types#cards-transaction-state-change) webhook. Please use `data.purge_time` instead #### 10 Mar 2025 * Added Business profile creation step to [Hosted KYC guide](/guides/product/kyc/wise-kyc/hosted-kyc#hosted-kyc-flow) #### 10 Mar 2025 * Added new [Strongly Authenticated Session Section](/guides/developer/auth-and-security/sca-over-api#sca-session). #### 6 Mar 2025 * Deprecate `purge_timestamp` and add `purge_time` in the [cards#transaction-state-change](/guides/developer/webhooks/event-types#cards-transaction-state-change) webhook. #### 4 Mar 2025 * Added a new `unlockSpendingPermissions` field to the [card object](/api-reference/card). * Added new fields `pin_validation_result`, `approval_code` and `purge_timestamp` to the [cards#transaction-state-change](/guides/developer/webhooks/event-types#cards-transaction-state-change) webhook. * Updated the guide for partner control to enable contactless and magstripe card payments, detailing suggested methods of checking that the end user has received their card. * Updated the API for [update card order status](/api-reference/card-order/cardorderstatusupdate). #### 3 Mar 2025 * Updated the [Quote API Reference](/api-reference/quote) - Corrected the price explanation id by adding plainText, so it reads `option.price.items[n].explanation.plainText` #### 26 Feb 2025 * Added `accountDetails` field to [Partner License Transfer](/api-reference/transfer#create-partner-license). #### 25 Feb 2025 * Updated [Upload Document](/api-reference/verification#upload-document) endpoint by adding `BUSINESS_AUTH_REP_PROOF_BY_AUTH_LETTER` to the list of allowed values for `documentType` field. #### 24 Feb 2025 * Updated acceptable list of transfer funding types for [`Fund a Transfer`](/api-reference/transfer#fund) endpoint. #### 18 Feb 2025 * Moved information about duplicate account handling from the reference to the appropriate integration guides. * Added the mTLS API endpoints into the [Environment](/guides/developer/environments) section. * Updated the [Updating Profiles](/guides/product/kyc/partner-kyc/updating-profiles) guide to more clearly describe how to handle profiles that are due annual review but no updates are required. #### 14 Feb 2025 * Added the optional `externalCustomerId` field to [Personal](/api-reference/profile/profilepersonalcreate) and [Business](/api-reference/profile/profilebusinesscreate) profile creation. This allows integrators to map a profile entity to a customer in their own system. #### 13 Feb 2025 * Added `accountDetails` field to [Third Party Transfer](/api-reference/transfer#create-third-party). #### 10 Feb 2025 * Updated the [comparison docs](/api-reference/comparison) with a new response field `isConsideredMidMarketRate` to show whether a provider's rate can be classified as the mid-market rate or not. #### 05 Feb 2025 * Added a new `currentState` field to the [Profile](/api-reference/profile/profile) object resource. #### 29 Jan 2025 * Updated the [comparison docs](/api-reference/comparison) with the new `/v4/comparisons` endpoint. #### 21 Jan 2025 * Published a new version (v5) of the [Upload Evidences](/api-reference/verification#upload-evidences) endpoint. #### 08 Jan 2025 * The personal token SCA documentation is no longer publicly available. Partners need to contact their CSM if they are still require access to this guide. #### 06 Jan 2025 * Added `changed_by` to the [`cards#card-status-change`](/guides/developer/webhooks/event-types#cards-card-status-change) webhook. #### 11 Dec 2024 * Updated the [International Receive webhook subscription guide](/guides/product/receive-money/subscribe-to-transfer-state-change). * Removed the V2.0.0 `swift-in-credit` webhook because it's no longer used. #### 10 Dec 2024 * Added a new endpoint to get a [Third Party Transfer](/api-reference/transfer#get-third-party-transfer-by-id) by ID. #### 5 Dec 2024 * Added a new V2 endpoint to [update business profiles](/api-reference/profile/profilebusinessupdate). * Added a new version V3.0.0 of the [bulk settlement payment received](/guides/developer/webhooks/event-types#bulk-settlement-payment-received-V3_0_0) webhook. #### 3 Dec 2024 * Added a new V2 endpoint to [update personal profiles](/api-reference/profile/profilepersonalupdate). #### 2 Dec 2024 * Added a new `balance_movements` field to the [cards#transaction-state-change](/guides/developer/webhooks/event-types#cards-transaction-state-change) webhook. #### 28 Nov 2024 * Added an update card order resource to add [Delivery Option](/api-reference/card-order). #### 24 Nov 2024 * Added new guide for [3D Secure authentication](/guides/product/issue-cards/3ds). #### 14 Nov 2024 * Updated the [Card Issuance guides](/guides/product/issue-cards) with partner control information to set a card order as `COMPLETED`. * Updated the cancel card order endpoint to an [update card order status endpoint](/api-reference/card-order/cardorderstatusupdate) (a new `COMPLETED` status can be set for certain integrations). * Updated the [permissions resource](/api-reference/card-transaction#permissions) to include the `isLocked` field. * Added a transaction decline reason `ATM_PIN_CHANGE_NOT_ALLOWED`. #### 13 Nov 2024 * Updated the [Card Issuance guides](/guides/product/issue-cards). #### 7 Nov 2024 * Added a new API to allow the [cancellation of a card order](/api-reference/card-order/cardorderstatusupdate). #### 12 Aug 2024 * Updated the APIs for [card transaction simulations](/api-reference/simulation#card-transaction-authorisation) (authorisation including refund, reversal, and clearing). #### 15 Jul 2024 * Added a new `credit` field to the [`cards#transaction-state-change`](/guides/developer/webhooks/event-types#cards-transaction-state-change) webhook. * Added a new `credit` field to the [`card transaction resource`](/api-reference/card-transaction#object). #### 27 May 2024 * Added new fields to the [`cards#transaction-state-change`](/guides/developer/webhooks/event-types#cards-transaction-state-change) webhook. #### 2 May 2024 * Added a new webhook event to allow [subscribing to dispute updates](/guides/developer/webhooks/event-types#transaction-disputes-update). #### 28 Mar 2024 * Added new APIs to allow [managing disputes](/api-reference/disputes/disputelist). #### 18 Mar 2024 * Exposed [delivery tracking details](/api-reference/card-order/cardorderget#delivery-details) if available. #### 28 Feb 2024 * Added a new API to allow [deleting card spend limits](/api-reference/spend-limits#delete-card-limits). #### 21 Feb 2024 * Added explanation for [dispute handling via API reasons](/guides/product/issue-cards/card-disputes-api). #### 24 Jan 2024 * Added explanation for [card transaction decline reason](/api-reference/card-transaction#card-transaction-decline-reasons). #### 29 Nov 2023 * Added a new API to allow [listing payment tokens](/api-reference/push-provisioning/pushprovisioningpaymenttokenslist). #### 22 Nov 2023 * Added guide on [dispute handling via API](/guides/product/issue-cards/card-disputes-api). #### 22 Nov 2023 * Added `deliveryEstimate` field to [`Card Order`](/api-reference/card-order/cardorderget). #### 20 Nov 2023 * Added a new API to add more [spend-controls](/api-reference/spend-controls) on your card transactions. #### 16 Nov 2023 * Added API guide for push provisioning. #### 27 Oct 2023 * Added an API to get a list of card transactions marked for deprecation. #### 17 Oct 2023 * Updated [card spend limits](/api-reference/spend-limits#card-limits) to support transaction limit. #### 9 Oct 2023 * Published a new version (v4) of the [`/{{cardToken}}/spend-limits`](/api-reference/spend-limits#get-spend-limits) endpoint, which has a new request/response format. #### 2 Oct 23 * The `billingAddress` field is now changed to the `address` field. You'll still be able to send `billingAddress` in the [`/card-order`](/api-reference/card-order/cardordercreate) request, but we recommend switching to `address` as soon as possible. We'll deprecate the `billingAddress` field at a later date. * Support for BR addresses is now available. #### 30 Aug 2023 * Added a new API, [`/address/validate`](/api-reference/card-order/cardordervalidateaddress). If you currently don't retrieve the address via another endpoint, please be sure to validate all addresses with the above endpoint before you send them in the [`/card-order`](/api-reference/card-order/cardordercreate) request. #### 11 Aug 2023 * Return all the possible card statuses in both the [`/status`](/api-reference/card/cardstatusupdate) API and [`cards#card-order-status-change`](/guides/developer/webhooks/event-types#cards-card-order-status-change) webhook. #### 8 Aug 2023 * Ordering a physical card over the API is now available. #### 27 Jul 2023 * Added new fields to the [`cards#transaction-state-change`](/guides/developer/webhooks/event-types#cards-transaction-state-change) webhook.