import type { BillingContact, ShippingContact } from '../contact';
import type { AchBankAccountDetails, AchDetails } from './ach/types';
import type { CardDetails } from './cards/types';
import type { GiftCardDetails } from './gift-card/types';
/** The payment methods accepted by the SDK */
export type MethodTypeValue = 'ACH' | 'AfterpayClearpay' | 'Apple Pay' | 'Card' | 'Cash App Pay' | 'Gift Card' | 'Google Pay';
/**
 * Digital Wallet shipping option choice
 *
 * The object used to set a product shipping option choice for the
 * buyer in a digital wallet payment such as Apple Pay or Google Pay
 * @example
 * ```
 * const shippingOption1 = {
 *    "amount": "1.00",
 *    "id": "1",
 *    "label": "UPS Ground"
 * }
 * ```
 */
export interface ShippingOption {
    /**
     * A unique ID to reference the shipping option.
     */
    id: string;
    /**
     * A short description of this shipping option.
     *
     * Displayed in the Apple Pay and Google Pay payment sheets.
     */
    label: string;
    /**
     * The amount of this shipping option.
     *
     * When used for `discounts`, the amount must be a positive number.
     * Web Payments SDK handles displaying it as a negative amount for Apple Pay
     * and Google Pay.
     *
     * Given as a string representation of a float with two decimal places
     * (e.g., `"15.00"`).
     *
     * Use `"0.00"` to indicate free or no cost.
     */
    amount: string;
}
/**
 * A single line item in an Apple Pay or Google Pay payment request
 *
 * Line items are optional and can be included in a payment request when there
 * are calculated charges such as taxes and shipping charges added on to a
 * purchase.
 * @example
 * ```
 * {
 *   "label": "Shipping charges",
 *   "amount": "15.69",
 *   "pending": true
 * }
 * ```
 */
export interface LineItem {
    /**
     * The total amount of the line item given as a string representation
     * float with decimal places representing the lowest denominations of the currency.
     * This follows the W3 Payment Request API standard - https://www.w3.org/TR/payment-request/#dfn-valid-decimal-monetary-value
     *
     * For example, a total of "10" is represented as `"10.00"` or `"10"` for currencies with fractional denominations (such as USD),
     * while the total is represented as `"10"` in currencies without fractional denominations, such as JPY.
     *
     * This is typically the cost of an item or service, or additional charge
     * (e.g., taxes, shipping). Use `"0"` to indicate free or no cost  (`"0.00"` is also valid for currencies with fractional denominations, such as USD), and
     * negative values to indicate discounts, etc.
     *
     * If the line item is a payment `total`, this is the total charge of the
     * payment and should equal the sum of the line items.
     */
    amount: string;
    /**
     * An internal ID, such as a SKU, for the item.
     */
    id?: string;
    /**
     * URL for an image of the item.
     *
     * This field does not apply to Apple Pay or Google Pay.
     */
    imageUrl?: string;
    /**
     * Description or purpose of the line item. This is typically the name of the
     * item or service purchased. If the line item is a payment `total`, the label
     * is instead the merchant name.
     */
    label: string;
    /**
     * Indicates whether the value in the `amount` field represents an estimated
     * or unknown cost.
     *
     * Default: `false`
     *
     * If the line item is a payment `total` and any other line item is pending,
     * the total must also be pending.
     *
     * **Notes**
     * - Apple Pay displays pending line items with an amount of `"pending"`
     * instead of the `amount` value.
     * - Google Pay does not display pending line items.
     */
    pending?: boolean;
    /**
     * URL for the item's product page.
     *
     * This field does not apply to Apple Pay or Google Pay.
     */
    productUrl?: string;
}
/**
 * The payments.paymentRequest method argument
 *
 * This object contains the details of a payment request including line items,
 * shipping contact and options, and total payment request.
 *
 * @example
 * ```
 * const paymentRequestOptions = {
 *    "countryCode": "US",
 *    "currencyCode": "USD",
 *    "lineItems": [
 *      {
 *        "amount": "22.15",
 *        "label": "Item to be purchased",
 *        "id": "SKU-12345
 *        "imageUrl": "https://url-cdn.com/123ABC"
 *        "pending": true
 *        "productUrl": "https://my-company.com/product-123ABC"
 *      }
 *    ],
 *    "taxLineItems": [
 *      {
 *        "label": "State Tax",
 *        "amount": "8.95",
 *        "pending": true
 *      }
 *    ],
 *    "discounts": [
 *      {
 *        "label": "Holiday Discount",
 *        "amount": "5.00",
 *        "pending": true
 *      }
 *    ],
 *    "requestBillingContact": false,
 *    "requestShippingContact": false,
 *    "shippingOptions"[
 *      {
 *        "label": "Next Day",
 *        "amount": "15.69",
 *        "id": "1"
 *      },
 *      {
 *        "label": "Three Day",
 *        "amount": "2.00",
 *        "id": "2"
 *      }
 *    ],
 *    // pending is only required if it's true.
 *    "total": {
 *      "amount": "41.79",
 *      "label": "Total",
 *    },
 * };
 * ```
 */
