Changelog

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

June 2026

5 June

• New guide for Client credentials token format migration guide.

May 2026

27 May

• New guide for Subscribing to webhooks
• New guide for Viewing and Retrying webhooks
• New guides for Recipient verification and currency-specific guides for currencies that support additional recipient account verification checks:
  • CNY recipient verification
  • IDR recipient verification
  • INR recipient verification
  • KRW recipient 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

14 May

• Add instructedAmount and instructedCurrencyCode fields to swift-in simulation endpoint

12 May

• Added a new value VERIFIED to the KYC requirement state. 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 endpoint. Triggers transfers#payout-failure webhook in Sandbox.

11 May

• Added sandbox support for transfer refund webhooks. 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

6 May

• Update copy in Get Wise JOSE public key to accomodate both JWS + JWE.

4 May

• Add data.requested_by_customer field to profiles#state-change webhook

April 2026

21 April

• New guide for JOSE JWS Key Rotation.

20 April

• New guide for API and hybrid customer onboarding for embedded partners.
• Significant updates to the introduction to Wise-performed KYC and Hosted customer onboarding 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 webhook v4.0.0.

9 April

• Add keyId field to Get Wise public signing key endpoint.
• Documented global X-External-Correlation-Id header on all API operations. See correlation ID guide.
• 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 endpoint

30 March

• Updated Auth and Security guide
• New OAuth 2.0 setup guide
• New Client credentials tokens guide
• New User access tokens guide
• New Refresh tokens guide

26 March

• Rename Push Provisioning api reference section to Digital Wallet
• Update digital wallet guide
• Add payment token activation endpoint to activate a card payment token for manual provisioning
• Add cards#manual-provisioning-verification webhook

18 March

• Add new 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. This version provides consistent millisecond-precision timestamps across all events, making it easier to determine event order. We recommend updating your subscriptions to use 4.0.0 to order events reliably.

12 March

• Add guide for X-External-Correlation-Id header usage
• Update error codes for verify PIN and verify device fingerprint endpoints

9 March

• Add relayed authorisation guide to card issuance
• Update card transaction api to include relayed authorisation data
• Update card transaction webhook to include relayed authorisation data

3 March

• Add fees and previous instructing agent in swift-in simulation endpoint

February 2026

26 February

• Add details for submitting Tax Residency Kyc Requirement KYC Requirement Submit

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 for all updated fields and endpoints.