S3 Troubleshooting playbook

Needs: Supporter

Lesson S3: From a symptom (response code, HSM error, KCV mismatch, MAC failure) to the root cause.

This is a supporter feature. Create a free account, then try every supporter feature free for 7 days.

Sign in Create a free account See plans

The opening of the lesson

Why it matters

When payments fail, the symptom is usually far from the cause:

  • a PIN "fails" at the issuer because the terminal took the wrong PAN digits;
  • a MAC fails because one side pads differently;
  • cardholders complain of double charges because a reversal pointed to the wrong STAN.

Troubleshooting is the skill of walking back from the symptom to the cause, checking the cheapest and most likely things first.

In the full lesson

  1. The concept
  2. Step by step
  3. In the real world
  4. Common mistakes
  5. What to test

What module S3 covers →

The rest of the lesson opens with a supporter pass, which you can try free for 7 days.
An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.