export interface PaymentRequestOptions {
    /**
     * Required: two-letter ISO 3166-1 country code of the merchant.
     */
    countryCode: string;
    /**
     * Required: three-letter ISO 4217 country currency code
     */
    currencyCode: string;
    /**
     * Optional: Details of line items related to discounts.
     */
    discounts?: LineItem[];
    /**
     * Optional: Details line items.
     */
    lineItems?: LineItem[];
    /**
     * Optional: Afterpay only. For cases where the item is picked up, set the contact information for the store.
     * For Afterpay, if *requestShippingContact* is false, pickupContact is used if available.
     */
    pickupContact?: ShippingContact;
    /**
     * Optional: defaults to false. Requests the buyer to provide billing contact
     * information
     */
    requestBillingContact?: boolean;
    /**
     * Optional: defaults to false. Requests the buyer to provide shipping contact
     * information
     *
     * For Afterpay, if *requestShippingContact* is false, pickupContact is used if available.
     */
    requestShippingContact?: boolean;
    /**
     *
     * Optional: Pre set the shipping contact
     */
    shippingContact?: ShippingContact;
    /**
     * Optional: Details of shipping related line items.
     */
    shippingLineItems?: LineItem[];
    /**
     * Optional: Shows a set of shipping options to the buyer
     */
    shippingOptions?: ShippingOption[];
    /**
     * Optional: Details of tax related line items.
     */
    taxLineItems?: LineItem[];
    /**
     * Required: Total amount of purchase including line item amounts.
     */
    total: LineItem;
}
/**
 * Valid PaymentRequestEvent values used for Apple Pay, Google Pay, and
 * Cash App Pay payment requests
 */
export type PaymentRequestEventValue = 'shippingcontactchanged' | 'shippingoptionchanged';
/**
 * Details about digital wallet shipping address errors
 *
 * `ShippingErrors` provides the address field whose value is in error and
 *  the details of the error. Each `ShippingError` object describes one address
 * field with its corresponding error.
 * @example
 * ```
 *  const shippingErrors = {
 *    postalCode: 'A valid US Zip Code is required. Please check and try again.'
 * }
 * ```
 */
