> ## Documentation Index
> Fetch the complete documentation index at: https://developers.orchestrasolutions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> API and platform updates for Orchestra developers.

## February 16, 2026

### New: Gateway failover with `fallbackUpgs`

`POST /PaymentGateway/charge` now accepts an optional `fallbackUpgs` array. If the primary gateway rejects the charge, Orchestra retries automatically through each gateway in the list in order, stopping at the first success.

```json theme={null}
{
  "paymentGatewayAccountName": "primary-gateway",
  "fallbackUpgs": [
    { "paymentGatewayAccountName": "backup-gateway-1" },
    { "paymentGatewayAccountName": "backup-gateway-2" }
  ],
  "amount": 49.99,
  "currency": "USD",
  "card": "cardToken"
}
```

No changes required if you don't use failover. See the [multi-gateway failover guide](/guides/rest-api/multi-gateway-failover) for details.

***

## February 4, 2026

### New: eWallet Accounts can now be edited

eWallet Accounts (PayPal, BankPay, UPI, and CardPay credentials) can now be updated through the portal. Previously, the only way to change an account's settings was to delete it and re-create it.

***

## January 23, 2026

### New: Client Certificate support in eWallet sessions

`POST /EWalletOperations` now accepts an optional `clientCertificate` parameter. This allows Orchestra to authenticate with your payment gateway using a client certificate during the charge flow.

The parameter is supported at the root level and inside each entry of the `fallbackUpgs` array:

```json theme={null}
{
  "operation": "CHARGE",
  "paymentGatewayAccountId": "my-gateway",
  "clientCertificate": "base64-encoded-cert",
  "fallbackUpgs": [
    {
      "paymentGatewayAccountId": "backup-gateway",
      "clientCertificate": "base64-encoded-cert-2"
    }
  ]
}
```

### New: Mock Credential Provider

A mock credential service is now available for testing environments. It returns card-like payment tokens without requiring real payment gateway credentials, making it easier to test the full integration flow before going live.

See the [mock PSPs guide](/guides/utilities/mock-psps) for setup instructions.

### New: Mock gateways support 3DS flow

The built-in mock payment gateways now support the full 3-D Secure authentication flow. You can use them to test the CardPay 3DS scenario end-to-end in dev and QA environments without a live gateway connection.

### Fix: 400 error response schema corrected

The `400 Bad Request` response was incorrectly documented in the API spec as a single `ValidationErrorMessage` object. It now correctly reflects the actual response: an array of `ValidationErrorMessage` objects. No runtime behavior changed - this was a documentation-only correction.

### Update: Developer portal URLs migrated to orchestrasolutions.com

Account activation and registration emails now link to `orchestrasolutions.com`. The previous `epaytools.com` domain is no longer used.