Error codes
Soft decline
Adyen
Adyen code 03 – Invalid Merchant
The transaction was refused by the card issuer. The shopper should contact their bank for clarification and can try again after resolving the issue or use another payment method.
What does Adyen refusal code 03 mean?
Adyen refusal code 03 Invalid Merchant is returned when the issuing bank doesn't recognize the merchant or acquirer configuration. This isn't a cardholder problem — it's a sign that something about how the transaction is being routed or identified is failing validation at the issuer side.
Is it a soft or hard decline?
Code 03 is technically a soft decline, but retrying the same configuration will produce the same result. The fix has to happen on the merchant/acquirer side.
Common root causes
MID (Merchant ID) not properly registered with the acquirer
Incorrect MCC (Merchant Category Code) for the transaction type
Acquirer routing issues or missing BIN support
Unregistered descriptor or acquirer configuration mismatch
Recommended recovery steps
Verify merchant account setup with Adyen and the acquirer.
Check MCC classification for accuracy.
Review acquirer routing if you process across multiple acquirers.
Contact Adyen support if the configuration appears correct.
How FlyCode handles Adyen code 03
FlyCode identifies 03 declines as merchant-configuration issues rather than retry candidates, surfacing them in the dashboard so the underlying problem can be resolved upstream. Retries without fixing the root cause waste processing fees and don't recover revenue.
What does Adyen refusal code 03 mean?
Adyen refusal code 03 Invalid Merchant is returned when the issuing bank doesn't recognize the merchant or acquirer configuration. This isn't a cardholder problem — it's a sign that something about how the transaction is being routed or identified is failing validation at the issuer side.
Is it a soft or hard decline?
Code 03 is technically a soft decline, but retrying the same configuration will produce the same result. The fix has to happen on the merchant/acquirer side.
Common root causes
MID (Merchant ID) not properly registered with the acquirer
Incorrect MCC (Merchant Category Code) for the transaction type
Acquirer routing issues or missing BIN support
Unregistered descriptor or acquirer configuration mismatch
Recommended recovery steps
Verify merchant account setup with Adyen and the acquirer.
Check MCC classification for accuracy.
Review acquirer routing if you process across multiple acquirers.
Contact Adyen support if the configuration appears correct.
How FlyCode handles Adyen code 03
FlyCode identifies 03 declines as merchant-configuration issues rather than retry candidates, surfacing them in the dashboard so the underlying problem can be resolved upstream. Retries without fixing the root cause waste processing fees and don't recover revenue.
What does Adyen refusal code 03 mean?
Adyen refusal code 03 Invalid Merchant is returned when the issuing bank doesn't recognize the merchant or acquirer configuration. This isn't a cardholder problem — it's a sign that something about how the transaction is being routed or identified is failing validation at the issuer side.
Is it a soft or hard decline?
Code 03 is technically a soft decline, but retrying the same configuration will produce the same result. The fix has to happen on the merchant/acquirer side.
Common root causes
MID (Merchant ID) not properly registered with the acquirer
Incorrect MCC (Merchant Category Code) for the transaction type
Acquirer routing issues or missing BIN support
Unregistered descriptor or acquirer configuration mismatch
Recommended recovery steps
Verify merchant account setup with Adyen and the acquirer.
Check MCC classification for accuracy.
Review acquirer routing if you process across multiple acquirers.
Contact Adyen support if the configuration appears correct.
How FlyCode handles Adyen code 03
FlyCode identifies 03 declines as merchant-configuration issues rather than retry candidates, surfacing them in the dashboard so the underlying problem can be resolved upstream. Retries without fixing the root cause waste processing fees and don't recover revenue.
Understanding This Decline Code
Extended content body
Frequently Asked Questions
Is Adyen code 03 a soft or hard decline?
Is this the shopper's problem or the merchant's?
It's a merchant-side issue. The cardholder's card is fine — the problem is how the transaction is being routed or identified at the acquirer/merchant level, and it must be fixed in the merchant setup.
Does FlyCode retry Adyen 03 declines?
FlyCode flags code 03 as a merchant-side configuration issue rather than a retry candidate, surfacing it clearly in the dashboard so the underlying setup problem can be resolved quickly.