export interface ShippingErrors {
    /**
     * Indicate the address lines are not valid.
     */
    addressLines?: string;
    /**
     * Indicate the city/locality is not valid.
     */
    city?: string;
    /**
     * Indicate the state/province/region is not valid.
     */
    state?: string;
    /**
     * Indicate the postal code is not valid.
     */
    postalCode?: string;
    /**
     * Indicate the country is not valid.
     */
    country?: string;
}
/**
 * Interface that describes the object argument of the `paymentRequest.addEventListener` method
 * return value.
 *
 * Use this interface to create an object that contains payment request
 * properties that are to be updated in the digital wallet payment sheet after
 * recalculating fees or catching buyer input errors.
 * @example
 * ```
 * req.addEventListener('shippingcontactchanged', (contact) => {
 *   const shippingErrors = "shippingErrors": {
 *       "addressLines": "1234 Nth Main Street",
 *       "city": "New Bork",
 *       "country": "XSA",
 *       "postalCode": "9468x",
 *       "MY"
 *   };
 *   const shippingLineItems = "shippingLineItems":[
 *       {
 *        "label": "Shipping charges",
 *        "amount": "15.69",
 *        "pending": true
 *       }
 *    ];
 *
 *   const taxLineItems = "taxLineItems":[
 *       {
 *        "label": "State Tax",
 *        "amount": "8.95",
 *        "pending": true
 *       }
 *    ];
 *    const total = "total": "412.00";
 *    return { shippingErrors, shippingLineItems, taxLineItems, total };
 * });
 * ```
 */
export interface PaymentRequestUpdate {
    /**
     * Allows for an error message when a valid shipping address is not usable.
     *
     * If the shipping address is valid but the item cannot be shipped there,
     * use this field to provide an appropriate error message to the buyer.
     *
     * ```js
     * req.addEventListener('shippingcontactchange', (contact) => {
     *   if (contact.countryCode !== 'US') {
     *     return { error: 'Unfortunately, we only ship to US addresses.'};
     *   }
     * }
     * ```
     *
     * @category Error
     */
    error?: string;
    /**
     * Allows for more granular messages when a shipping address is not valid.
     *
     * @category Error
     */
    shippingErrors?: ShippingErrors;
    /**
     * Replaces the current list of line items.
     *
     * Do not update line items related to sales tax or shipping, please update `taxLineItems` and `shippingLineItems`
     * for those types of changes.
     * @category Payment Request
     */
    lineItems?: LineItem[];
    /**
     * Replaces the current total.
     *
     * The sum of the amounts of the line items must equal the total.
     *
     * @category Payment Request
     */
    total?: LineItem;
    /**
     * Replaces the current list of shipping options.
     *
     * Typically used in response to the buyer choosing a new shipping address.
     *
     * @category Payment Request
     */
    shippingOptions?: ShippingOption[];
    /**
     * Replaces the current list of tax line items.
     *
     * The most common updates are to sales tax amounts, based on
     * the buyer's shipping address.
     *
     * @category Payment Request
     */
    taxLineItems?: LineItem[];
    /**
     * Replaces the current list of shipping line items.
     *
     * The most common updates are to shipping costs, based on
     * the buyer's shipping address and chosen shipping option.
     *
     * @category Payment Request
     */
    shippingLineItems?: LineItem[];
    /**
     * Replaces the current list of discount related line items.
     *
     * @category Payment Request
     */
    discounts?: LineItem[];
}
/**
 * Represents validation errors in specific parts of a shipping address.
 *
 * Only the fields representative of the address parts in error should be given
 * with a string value describing the error and how the buyer can resolve it.
 *
 * ```js
 * req.addEventListener('shippingcontactchange', (contact) => {
 *   // Assume `validZip` returns a boolean indicating whether its argument
 *   // is a valid US Zip Code.
 *   if (!validZip(contact.postalCode)) {
 *     const shippingErrors = {
 *       postalCode: 'A valid US Zip Code is required. Please check and try again.'
 *     }
 *     return { shippingErrors }
 *   }
 *
 *   ...
 * })
 */
/**
 * Update the payment request with new information.
 *
 * Found as an argument of, and called in response to, a PaymentRequestEvent.
 */
export type PaymentRequestUpdater = (update: PaymentRequestUpdate) => void;
/**
 * Callback function of the `shippingcontactchanged` event.
 */
export type ShippingContactCallback = (contact: ShippingContact) => PaymentRequestUpdate | Promise<PaymentRequestUpdate>;
/**
 * Callback function of the `shippingoptionchanged` event.
 */
