Errors

This page contains all the possible errors one can receive from the API and the situations in which they occur

Keep in mind that you can receive errors described in SDK Errors and Web-Library Errors on top of the one listed here. The errors described here are thrown only from the from LimePay's API.

Authorization Errors

Error Name

Code

Message

Description

Occurence

AUTHORIZATION_ERROR

1011

Token is not provided

You are required to provide Lime Pay token for authorization where it is applicable

Accessing resources which require token authorization

AUTHORIZATION_ERROR

1012

Invalid token provided

You will get this error if the token provided is invalid

Accessing resources which require token authorization

AUTHORIZATION_ERROR

1111

Unauthorized request

You will get this error if your non-token authorization fails

Accessing resources which require non-token authorization

Blockchain Errors

Error Name

Code

Message

Description

Occurence

BLOCKCHAIN_ERROR

2001

Insufficient token amount in escrow contract

You will get this error if your organization's escrow contract does not have enough tokens to fund a shopper

Processing payment

BLOCKCHAIN_ERROR

2002

Insufficient wei amount in escrow contract

You will get this error if your organisation's escrow contract does not have enough wei to fund a shopper

Processing payment

BLOCKCHAIN_ERROR

2111

Invalid gas limit

You will get this error if the gas limit of a signed transaction does not match the provided gas limit on payment creation

Processing payment

BLOCKCHAIN_ERROR

2112

Invalid receiver

You will get this error if the to address of a signed transaction does not match the provided to address on payment creation

Processing payment

BLOCKCHAIN_ERROR

2113

Invalid gas price

You will get this error if the gas priceof a signed transaction does not match the provided gas price on payment creation

Processing payment

BLOCKCHAIN_ERROR

2114

Method ID/function signature mismatch

You will get this error if a shopper signs different function from the one provided on payment creation

Processing payment

BLOCKCHAIN_ERROR

2115

Function params does not match

You will get this error if a shopper signs a function with different parameter/s from the corresponding one that was provided on payment creation

Processing payment

BLOCKCHAIN_ERROR

2116

Array of signed transactions must be provided

You are required to provide signed transactions in order to process fiat/relayed payment

Processing payment

BLOCKCHAIN_ERROR

2117

Invalid number of signed transactions

The number of signed transactions must be the same as the number of generic transactions provided on payment creation

Processing payment

BLOCKCHAIN_ERROR

2118

Invalid signer. The transactions were not signed by the Shopper's private key

The signer of the transactions (his public address) should be equal to the shopper's walletAddress

Processing payment

BLOCKCHAIN_ERROR

2119

Cannot decode generic transaction data!

You will get this error if a provided signed transaction is not valid or the parameter types provided on payment creation are not valid

Processing payment

BLOCKCHAIN_ERROR

2211

Invalid signer. The Authorization signature is not signed by signer's wallet

You will get this error if the provided authorization signature for the funding of the shopper is not signed by a signer of the Escrow contract that is deployed for you organization

Creating payment

BLOCKCHAIN_ERROR

2212

{authorizationSignature} is not a valid authorization signature

You will get this error if the provided authorization signature for the funding of the shopper does not have the correct format

Creating payment

Not Found Errors

Error Name

Code

Message

Description

Occurence

NOT_FOUND_ERROR

3010

Payment was not found

The requested payment does not exist

Getting payment

NOT_FOUND_ERROR

3011

Payment document was not found

You will get this error if you try to preview invoice/receipt or send invoice for a payment which is not successful

Preview invoice/receipt / send invoice

NOT_FOUND_ERROR

3012

Vendor was not found

The requested vendor does not exist

Getting vendor

NOT_FOUND_ERROR

3013

Shopper was not found

The requested shopper does not exist

Getting shopper

NOT_FOUND_ERROR

3014

API User was not found!

The requested API user does not exist

Getting api user

NOT_FOUND_ERROR

3015

User was not found

The requested user does not exist

Getting user

NOT_FOUND_ERROR

3018

The record you have searched for does not exists

You will get this error if your searching criteria is invalid

Every time we cannot parse searching criteria

Validation Errors

Error Name

Code

Message

Description

Occurence

VALIDATION_ERROR

4011

Invalid property {property}! {property} cannot be null, empty or whitespace

You will get this error when you do not provide a required property in the request

Everywhere where there is request body with required properties

VALIDATION_ERROR

4012

Missing {request body object} data

You will get this error when you do not provide a required object in the request

Everywhere where there is request body with required objects

VALIDATION_ERROR

4013

Property {property}should be an array of objects

You will get this error when a property is array of objects, but you provide something different

Everywhere where there is request body with array of objects type properties

VALIDATION_ERROR

4111

Nonexistent country code

You will get this error if you pass non-existing country code to Vendor, CardHolderInformation

Processing Fiat payment / calculating VAT

VALIDATION_ERROR

4211

(Input property) should be true/false

You will get this error if you pass non-boolean value to a property which is required to be boolean

