polymer-pay-api-errors

Decode Polymer Pay proxy HTTP error responses for payment and routing failure diagnosis.

1|2|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/polymerdao/pay-apis --skill polymer-pay-api-errors
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymer-pay-api-errors
Source: https://github.com/polymerdao/pay-apis/tree/main/skills/polymer-pay-api-errors
Command: npx skills add https://github.com/polymerdao/pay-apis --skill polymer-pay-api-errors

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reference guide for HTTP error codes returned by the Polymer Pay proxy. Use this to understand error causes and solutions when API requests fail.

Core Features & Use Cases

  • Comprehensive reference for HTTP error responses from the Polymer Pay proxy. Understand code meanings, diagnose issues, and resolve failures quickly.
  • Includes structured guidance for common status codes (400–503) and actionable remediation steps.
  • Provides example error payloads and best-practice handling for Polymer Pay integrations.

Quick Start

Look up a failing Polymer Pay proxy response by its status code and error code to identify fixes.

Frequently Asked Questions about polymer-pay-api-errors

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decode Polymer Pay API error codes from HTTP responses?

You fix Polymer Pay 400 Bad Request errors by reviewing the JSON error body for invalid parameters, malformed headers, or missing required fields. The reference guide pinpoints common validation failures and suggests corrective actions for request formatting.

Why does my Polymer Pay proxy return a 503 error?

A 503 error from the Polymer Pay proxy indicates a service availability or routing failure. The guide helps diagnose whether the issue stems from downstream service disruptions or temporary proxy unavailability and suggests appropriate troubleshooting steps.

What does a 402 Payment Required error mean in Polymer Pay integrations?

A 402 error in Polymer Pay integrations signals a payment processing failure, often due to insufficient funds or declined transactions. The guide outlines standard JSON error payloads to help engineers isolate payment routing issues and apply best-practice handling.

How do I troubleshoot Polymer Pay routing failures across 400 to 503 status codes?

Troubleshoot Polymer Pay routing failures by cross-referencing the HTTP status code and standard headers with the guide's structured diagnostic steps. This covers the full 400–503 range, helping engineers isolate integration faults and resolve API request failures quickly.

Can I use this to debug standard headers and JSON error bodies from the Polymer Pay proxy?

Yes, you can debug standard headers and JSON error bodies from the Polymer Pay proxy using this reference. It maps common error codes to their meanings and provides example payloads to support integration debugging and support tasks.