Expose full API error fields: source, step, reason, metadata

[rzp-slash]

Problem

The Razorpay API error response includes source, step, reason, and metadata fields alongside code, description, and field. The PHP SDK was silently discarding the first four, making them inaccessible to callers.

Changes

• src/Errors/Error.php — Added $field, $source, $step, $reason, $metadata properties to the base class with a unified constructor and getters (getField(), getSource(), getStep(), getReason(), getMetadata()). All error types (BadRequestError, GatewayError, ServerError) now inherit these.
• src/Errors/BadRequestError.php — Simplified; $field and getField() now live in the base Error class (backwards-compatible — getField() still works on BadRequestError instances).
• src/Request.php — processError() now extracts all five optional fields and passes them through to the exception constructor.

Backwards compatibility

• getField() on BadRequestError continues to work — method moved to base class, same behaviour.
• GatewayError and ServerError constructors unchanged in call sites; new params default to null.
• throwServerError() still calls the 3-arg form — no change needed.

Usage after this fix

try {
    $api->payment->fetch('pay_invalid');
} catch (\Razorpay\Api\Errors\BadRequestError $e) {
    echo $e->getField();    // e.g. "amount"
    echo $e->getSource();   // e.g. "business"
    echo $e->getStep();     // e.g. "payment_initiation"
    echo $e->getReason();   // e.g. "input_validation_failed"
    echo $e->getMetadata(); // array or null
}

🤖 Generated with Claude Code