export type ShippingOptionCallback = (option: ShippingOption) => PaymentRequestUpdate | Promise<PaymentRequestUpdate>;
/**
 * An appropriate callback function for the event subscription.
 */
export type PaymentRequestCallback = ShippingContactCallback | ShippingOptionCallback;
/**
 * @internal
 */
export declare class SqEvent<T = any> {
    readonly type: string;
    readonly detail: T;
    constructor(type: string, detail: T);
}
/**
 * @internal
 */
export type SqEventListener = (event: SqEvent) => void;
export type TokenStatusType = /**
 * Indicates an unknown tokenization status.
 */ 'Unknown'
/**
 * Indicates tokenization was successful.
 */
 | 'OK'
/**
 * Indicates tokenization was not successful.
 */
 | 'Error'
/**
 * Indicated validation has failed during tokenization
 */
 | 'Invalid'
/**
 * Indicates tokenization was aborted.
 */
 | 'Abort'
/**
 * Indicates tokenization was cancelled by the user.
 */
 | 'Cancel';
/**
 * Details object of an error that occurred while attempting to tokenize.
 */
export interface TokenErrorDetails {
    /**
     * Type of error thrown.
     */
    type: string;
    /**
     * Error message.
     */
    message: string;
    /**
     * Particular field that caused the error, if applicable. E.g. Card Number
     */
    field?: string;
}
/**
 * Digital wallet shipping contact information and the shipping options

 * The shipping contact information and the product shipping options that are
 * offered to a buyer in a digital payment method such as Apple Pay or Google Pay
 * @example
 * ```
 * const shippingDetails = {
 *   "contact": {"givenName": "John",
 *      "familyName": "Doe",
 *      "addressLines": [
 *         "123 East Main Street",
 *         "#111"
 *      ],
 *      "city": "Seattle",
 *      "state": "WA",
 *      "postalCode": "98111",
 *      "countryCode": "US",
 *      "email": "johndoe@example.com",
 *      "phone": "+12065551212"
 *   },
 *   "option": {
 *     "amount": "1.00",
 *     "id": "1",
 *     "label": "UPS Ground"
 *   }
 * }
 * ```
 */
export interface ShippingDetails {
    /**
     * The shipping contact information for the token.
     */
    contact?: ShippingContact;
    /**
     * The shipping option for the token.
     */
    option?: ShippingOption;
}
/**
 * Details about the payment card used to create a payment token
 *
 * `TokenDetails` provides the payment card information needed to match a token
 * returned by the SDK with payment card information input by a buyer.
 * @example
 * ```
 * try {
 *   const tokenResult = await card.tokenize(verificationDetails);
 *   alert(`Payment for ${tokenResult.details.card.brand},
 *     number ${tokenResult.details.card.last4},
 *     expiration year ${tokenResult.details.card.expYear} was processed`);
 * } catch (e) {
 *     e.errorList.forEach(err => {
 *       const li = document.createElement('li');
 *       li.innerText = err.message;
 *       document.querySelector('#errors').appendChild(li);
 *     });
 * }
 * ```
 */
