Error Codes

API Error Codes

1000 Series - PENDING

This status code means the transaction is still in the pending stage and will be updated to the terminal stage when it's completed

2000 Series - SUCCESS

This status code means the transaction is successful

4000 Series - TRANSACTION VALIDATION ERROR

Error codes
Error CodeError Status
4001INVALID_REQUEST_DATA
4002DUPLICATE_TRANSACTION_ERROR
4003TRANSACTION_NOT_EXIST_ON_PSP
4010INVALID_UNAUTHORISED_TRANSACTION_IAMPORTKEY_ERROR
4011INVALID_UNAUTHORISED_TRANSACTION_SIGNATURE_ERROR
4012INVALID_UNAUTHORISED_TRANSACTION_ERROR
4013INVALID_MERCHANT_TYPE
4014INVALID_EMAIL
4015MASTER_MERCHANT_NOT_FOUND
4016MERCHANT_NOT_FOUND
4017MERCHANT_NOT_ASSOCIATED_WITH_MASTER_MERCHANT
4018MERCHANT_ASSOCIATED_WITH_ANOTHER_MASTER_MERCHANT
4019INVALID_MERCHANT_STATUS
4020INVALID_ACTION_TYPE
4021MERCHANT_LOGIN_NOT_ALLOWED
4022MERCHANT_LOGIN_DISABLED_BY_MASTER_MERCHANT
4023MASTER_MERCHANT_DONOT_HAVE_THIS_ACCESS
4024MERCHANT_IS_INACTIVE
4025INVALID_REQUEST
4026RECON_MAPPING_NOT_FOUND
4027RECON_MAPPING_NOT_UPDATED
4028RECON_MAPPING_NOT_CREATED
4029REFUND_SYSTEM_ERROR
4030PAYOUT_SYSTEM_ERROR
4031PAYOUTVENDOR_SYSTEM_ERROR
4032RECON_SYSTEM_ERROR
4033INVALID_PORTAL_REQUEST
4034INVALID_ENVIRONMENT
4035KYC_RECORD_NOT_FOUND
4036KYC_RECORD_NOT_CREATED
4037KYC_RECORD_NOT_UPDATED
4038KYC_SUBMISSION_NOT_CREATED
4039KYC_SUBMISSION_NOT_UPDATED
4040MISSING_KYC_SUBMISSION_LINK
4041INVALID_AMOUNT
4042MERCHANT_ALREADY_EXISTS
4043MERCHANT_INVITE_ERROR
4044CREDS_NOT_FOUND
4045VIRTUAL_ACCOUNT_NOT_SUPPORTED
4046INVALID_PAYMENT_CHANNEL_KEY
4047INVALID_SETTLEMENT_REF
4048INVALID_SETTLEMENT_STATUS
4049MISSING_KYC_SUBMISSION_VALUE
4050INVALID_LINK_MERCHANT_ORDER_REF
4051MERCHANT_ALREADY_REGISTERED_ON_PSP
4052INVALID_EMAIL_ADDRESS
4053INVALID_PASSWORD
4054INVALID_UNAUTHORIZED_JWT_TOKEN_ERROR
4055MASTER_MERCHANT_REGISTRATION_ERROR
4056OTP_EXPIRED
4057INVALID_PAYMENT_METHOD
4058PAYMENT_METHOD_CONFIGURATION_ERROR
4059INVALID_PAYMENT_PAGE_STOCK
4060PAYMENT_PAGE_INVALID_OWNER
4061INVALID_VIRTUAL_ACCOUNT
4062INVALID_PAGE_FIELD
4063INVALID_PAGE_FIELD_VALUE
4064MISSING_MANDATORY_FIELD
4065INVALID_PAGE_REF
4066INVALID_MERCHANT_PAYMENT_DATA
4067LIMITED_PAYMENT_CHANNEL_RECORD_NOT_FOUND
4068INVALID_PAGE_TYPE
4069INACTIVE_PAYMENT_PAGE
4070INVALID_PAYMENT_REQUEST_REFUND_NOT_ALLOWED
4071INVALID_TRANSACTION_ORDER_CANCELLED_ERROR
4072TRANSACTION_EXPIRED
4073OTP_VERIFICATION_ERROR
4075INVALID_CURRENCY
4076INVALID_AMOUNT_CURRENCY_ERROR
4077INVALID_MINIMUM_AMOUNT_LIMIT
4078INVALID_MAXIMUM_AMOUNT_LIMIT
4079INVALID_STATUS_TYPE
4080PAYMENT_SERVICE_PROVIDER_ERROR
4081PARTIAL_REFUND_NOT_ALLOWED
4081ROLE_NOT_ALLOWED
4082TRANSACTION_EXPIRED_BY_CHAIPORT
4083INVALID_PAYMENT_LINK_REF
4084INVALID_UNAUTHORISED_PORTONEKEY_ERROR
4085INVALID_PRICE_REF
4086INVALID_QUANTITY
4087INVALID_RECURRANCE_COUNT
4088MAX_RETRY_LIMIT_EXCEED
4089INVALID_SUBSCRIPTION_ORDER_REF
4090INVALID_TOTAL_ADDITIONAL_COST
4091INVALID_PERIOD
4092RECON_INVALID_OWNER
4093VOIDED
4095PSP_CANCELLED_SUBSCRIPTION
4096INVALID_REFERENCE
4094INVALID_FREQUENCY
4097TRANSACTION_UNDER_REVIEW
4098INVALID_ACCOUNT
4099INVALID_UNAUTHORISED_PORTONE_SECRET_ERROR
4100SUSPECTED_FRAUDULENT_TRANSACTION_ERROR
4101MERCHANT_SUBUSER_NOT_FOUND
4102VERIFY_ACCOUNT_NOT_SUPPORTED

