RippleNet Server error codes

This document provides a list of error messages that RippleNet Server returns if it encounters a problem.

Developers and architects may find this useful for designing integration logic. Administrators and other users may find this useful for troubleshooting.

The error codes on this page represent service-level errors. For payment exception handling when building out your middleware, see Returns and failure codes

Error groups

AUTH ("A", "auth") CONFIGURATION ("C", "configuration") ERROR ("E", "error") FEES ("F", "fees") LEDGER ("L", "ledger") PAYMENTS ("PY", "payments") QUOTING ("Q", "quoting") RATES ("R", "rates") RIPPLENET ("RN", "ripplenet") VALIDATOR ("V", "validator") XCURRENT ("XC", "xcurrent")

Auth errors

Error code	Error message
A0110	`NOT_AUTHORIZED_ERROR`
A0151	`LOCK_USER`
A0155	`LOCK_CLIENT_ID`
A0156	`OAUTH_TOKEN_ENCRYPTION_ERROR`
A0160	`RIPPLENET_MAX_CONCURRENT_SESSIONS_ERROR_CODE`

Configuration errors

Error code	Error message
C0001	`PAYOUT_METHOD_NOT_FOUND`
C0002	`PAYOUT_METHOD_ALREADY_EXISTS`
C0109	`USER_NOT_FOUND_ERROR`
C0111	`UI_ERROR`
C0116	`NO_SYSTEM_CONFIGURATION_FOUND`
C0154	`CLIENT_ID_NOT_FOUND_ERROR`

"Error" errors

Error code	Error message
E0101	`RESOURCE_NOT_FOUND_PROBLEM`
E0104	`JSON_PROCESSING_PROBLEM`
E0120	`BAD_REQUEST_PROBLEM`
E0149	`JSON_MALFORMED_PROBLEM`
E0150	`INTERNAL_SERVER_PROBLEM`
E0154	`HTTP_CLIENT_ERROR`

Fees errors

Error code	Error message
F0001	`INVALID_CURRENCY`
F0002	`INVALID_FEE_VALUE`
F0003	`INVALID_FEE_LIMIT`
F0004	`FEE_LIMIT_OVERLAP`
F0005	`INVALID_FEE_ID`
F0006	`MISSING_FEE_ID`
F0007	`FEE_NOT_FOUND`
F0008	`INVALID_PAYOUT_METHOD`

Ledger errors

Error code	Error message
L0000	`ACCOUNT_NOT_FOUND`
L0001	`MIN_BALANCE_VIOLATION`
L0002	`MAX_BALANCE_VIOLATION`
L0003	`INVALID_BALANCE_LIMIT`
L0004	`MIN_MAX_BALANCE_VIOLATION`
L0005	`INVALID_ROUNDING_MODE_FOR_ACCOUNT`
L0006	`INVALID_ROLLBACK_ACTION`
L0007	`INVALID_TRANSACTION_TYPE`
L0008	`INVALID_TRANSACTION`
L0010	`INVALID_ACCOUNT_NAME`
L0011	`MISSING_RIPPLENET_ACCOUNT_TYPE`
L0012	`INVALID_ACCOUNT_SCALE`
L0013	`DISABLED_ACCOUNT`

Payments errors

Error code	Error message
PY0001	`PAYMENT_NOT_FOUND`
PY0002	`TRANSFER_NOT_FOUND`
PY0003	`OBJECT_MAPPER_ERROR`
PY0004	`INVALID_SENDER_ERROR`
PY0005	`INVALID_RECEIVER_ERROR`
PY0006	`CONTRACT_VALIDATION_ERROR`
PY0007	`NO_LABLES_ERROR`
PY0010	`INVALID_RETURN_PAYMENT_REQUEST`
PY0012	`QUOTE_INELIGIBLE_TO_ACCEPT`
PY0013	`INVALID_SCALE`
PY0014	`INVALID_ACCOUNT`
PY0015	`TRANSFER_INITIATOR_NOT_OWNER`
PY0016	`INVALID_GET_PAYMENTS_REQUEST`
PY0017	`CANNOT_SAVE_MULTIPLE_RN_INFO_OF_SAME_TYPE`
PY0020	`RIPPLE_NET_INFO_VALUE_TOO_LARGE`
PY0022	`INVALID_EXCHANGE_TRANSFER_REQUEST_PROBLEM`
PY0023	`INVALID_REQUESTS_FOR_PAYMENT_REQUEST_PROBLEM`
PY0024	`INVALID_QUOTE_HOP_USAGE_REPRORT_PROBLEM`
PY0025	`INVALID_TRANSFER_ACTION_PROBLEM`
PY0026	`QUOTE_EXPIRY_NOT_FOUND`
PY0027	`QUOTE_EXPIRY_ALREADY_EXISTS`
PY0030	`EXCHANGE_TRANSFER_INITIATOR_NOT_OWNER`

