Below is a list of possible error codes returned by Paynova's API. Please note that error codes may be added from time-to-time, so take care to ensure that your implementation can handle new/unexpected error codes. An operation that returns an error number other than "0" (SUCCESS or PENDING) should be considered a failed operation.
Error number
Status Code
Status Message
0
SUCCESS
The operation was successful.
0
PENDING
The operation is pending.
Conditions:
> Only applicable to mobile payments.
Service Errors
-1
INTERNAL_ERROR
The specified operation could not be completed at this time; please try your request again later. If the problem persists, please contact Paynova's merchant support at [email protected].
-2
VALIDATION_ERROR
-3
HTTP_###
Our API uses standard HTTP error codes to convey errors such as authentication errors. The status code will contain HTTP_ followed by the HTTP error number (e.g. HTTP_401) and the status message will contain information applicable to the type of error. If you receive this error, the HTTP status code will also be sent back in the HTTP response.
Account Errors
1000
MERCHANT_ACCT_READ_ONLY
The merchant account is currently read-only. This operation requires an active account.
1001
CUST_ACCT_NOT_ELIGIBLE
The customer's account is currently not eligible to make payments.
1002
Profile Errors
2000
CUST_PROF_NOT_FOUND
The specified customer profile was not found.
2001
CUST_CARD_NOT_FOUND
The specified profile card was not found in the customer's profile.
Order & Payment Errors
3000
ORDER_NOT_FOUND
The specified order was not found.
3001
LINE_ITEMS_NOT_ALLOWED
You are not allowed to specify line items for this request because no line items were specified in the original order (simple order).
3002
FINALIZE_AMT_EXCEEDED
The total amount you have specified in your finalize call is greater than the available balance to finalize. Existing annulments and finalizations which are in a pending state also count against the available balance.
3003
LINE_ITEMS_REQUIRED
This operation requires that line items be specified for detailed orders when the total amount specified does not equal the original order total amount.
3004
ORDER_ANNULLED
The operation cannot be completed because the order is currently in an annulled state.
3005
ORDER_COMPLETED
The operation cannot be completed because the order is currently in a completed state.
3006
PAYMENT_NOT_FOUND
The specified payment could not be found for the given order.
3007
PAYMENT_COMPLETED
The operation cannot be completed because the payment is currently in a completed state.
3008
PAYMENT_CANCELLED
The operation cannot be completed because the payment is currently in a cancelled state.
3009
INVALID_CURRENCY
The specified currency is invalid.
3010
INVALID_BILL_TO_COUNTRY
The specified bill-to country is invalid
3011
INVALID_SHIP_TO_COUNTRY
The specified ship-to country is invalid.
3012
CANNOT_FINALIZE_PAYMENT
The payment provider implementation indicated that the payment cannot be finalized in its current state.
3013
CANNOT_REFUND_PAYMENT
The payment provider implementation indicated that the payment cannot be refunded in its current state.
3014
PAYMENT_NOT_COMPLETED
The operation cannot be completed because the payment is not currently in a completed state.
3015
REFUND_AMT_EXCEEDED
The total amount you have specified in your refund call is greater than the available balance to refund (total finalized amount - total refunds). Existing refunds which are in a pending state also count against the available balance.
3016
PAYMENT_ANULLED
The operation cannot be completed because the payment is currently in an annulled state.
3017
ANULL_AMT_EXCEEDED
The total amount you have specified in your annul call is greater than the available balance to annul. Existing annulments and finalizations which are in a pending state also count against the available balance.
3018
CANNOT_ANULL_AUTHORIZATION
The payment provider implementation indicated that the authorization cannot be annulled in its current state.
3019
PAYMENT_NOT_AUTHORIZED
The operation cannot be completed because no portion of the payment is currently in an authorized state.
3020
CANNOT_AUTHORIZE_PAYMENT
The payment provider implementation indicated that the payment cannot be authorized based on the information provided.
3021
DUPLICATE_ORDER
An authorized or completed order already exists within the last 60 minutes for this order number and total amount combination.
3022
PAYABLE_AMT_EXCEEDED
The total amount specified in your request is greater than the remaining payable amount on the order.
Initialize Payment Errors
4000
INVALID_INTERFACE_ID
The specified interface id is invalid.
4003
INVALID_PMT_CHAN_FOR_IFACE
Payment channel '...' is invalid for interface '...'.
4004
INVALID_PMT_MTD_FOR_IFACE
Payment method '...' is invalid for interface '...'.
4005
INVALID_PMT_CHAN
Payment channel '...' is invalid.
4006
INVALID_PMT_MTD_FOR_PMT_CHAN
Payment method '...' is invalid for payment channel '...'.
4007
INVALID_CUST_LANGUAGE_CODE
The specified customer language code is invalid.
4008
INVALID_PMT_MTD_ID
Payment method '...' is invalid.
Processing Errors
5000
GENERAL_DECLINE
The operation was declined by the bank or processor.
See the bottom of this page for detailed information about general declines.
5001
CARD_EXPIRED
The specified card has expired.
5002
COULD_NOT_DETERMINE_PMT_MTD
We could not determine the payment method to be used in this payment.
5003
COULD_NOT_DETERMINE_PMT_ROUTE
No payment route could be found that meets the criteria of this transaction.
5004
COULD_NOT_DETERMINE_ADDR_PROVIDER
Ensure address provider is configured.
5005
ADDR_LOOKUP_PROCESSOR
Generic failure in processor for address lookup.
5006
NO_MATCH
The operation yielded no result.
Authentication Errors
6000
CAN_NOT_INITIATE_AUTHENTICATION_SESSION
An error occurred while attempting to initiate an authentication session.
6001
CAN_NOT_CHECK_AUTHENTICATION_SESSION
An error occurred while checking an authentication session.
6002
CAN_NOT_GET_LIST_OF_AUTH_PROVIDERS
An error occurred while retrieving the list of authentication providers.
6003
TOO_MANY_REQUESTS
Checks for provider '...' was called with an interval of '...'ms which is lower than the allowed rate '...'ms.
6004
SESSION_NOT_FOUND
The authentication session cannot be found.
6005
SESSION_HAS_EXPIRED
The authentication session has expired.
General Declines
Below is a list of all possible outcomes within the "GENERAL_DECLINE" error.
Error Code
Error Message
AddressMismatch
"Provided address does not match the address on file for the customer."
EmailMismatch
"Provided e-mail address does not match the e-mail address on file for the customer."
CreditDeclined
"The customer was declined credit for this transaction."
BillToAndShipToMismatch
"The billing and shipping addresses must match for this transaction."
DuplicateTransaction
"The processor indicated that this is a duplicate transaction."
InternalError
"The processor experienced an internal error."
TaxCalculationDifference
"The processor indicated that there is a calculation mismatch in the received tax/VAT values for one or more order lines."
GovernmentIdIsInvalid
"The processor indicated that the government id is invalid."
OrderLineIdNotUnique
"The processor indicated that the operation would result in a non-unique order line ID."
OrderLineIdNotUniquePerOperation
"Updating order lines requires unique line ID's per update operation type."
OperationDidNotResultInAnyUpdates
"The processor indicated that the operation would not result in any updates."
DifferentLineItemIds
"Value should match value of nested LineItem.Id."
CannotUpdateOrderInvoiceNotUpdatable
"The operation cannot be completed because the order has invoices in a non-updatable state."
OrderLineIdNotFound
"The processor indicated that the specified LineItem.Id does not exist."
RefundAmountGreaterThanOrderTotal
"The processor indicated that the update would result in a refund amount greater than the order total."
