/**
 * Structured card/wallet decline information extracted from PayPal responses.
 *
 * A declined capture used to surface as a generic "Failed to capture PayPal
 * order" 500. This maps PayPal's processor response codes and issue names to
 * a buyer-friendly message plus a `retryable` flag, so storefronts can say
 * "insufficient funds — try another card" and decide whether to offer a retry.
 */
export type PayPalDeclineInfo = {
    /** Processor `response_code` (e.g. "5120") or PayPal issue name. */
    code: string;
    /** Buyer-friendly message, safe to show in the storefront. */
    message: string;
    /**
     * Whether another attempt could plausibly succeed (usually with a different
     * card or funding source). `false` marks hard declines — fraud, restricted
     * accounts — where inviting a retry only frustrates the buyer.
     */
    retryable: boolean;
    avs_code?: string;
    cvv_code?: string;
};
/**
 * Extract decline info from a PayPal response body — either a 4xx error body
 * (`{ name, details: [{ issue }] }`) or a 2xx capture/authorize payload whose
 * capture came back DECLINED/FAILED (carrying `processor_response`).
 * Returns null when the payload holds no recognizable decline.
 */
export declare function extractPayPalDecline(payload: unknown): PayPalDeclineInfo | null;
//# sourceMappingURL=decline-codes.d.ts.map