5000 Series - PORTONE/PSP SYSTEM ERRORS

Error codes
Error CodeError Status
5000PAYMENT_SYSTEM_ERROR
5001RECORD_NOT_FOUND_ERROR
5002DUPLICATE_FOUND_ERROR
5011MERCHANT_UPDATE_FAILED
5012FAILED_TO_SEND_EMAIL
5013MERCHANT_PAYMENT_METHOD_UPDATE_FAILED
5014ERROR_IN_FETCHING_RECORDS
5015RECORD_NOT_CREATED
5016MERCHANT_CREATION_FAILED
5017SUB_USER_CREATION_FAILED
5018PAYMENT_TXN_NOT_CREATED
5019RECORD_UPDATE_FAILED
5020MERCHANT_KYC_CREATION_FAILED
5021TOKENIZATION_KEY_CREATION_FAILED
5022PAYMENT_CHANNEL_NOT_SUPPORTED
5023INVALID_PAYMENT_CHANNEL
5024PSP_COMMUNICATION_ERROR
5025ERROR_PARSING_RESPONSE
5030INVALID_REDIRECT_URL

6000 Series - BANK/CARD ERRORS

Error codes
Error CodeError Status
6001BANK_REFUSED_TRANSACTION
6002FUNDS_LIMIT_ERROR
6003PAYMENT_METHOD_ISSUER_REFUSED_TRANSACTION
6011INVALID_CARD_INFO_ERROR
6012INVALID_CARD_NOT_SUPPORTED_ERROR
6013INVALID_CARD_EXPIRED_ERROR
6014INVALID_CARD_DECLINED_ERROR
6015INVALID_CARD_BLOCKED_ERROR
6016INVALID_CARD_3DS_ERROR
6017INVALID_CARD_PROCESSING_ERROR
6018DECLINED_BY_BANK
6019EXCEEDED_MAX_LIMIT
6020INVALID_BANK_CODE
6021INVALID_CARD_BLACKLISTED_ERROR
6022INVALID_CARD_LOST_ERROR

7000 Series - UNKNOWN ERRORS

Error codes
Error CodeError Status
7000ERROR_CREATING_CUSTOMER

8000 Series - OTHER PSP ERRORS

Error codes
Error CodeError Status
8001PAYMENT_AUTHORIZATION_ERROR
8002PAYMENT_AUTHENTICATION_ERROR
8003PAYMENT_PROCESSING_ERROR
8004RISK_VALIDATION_ERROR