Quoting errors

Error code	Error message
Q0010	`UNABLE_TO_CALCULATE`
Q0011	`QUOTE_NOT_FOUND`
Q0012	`INVALID_SCALE_IN_QUOTED_ACCOUNT`
Q0013	`INVALID_ACCOUNT_IN_QUOTE`
Q0015	`MISSING_REQUIRED_FIELD`
Q0017	`UNABLE_TO_RETRIEVE_PREVIOUS_HOP`
Q0018	`RATE_NOT_FOUND`
Q0019	`INVALID_QUOTE_TYPE`

Rates errors

Error code	Error message
R0001	`INVALID_RATE_LIMIT`
R0002	`RATE_LIMIT_OVERLAP`
R0003	`INVALID_RATE_ID`
R0004	`SAME_BASE_COUNTER_CURRENCY_CODES`
R0005	`NEGATIVE_RATE`

RippleNet errors

Error code	Error message
RN0000	`UNAUTHORIZED`
RN0001	`INVALID_SENDING_AMOUNT`
RN0002	`INVALID_SENDING_FEE`
RN0003	`INVALID_RECEIVING_AMOUNT`
RN0004	`INVALID_RECEIVING_FEE`
RN0005	`INVALID_QUOTE_ID`
RN0006	`INVALID_FX_RATE`
RN0007	`INVALID_BASE_CURRENCY`
RN0008	`INVALID_COUNTER_CURRENCY`
RN0009	`INVALID_RATE_TYPE`
RN0010	`UNABLE_TO_CALCULATE`
RN0011	`NO_QUOTE_PATH_FOUND`
RN0012	`PAYMENT_NOT_FOUND`
RN0013	`MESSAGE_PARSE_ERROR`
RN0014	`MESSAGE_BODY_EMPTY`
RN0015	`VALUE_SERIALIZATION_ERROR`
RN0016	`UNAUTHORIZED_PAYMENT_STATE_ERROR`
RN0017	`ILLEGAL_PAYMENT_STATE_ERROR`
RN0018	`EXECUTION_FULFILLMENT_SIGNATURE_ERROR`
RN0019	`OBJECT_MAPPER_ERROR`
RN0020	`KEYSTORE_LOADING_ERROR`
RN0021	`INVALID_LIQUIDITY_RELATIONSHIP_ERROR`
RN0022	`PAYMENT_EXECUTION_ERROR`
RN0023	`SERVER_ERROR`
RN0024	`MESSAGE_MISSING_FIELDS_ERROR`
RN0025	`PEER_NOT_FOUND`
RN0026	`LIQUIDITY_PATH_ERROR`
RN0027	`SETTLEMENT_EXECUTION_ERROR`
RN0028	`INVALID_PAYMENT`
RN0029	`INVALID_MESSAGE`
RN0030	`PIPELINE_PROCESSING_PROBLEM`
RN0031	`PAYMENT_QUOTE_EXPIRED_PROBLEM`
RN0032	`PAYMENT_EXPIRED_PROBLEM`
RN0033	`REQUEST_FOR_PAYMENT_NOT_FOUND_PROBLEM`
RN0034	`REQUEST_FOR_PAYMENT_PROBLEM`
RN0035	`RIPPLENET_CLIENT_HTTP_ERROR`
RN0036	`RIPPLENET_CLIENT_IO_ERROR`
RN0037	`REQUEST_FOR_PAYMENT_PATH_FINDING_ERROR`
RN0038	`INVALID_CONTRACT_HASH_PROBLEM`
RN0039	`INVALID_FAIL_PAYMENT_REQUEST`
RN0040	`INVALID_QUOTE_ELEMENT`
RN0041	`CANCELLATION_FULFILLMENT_SIGNATURE_ERROR`
RN0100	`MESSAGE_PARSE_ERROR`
RN0101	`MESSAGE_BODY_EMPTY_ERROR`
RN0102	`INVALID_ACTION_ERROR`
RN0103	`VALUE_SERIALIZATION_ERROR`
RN0104	`JSON_PROCESSING_ERROR`
RN0105	`UNEXPECTED_PIPELINE_ERROR`
RN0106	`WEAK_PASSWORD_ERROR`
RN0107	`CRYPTO_TRANSACTION_NOT_FOUND_IN_MESSAGE_ERROR`
RN0108	`CRYPTO_TRANSACTION_NOT_FOUND_IN_VALIDATOR_ERROR`
RN0111	`UI_ERROR`
RN0112	`USER_DISABLED`
RN0113	`EXECUTION_FULFILLMENT_SIGNATURE_ERROR`
RN0114	`UNABLE_TO_FIND_PATH_ERROR`
RN0115	`CRYPTO_TRANSACTION_STATE_INVALID_ERROR`
RN0116	`QUOTE_INELIGIBLE_TO_ACCEPT`
RN0117	`INVALID_RETURN_PAYMENT_REQUEST`
RN0118	`CRYPTO_TRANSACTION_PROBLEM`
RN0119	`QUOTING_PROBLEM`
RN0120	`UNKNOWN_RIPPLENET_SETTLEMENT_PROBLEM`
RN0121	`CRYPTO_TRANSACTION_EXPIRED_OR_CANCELED`
RN0122	`INVALID_CRYPTO_TRANSACTION`
RN0123	`MALFORMED_RESPONSE_MESSAGE`
RN0124	`INVALID_LIQUIDITY_RELATIONSHIP_PROBLEM`
RN0125	`LIQUIDITY_RELATIONSHIP_NOT_FOUND_PROBLEM`
RN0126	`LIQUIDITY_PATH_NOT_FOUND_PROBLEM`
RN0127	`INVALID_ACCOUNT_PROBLEM`
RN0128	`INVALID_LIQUIDITY_PATH_PROBLEM`
RN0129	`INVALID_TRANSFER_STATE_PROBLEM`
RN0130	`CRYPTO_TRANSACTION_ID_MISSING`
RN0131	`INVALID_OR_MISSING_MESSAGE_VALUE`
RN0132	`INVALID_PAYMENT_METHOD_PROBLEM`
RN0133	`ASYNC_MESSAGE_PROCESSING_PROBLEM`
RN0134	`REQUEST_WAIT_TIMEOUT_PROBLEM`
RN0135	`MESSAGE_FLOW_NOT_FOUND_PROBLEM`
RN0136	`ROUTE_COLLECTION_NOT_FOUND_PROBLEM`
RN0137	`JMS_EXCEPTION_PROBLEM`
RN0139	`INVALID_TRANSFER_REQUEST_PROBLEM`
RN0140	`INVALID_PUBLIC_KEY_PROBLEM`
RN0140	`REMOTE_ACCOUNT_UPDATE_PROBLEM`
RN0141	`INVALID_ACCOUNT_AMOUNT_PROBLEM`
RN0142	`DUPLICATE_ACCOUNT_PROBLEM`
RN0142	`GENERIC_INVALID_QUOTE_PROBLEM`
RN0143	`ACCOUNT_CREATION_PROBLEM`
RN0144	`ACCOUNT_UPDATE_PROBLEM`
RN0145	`GENERIC_INVALID_PAYMENT_PROBLEM`
RN0145	`STATEMENT_DATA_ERROR`
RN0146	`REMOTE_ACCOUNT_STATEMENT_PROBLEM`
RN0147	`REMOTE_HOST_CONNECTION_PROBLEM`
RN0153	`LIQUIDITY_PATH_INVALID_OPERATION_PROBLEM`
RN0302	`PAYMENT_RESTART_INCOMPATIBLE_ENTITY_STATE_PROLEM`
RN0303	`UUID_PARAMETER_INVALID_PROBLEM`
RN0304	`DATE_PARAMETER_INVALID_PROBLEM`
RN9999	`UNKNOWN`

