Errors

This section lists the errors you may encounter when using the Direct API.

Status	Message	Likely Cause	Recommended Action
400	Invalid amount	Amount exceeds the provider's maximum limit	Check the amount
401	Unauthorized	Invalid authentication	Check the API key
403	api_token_invalid	Invalid API credentials	Verify the API key and secret
	transaction_error	Transaction error	Retry or contact support
	Refund not allowed	Transaction is not refundable	Verify the refund conditions
	transaction_not_refundable	Transaction not refundable	Check refund conditions
	transaction_not_processed	Transaction not processed	Check the status or retry
	transaction_otp_required	OTP required for the transaction	Provide the OTP code
	transaction_greater_than_zero	Amount must be greater than zero	Verify the transaction amount
404	Payment not found	Reference not found	Check the original reference
	api_token_not_found	API token not found	Ensure the token exists
	country_not_found	Country not found	Verify the country code
	provider_not_found	Provider not found	Verify the provider name
	transaction_does_not_exist	Transaction does not exist	Verify the transaction identifier
409	Duplicate refund	Refund attempt already processed	Use a different idempotency key
	transaction_is_already_processed	Transaction already processed	Check the transaction status
	transaction_already_refunded	Transaction already refunded	Check the refund history
500	Internal Server Error	Server error	Try again later