# Changelog ## May 2026 ### 27 May - New guide for [Subscribing to webhooks](/guides/developer/webhooks/subscribe-to-webhooks) - New guide for [Viewing and Retrying webhooks](/guides/developer/webhooks/view-retry-events) - New guides for [Recipient verification](/guides/product/send-money/recipient-verification) and currency-specific guides for currencies that support additional recipient account verification checks: - [CNY recipient verification](/guides/product/send-money/recipient-verification/cny-verification) - [IDR recipient verification](/guides/product/send-money/recipient-verification/idr-verification) - [INR recipient verification](/guides/product/send-money/recipient-verification/inr-verification) - [KRW recipient verification](/guides/product/send-money/recipient-verification/krw-verification) ### 18 May - Improve consistency regarding KYC review fields across the documentation. - Document correct return response from the KYC review endpoints - Improve wording in the [Update KYC review endpoint](/api-reference/kyc-review/kycreviewredirecturlupdate) ### 14 May - Add `instructedAmount` and `instructedCurrencyCode` fields to [swift-in simulation endpoint](/guides/product/receive-money/test-and-go-live) ### 12 May - Added a new value `VERIFIED` to the [KYC requirement state](/api-reference/kyc-review/kyc-requirement). This value will be returned in the webhook and API response if the requirement was submitted and verified on our side. - Added new [transfer payout failure simulation](/api-reference/simulation/simulationtransferpayoutfailure) endpoint. Triggers [transfers#payout-failure webhook](/guides/developer/webhooks/event-types#transfer-payout-failure) in Sandbox. ### 11 May - Added sandbox support for [transfer refund webhooks](/api-reference/simulation/simulationtransferstatechange#sandbox-refund). Simulating `funds_refunded` now triggers a `transfers#refund` webhook with a simulated refund amount. ### 8 May - Add `bank_details` fields within `recipient` and `sender` to [swift-in#credit webhook](/api-reference/webhook-event/eventswiftincredit) ### 6 May - Update copy in [Get Wise JOSE public key](/api-reference/jose/joseresponsepublickeysget) to accomodate both JWS + JWE. ### 4 May - Add `data.requested_by_customer` field to [profiles#state-change webhook](/guides/developer/webhooks/event-types#profiles-state-change) ## April 2026 ### 21 April - New guide for [JOSE JWS Key Rotation](/guides/developer/auth-and-security/jose/jose-jws-key-rotation). ### 20 April * New guide for [API and hybrid customer onboarding](/guides/product/kyc/wise-kyc/api-hybrid-kyc) for embedded partners. * Significant updates to the [introduction to Wise-performed KYC](/guides/product/kyc/wise-kyc) and [Hosted customer onboarding](/guides/product/kyc/wise-kyc/hosted-kyc) guides. Provides more in-depth details about available customer onboarding methods and instructions for using the Wise-hosted method. ## 13 April * Add structured addresses and `previous_instructing_agents` in [swift-in#credit](/api-reference/webhook-event/eventswiftincredit) webhook v4.0.0. ## 9 April * Add `keyId` field to [Get Wise public signing key](/api-reference/jose/joseresponsepublickeysget) endpoint. * Documented global `X-External-Correlation-Id` header on all API operations. See [correlation ID guide](/guides/developer/headers/correlation-id). * Documented global `x-trace-id` header on all API operations. * Documented `429 Too Many Requests` response with `Retry-After` and `X-Rate-Limited-By` headers on all API operations. ## March 2026 ### 31 March * Consolidated Client Credentials Token and User Tokens into a single [OAuth Token](/api-reference/oauth-token) endpoint ### 30 March * Updated [Auth and Security guide](/guides/developer/auth-and-security) * New [OAuth 2.0 setup guide](/guides/developer/auth-and-security/oauth-2-setup) * New [Client credentials tokens guide](/guides/developer/auth-and-security/client-credentials-token) * New [User access tokens guide](/guides/developer/auth-and-security/user-access-token) * New [Refresh tokens guide](/guides/developer/auth-and-security/refresh-tokens) ### 26 March * Rename `Push Provisioning` api reference section to `Digital Wallet` * Update [digital wallet guide](/guides/product/issue-cards/card-digital-wallet) * Add [payment token activation endpoint](/api-reference/digital-wallet/digitalwalletactivatepaymenttoken) to activate a card payment token for manual provisioning * Add [cards#manual-provisioning-verification](/api-reference/webhook-event/eventcardsmanualprovisioningverification) webhook ### 18 March * Add new [Event Ordering](/guides/developer/webhooks/event-ordering) guide. Webhook events may not be delivered in the order they occurred — this guide explains how to use ordering fields to reconcile the correct sequence. * Add schema version `4.0.0` for all [webhook event types](/guides/developer/webhooks/event-types). This version provides consistent millisecond-precision timestamps across all events, making it easier to determine event order. We recommend updating your [subscriptions](/api-reference/webhook) to use `4.0.0` to order events reliably. ### 12 March * Add [guide](/guides/developer/headers/correlation-id) for `X-External-Correlation-Id` header usage * Update error codes for [verify PIN](/api-reference/sca-pin/scapinverify) and [verify device fingerprint](/api-reference/sca-device-fingerprints/scadevicefingerprintverify) endpoints ### 9 March * 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 March * Add fees and previous instructing agent in [swift-in simulation endpoint](/guides/product/receive-money/test-and-go-live) ## February 2026 ### 26 February * Add details for submitting Tax Residency Kyc Requirement [KYC Requirement Submit](/api-reference/kyc-review/kycreviewrequirementsubmit) ### 20 February * Adds support for providing the following on originators of third-party transfers * `nationality`: for `PRIVATE` originators * `businessRegistrationDate`: for `BUSINESS` originators ## January 2026 ### 15 January * 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.