Processing payment

VALIDATION_ERROR

4311

WeiAmount must have non-zero value

You will get this error if your fundTx.weiAmount is zero

Creating payment

VALIDATION_ERROR

4411

Vat number {vat number here} is invalid

You will get this error if you pass invalid VAT number in CardHolderInformation

Creating vendor / Processing Fiat payment

VALIDATION_ERROR

4412

Vat number is empty

You will get this error if you have vat number as property in CardHolderInformation, but it does not have a value

Creating vendor / Processing Fiat payment

VALIDATION_ERROR

4413

{vat rate} is not a valid VAR rate for your country

You will get this error if you have provided an invalid REDUCED vat rate

Calculating the VAT for a fiat payment/processing payment with a reduced vat rate

VALIDATION_ERROR

4212

[{some property}] should be Number

You will get this error if you have provided reduced vat rate that was not number

Calculating the VAT for a fiat payment/processing payment with a reduced vat rate

VALIDATION_ERROR

4501

API user credentials limit has been exceeded, limit is 3

You will get this error if you try to create more than 3 API Credentials

Creating API Credentials

Global Errors

Error Name

Code

Message

Description

Occurence

INTERNAL_SERVER_ERROR

5001

Something went wrong. Contact your support for more information

General error

-

BAD_REQUEST_ERROR

5111

Bad request

You will get this error if you pass wrong input parameter

Every time bad input is passed

REQUESTS_RATE_LIMIT_ERROR

5211

Too many requests, please try again later.

You will get this error if you exceed LimePay API rate limit

Every time rate limit is exceeded

Payment Errors

Error Name

Code

Message

Description

Occurence

PAYMENT_ERROR

6001

Signature metadata for Payment cannot be retrieved

If your escrow contract is version 1 (by default all of them are version 2), you will get this error when you execute get signature metadata

Getting signature metadata for payment

PAYMENT_ERROR

6011

Payment has already been processed

You are allowed to create a payment and process it, but not re-process it

Processing payment

PAYMENT_ERROR

6012

Payment can't be processed, because shopper is malicious

You will get this error if a shopper is flagged as malicious one. You need to contact support once this error occurs

Processing payment

PAYMENT_ERROR

6111

Payment can't be created, while another one is in processing state

You will get this error if you try to create new payment for a shopper, while another one is in processing state

Creating payment

PAYMENT_ERROR

6112

Invalid payment amount

The Payment's amount must be bigger than 1 USD

Creating payment

PAYMENT_ERROR

6113

Transactions with the given currency are not allowed

The provided currency is not supported

Creating payment

PAYMENT_ERROR

6201

Cannot get payment token

You will get this error if for some reason you cannot get Payment Token. In this case contact support!

Retrieving payment token

May Vary

6401

{payment transaction error}

You will get this error if LimePay's Payment Provider cannot process the payment for some reason. Possible Values for Error name are: INVALID_AMOUNT, PAYMENT_GENERAL_FAILURE, VALIDATION_GENERAL_FAILURE, XSS_EXCEPTION, THREE_D_SECURITY_AUTHENTICATION_REQUIRED, AUTHORIZATION_AMOUNT_NOT_VALID, CVV_ERROR, EXPIRED_CARD, HIGH_RISK_ERROR, INCORRECT_INFORMATION, INSUFFICIENT_FUNDS, INVALID_CARD_NUMBER, INVALID_CARD_TYPE, LIMIT_EXCEEDED, RESTRICTED_CARD, THREE_D_SECURE_FAILURE

Processing Fiat payment

Shopper Errors

Error Name

Code

Message

Description

Occurence

SHOPPER_ERROR

10011

Shopper is invalid

You will get this error if you try to create a payment for invalid shopper

Creating payment

SHOPPER_ERROR

10021

Cannot update the wallet of a Shopper that is using LimePay powered Wallet

You will get this error if you try to update a Shopper's walletAddressbut the shopper uses LimePay powered wallet

Updating Shopper

SHOPPER_ERROR

10031

Cannot get Encrypted wallet for Shopper that is not using LimePay powered wallet

You will get this error if you try to get/save/change the Encrypted Wallet of a Shopper that do not use LimePay powered wallets

GET/CREATE/Change the encrypted Wallet of a shopper

SHOPPER_ERROR

10041

No Wallet is saved for the requested shopper. Create the wallet first

You will get this error if you try to create a payment, get or change the encrypted wallet of a Shopper that does not have LimePay powered wallet yet

Create Payment, GET Encrypted Wallet, Change the password of a Encrypted wallet

SHOPPER_ERROR

10051

Shopper already has LimePay powered wallet

When you try to create Encrypted Wallet for a Shopper that already has one

Create Encrypted Wallet for a Shopper

SHOPPER_ERROR

10061

Invalid mnemonic was provided

When you want to change the password of a Encrypted Wallet for a Shopper and you provide wrong mnemonic

Change the password of a encrypted wallet