Validator errors

Error code	Error message
V0001	`CRYPTO_TX_ID_INVALID`
V0002	`CRYPTO_TX_EXISTS`
V0003	`CRYPTO_TX_COST_TOO_HIGH`
V0004	`FULFILLMENT_REQUIRED`
V0005	`CRYPTO_TX_FINALIZED`
V0010	`INVALID_EXECUTION_FULFILLMENT`
V0011	`INVALID_CANCELLATION_FULFILLMENT`
V0012	`CRYPTO_TX_EXPIRED`
V0020	`CRYPTO_TX_NOT_FOUND`

"xCurrent" errors

Error code	Error message
XC0100	`MESSAGE_PARSE_ERROR`
XC0132	`REMOTE_RESPONSE_SERIALISATION_PROBLEM`
XC0133	`USAGE_REPORT_REQUEST_PROBLEM`
XC0135	`USAGE_REPORT_SEND_PROBLEM`
XC0139	`ROUTING_ERROR_IN_PIPELINE`
XC0147	`INVALID_LEDGER_CLIENT_REQUEST_PROBLEM`
XC0150	`INTERNAL_SERVER_PROBLEM`
XC0157	`INVALID_SYSTEM_SETTINGS`
XC0158	`USAGE_REPORT_GENERATION_PROBLEM`
XC0159	`NO_MAIL_SERVER_CONFIGURED_PROBLEM`