sumup-debug
Troubleshoot common SumUp integration failures. Use when SumUp HMAC signature checks fail, checkout sessions expire, scopes aren't activated, widget mount is blocked, affiliate keys don't match, or `checkout_reference` collides.
Install
With your agent
Install OMGSkills skill "sumup/sumup-skills:skills/sumup-debug" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/sumup/sumup-skills /tmp/sumup-skills && ln -s /tmp/sumup-skills/skills/sumup-debug ~/.claude/skills/sumup-debugFrom README
SumUp Troubleshooting Playbook Use this skill for diagnosis and remediation of failing SumUp integrations. Fast Triage Matrix Classify symptom: Auth/signature error Checkout creation/processing error Widget/client-side mount or flow error Async mismatch (success in UI, failure in backend state) Capture evidence: request/response payloads (sanitized), HTTP status, error code/message checkout id, merchant code, checkoutreference webhook delivery id and signature verdict Reproduce in sandbox before changing production behavior. Common Failures and Fixes HMAC signature mismatch (x-payload-signature) Symptoms: Webhook verification fails for all events or intermittently. Likely causes: Body parser mutates payload before verification. Wrong webhook secret/environment pair. Digest computed with non-raw body bytes. Fix: Verify against raw request body bytes. Ensure HMAC SHA-256 with exact configured secret. Confirm secret belongs to the same merchant/environment.