Successful requests will return a HTTP 200 response and may or may not include a response body, depending on the request endpoint.

Whenever a problem occurs, Wyre will respond to the client using a 4xx or 5xx status code. In this case, the body of the response will be an exception object which describes the problem. All
4xx status codes indicate a problem with your request, while a 5xx status code indicates an internal problem with our systems.

All exceptions come equipped with an exception ID (the exceptionId field). If you require
support, please supply this exception identifier to assist our support team in locating your issue.

The following table describes the fields included in the returned JSON exception:

Field

Description

exceptionId

A unique identifier for this exception. This is very helpful when contacting support

type

The category of the exception. See below

errorCode

A more granular specification than type

message

A human-friendly description of the problem

language

Indicates the language of the exception message

transient

In rare cases, an exception may signal true here to indicate a transient problem. This means the request can be safely re-attempted

An example JSON representation of an AccessDeniedException:

{
    "language": "en",
    "exceptionId": "TLFN89",
    "errorCode": "accessDenied.invalidSession",
    "message": "Invalid Session",
    "type": "AccessDeniedException",
    "transient": false
}

Error Types

Exception Type

Details

HTTP Status Code

ValidationException

The action failed due to problems with the request.

400

InsufficientFundsException

You requested the use of more funds in the specified currency than were available

400

AccessDeniedException

You lack sufficient privilege to perform the requested action

401

TransferException

There was a problem completing your transfer request

400

MFARequiredException

An MFA action is required to complete the request. In general you should not get this exception while using API keys

400

CustomerSupportException

Please contact us at [email protected] to resolve this!

400

NotFoundException

You referenced something that could not be located

404

RateLimitException

Your requests have exceeded your usage restrictions. Please contact us if you need this increased

429

AccountLockedException

The account has had a locked placed on it for potential fraud reasons.

The customer should contact Wyre support for follow-up.

400

LockoutException

The account or IP has been blocked due to detected malicious behavior

403

UnknownException

A problem with our services internally. This should rarely happen

500