Skip to main content

Status Code Information


important

Refer the extensive list of status code and reason mapping available in PortOne. The errors received from Payment channels will be mapped in one of following possible errors and propagated to your server.

API Error Codes#

1000 - PENDING
2000 - SUCCESS
3000 - MERCHANT ERROR
4000 - TRANSACTION ERRORS
5000 - PORTONE SYSTEM ERRORS
6000 - BANK ERRORS
7000 - UNKNOWN_ERROR
8000 - PSP ERRORS
Error CodeError Status
4001INVALID_PAYMENT_REQUEST
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_PAYEMNT_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
4100SUSPECTED_FRAUDULENT_TRANSACTION_ERROR
4075INVALID_CURRENCY
4076INVALID_AMOUNT_CURRENCY_ERROR
4077INVALID_MINIMUM_AMOUNT_LIMIT
4078INVALID_MAXIMUM_AMOUNT_LIMIT
4079INVALID_STATUS_TYPE
4080PAYMENT_SERVICE_PROVIDER_ERROR
4081ROLE_NOT_ALLOWED
4082TRANSACTION_EXPIRED
4081PARTIAL_REFUND_NOT_ALLOWED
4083INVALID_PAYMENT_LINK_REF
4084INVALID_UNAUTHORISED_PORTONEKEY_ERROR
4086INVALID_QUANTITY
4087INVALID_RECURRANCE_COUNT
4088MAX_RETRY_LIMIT_EXCEED
4089INVALID_SUBSCRIPTION_ORDER_REF
4090INVALID_TOTAL_ADDITIONAL_COST
4091INVALID_PERIOD
4092RECON_INVALID_OWNER
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
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
7000ERROR_CREATING_CUSTOMER
8001PAYMENT_AUTHORIZATION_ERROR
8002PAYMENT_AUTHENTICATION_ERROR
8003PAYMENT_PROCESSING_ERROR
8004RISK_VALIDATION_ERROR