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

July 2026

15 July

• Add new Just-in-time Funding guide for cards.
• Add data.resource.incoming_transfer_type enum to swift-in#credit webhook 4.2.0 schema version.

14 July

• Added conditional attributes field to the KYC requirement object. Certain requirement types now return additional contextual metadata.
• Attribute changes on KYC requirements now trigger a kyc-reviews#state-change webhook notification.

6 July

• Deprecated first_line in favour of address_lines in swift-in#credit webhook address properties.

1 July

• Updated Client credentials token format migration with sandbox timeline.

June 2026

22 June

• Card Orders: The address field is now optional when ordering virtual cards, but required for physical cards. See the Card address validation guide for details.

18 June

• Updated Subscribe to webhooks guide to include both subscription methods: subscribe via Developer Hub and subscribe via API.

16 June

• Revised the Send money refund guides to provide more details about refund methods, how they work, what methods apply to which funding models, and partial refunds. Also added example webhook payloads.
  • Refund to sender bank account
  • Refund to balance
  • Refund via net settlement

5 June

• New guide for Client credentials token format migration.

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.