# Changelog

## 2026-05-04

#### Changed

- **`mobileNumber` now optional on KYC token share** — Previously required on `POST /v2/identities/token/share`. Note: Interac (Canada) requires a mobile number — if not provided, Banxa collects it from the customer during checkout.


## 2026-02-08

#### Added

- **`partnerFee` in Quote and Order responses** — Provides direct visibility of partner fees during pricing and reconciliation.
- **KYC token sharing via Sumsub** — Now supported via `POST /v2/identities/token/share`.


#### Improved

- **Webhook payloads** — Now include full order context for the Legacy API and Hosted Checkout, removing the need for a follow-up Get Order call for common reporting and reconciliation use cases.


## 2025-05-08

#### Improved

- **Create Identities: Base64-encoded images** — Now accepted in addition to secure HTTPS image links.


## 2025-01-08

#### Added

- **Automated webhook retries** — If Banxa does not receive a `200 OK` response, the webhook is automatically retried. The payload remains unchanged across retry attempts.


## 2024-05-08

#### Added

- **`contract_id` in Get Coins and Get Order(s) responses** — Supports additional reporting on cryptocurrency/blockchain smart contract values.


#### Improved

- **Webhooks Version 2** — Webhooks are now sent for all order status transitions. Payloads include full order context — no follow-up Get Order call required.


## 2024-01-08

#### Added

- **Discount code support** — Available via Get Prices and Create Order endpoints. Commission rate can now be adjusted on a per-quote or per-order basis.
- **`X-Request-Id` response header** — Included in all Banxa API responses. Use this value when troubleshooting with Banxa support.


#### Improved

- **Referral integration theme customisation** — New URL parameters: `theme`, `primaryColor`, `secondaryColor`, `backgroundColor`, `textColor`.