export interface TokenDetails {
    /**
     * Additional information about an ACH token.
     */
    ach?: AchDetails;
    /**
     * Additional information about a tokenized bank account.
     */
    bankAccount?: AchBankAccountDetails;
    /**
     * Additional information about a tokenized card.
     */
    card?: CardDetails;
    /**
     * Additional information about a tokenized gift card.
     */
    giftCard?: GiftCardDetails;
    /**
     * Additional information about a Cash App Pay token.
     */
    cashAppPay?: {
        cashtag: string;
        referenceId: string | undefined;
    };
    /**
     * Identifies the payment method that created the token.
     *
     * Supported values include:
     * - ACH: Automated clearing house (ACH) bank transfer
     * - AfterpayClearpay: Afterpay / Clearpay
     * - Apple Pay
     * - Card: Credit or debit card
     * - Cash App Pay
     * - Gift Card
     * - Google Pay
     */
    method: MethodTypeValue;
    /**
     * Additional information about shipping.
     */
    shipping?: ShippingDetails;
    /**
     * Cardholder billing information.
     *
     * The information available depends on the payment method used, and on
     * specific circumstances of the payment method.
     *
     * For the Card payment method:
     *
     * If the buyer fills the postal code field in the card form, the postal
     * code will be given back in the billing object. Otherwise it will be empty.
     *
     * For Digital Wallet payment methods:
     *
     * The billing details given by the buyer will be populated in the billing object. Note
     * that the amount of the data in this object may change depending on whether
     * [requestBillingContact](https://developer.squareup.com/reference/sdks/web/payments/objects/PaymentRequestOptions#PaymentRequestOptions.requestBillingContact)
     * is set to true or false in [paymentRequestOptions](https://developer.squareup.com/reference/sdks/web/payments/objects/PaymentRequestOptions) when creating
     * a [paymentRequest](https://developer.squareup.com/reference/sdks/web/payments/objects/PaymentRequest).
     *
     * @category Situational
     */
    billing?: BillingContact;
}
/**
 * Optional parameters provided to the Card payment `tokenize` method
 *
 * Use `CardTokenOptions` to provide a billing contact when required by
 * the seller.
 * @example
 * ```
 * const billingContact = {
 *   addressLines: ['555 Maple Street', '#222'],
 *   city: 'Seattle',
 *   countryCode: 'US',
 *   email: 'johndoe@example.com',
 *   familyName: 'Doe',
 *   givenName: 'john',
 *   phone: '2065551212',
 *   postalCode: '98539',
 *   state: 'WA',
 * }
 * ```
 */
export interface CardTokenOptions {
    /** The buyer to be billed */
    billing: BillingContact;
}
export type TokenError = TokenErrorDetails | Error;
/**
 * The result of a successful request to tokenize a payment.
 */
export interface SuccessfulTokenResult {
    /**
     * Indicates the final status of the tokenization request.
     */
    status: 'OK';
    /**
     * Payment token representing tokenized payment information; for use with
     * relevant Square APIs and buyer verification.
     */
    token: string;
    /**
     * Additional details about the token.
     */
    details?: TokenDetails;
}
/**
 * The result of an erroring request to tokenize a payment.
 */
export interface ErrorTokenResult {
    /**
     * Indicates the final status of the tokenization request.
     *
     * - Error: Indicates tokenization was not successful.
     * - Invalid: Indicates validation has failed during tokenization.
     */
    status: 'Error' | 'Invalid';
    /**
     * Errors that occurred while attempting to tokenize.
     */
    errors: TokenError[];
}
/**
 * The result of a miscellaneous request to tokenize a payment.
 */
export interface OtherTokenResult {
    /**
     * Indicates the final status of the tokenization request.
     *
     * - Unknown: Indicates an unknown tokenization status.
     * - Abort: Indicates tokenization was aborted.
     * - Cancel: Indicates tokenization was cancelled by the user.
     */
    status: 'Unknown' | 'Abort' | 'Cancel';
}
/**
 * The result of a request to tokenize a payment
 *
 * The `TokenResult` carries the status of the request, resulting token, any
 * errors, and details about the payment card used.
 */
export type TokenResult = SuccessfulTokenResult | ErrorTokenResult | OtherTokenResult;
export interface TokenizationEvent {
    tokenResult?: TokenResult;
    error?: unknown;
}
/**
 * @internal
 */
export interface PaymentMethod<TEventType extends string = string> {
    /**
     * @internal
     */
    addEventListener(type: TEventType, listener: SqEventListener): void;
    /**
     * @internal
     */
    removeEventListener(type: TEventType, listener: SqEventListener): void;
    /**
     * @internal
     */
    destroy(): Promise<boolean>;
}