import { paymentCancelReasonMap } from '../../dictionaries';
import { Customer } from '../customer.type';
import { CurrencyEnum, IAmount } from '../general.types';
import { Receipts } from '../receipt';
import { Receiver } from '../receiver.type';
import { IAirline } from './airline.type';
import { IPaymentMethod, PaymentMethodsEnum } from './paymentMethod.type';
import { ConfirmationTypes, IConfirmation } from './paymentsConfirmation.type';

/** Все, что касается платежей в ЮКассе */
export namespace Payments {
    /**
     * ***Статусы платежа:***
     *
     * - `pending` — платеж создан и ожидает действий от пользователя. Если вы используете стороннюю онлайн-кассу для работы по 54-ФЗ и сценарий Сначала чек, потом платеж, то платеж может находиться в статусе pending до тех пор, пока онлайн-касса не сообщит об успешной или неуспешной регистрации чека. Из статуса pending платеж может перейти в succeeded, waiting_for_capture (при двухстадийной оплате) или canceled (если что-то пошло не так).
     * - `waiting_for_capture` — платеж оплачен, деньги авторизованы и ожидают списания. Из этого статуса платеж может перейти в succeeded (если вы списали оплату) или canceled (если вы отменили платеж или что-то пошло не так).
     * - `succeeded` — платеж успешно завершен, деньги будут перечислены на ваш расчетный счет в соответствии с вашим договором с ЮKassa. Это финальный и неизменяемый статус.
     * - `canceled` — платеж отменен. Вы увидите этот статус, если вы отменили платеж самостоятельно, истекло время на принятие платежа или платеж был отклонен ЮKassa или платежным провайдером. Это финальный и неизменяемый статус.
     *
     * В зависимости от вашего процесса часть статусов может быть пропущена, но их последовательность не меняется.
     *
     * Чтобы узнать статус платежа, периодически отправляйте запросы, чтобы получить информацию о платеже, или подождите, когда придет уведомление от ЮKassa.
     * @see https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#lifecycle
     */
    export type PaymentStatus =
        | 'waiting_for_capture'
        | 'succeeded'
        | 'canceled'
        | 'pending';

    /**
     * Данные об авторизации платежа при оплате банковской картой.
     * Присутствуют только для этих способов оплаты:
     * - банковская карта
     * - Mir Pay
     * - SberPay
     * - T-Pay. */
    export type AuthorizationDetails = {
        /**
         * Retrieval Reference Number — уникальный идентификатор транзакции в системе эмитента. Пример: `603668680243`
         */
        rrn?: string;
        /** Код авторизации. Выдается эмитентом и подтверждает проведение авторизации. Пример:`062467`*/
        auth_code?: string;
        /** Данные о прохождении пользователем аутентификации по 3‑D Secure для подтверждения платежа. */
        three_d_secure: {
            /** Отображение пользователю формы для прохождения аутентификации по 3‑D Secure. Возможные значения:
             * - `true` — ЮKassa отобразила пользователю форму, чтобы он мог пройти аутентификацию по 3‑D Secure;
             * - `false` — платеж проходил без аутентификации по 3‑D Secure. */
            applied: boolean;
        };
    };

    /** Получатель платежа. */
    export interface IRecepient {
        /** Идентификатор магазина в ЮKassa. */
        account_id: string;
        /** Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта. */
        gateway_id: string;
    }

    /** Причина отмены платежа */
    export type CancelReason = keyof typeof paymentCancelReasonMap;
    /** Комментарий к статусу `canceled`: кто отменил платеж и по какой причине.
     *
     * [Подробнее про неуспешные платежи](https://yookassa.ru/developers/payment-acceptance/after-the-payment/declined-payments)
     */
    export interface PaymentCancellationDetails {
        /**Участник процесса платежа, который принял решение об отмене транзакции. Может принимать значения `yoo_money`, `payment_network` и `merchant`.
         *
         * [Подробнее](https://yookassa.ru/developers/payment-acceptance/after-the-payment/declined-payments#cancellation-details-party) про инициаторов отмены платежа
         */
        party: 'merchant' | 'yoo_money' | 'payment_network';
        /** Причина отмены платежа.
         *
         * [Перечень и описание возможных значений](https://yookassa.ru/developers/payment-acceptance/after-the-payment/declined-payments#cancellation-details-reason)
         */
        reason: CancelReason;
    }
    /**Данные о распределении денег — сколько и в какой магазин нужно перевести. */
    export type TransferPayment = Pick<
        IPayment,
        'amount' | 'description' | 'metadata'
    > & {
        /** Идентификатор магазина, в пользу которого вы принимаете оплату. Выдается ЮKassa, отображается в разделе [Продавцы](https://yookassa.ru/my/marketplace/sellers) личного кабинета (столбец shopId). */
        account_id: string;
        /** Статус распределения денег между магазинами. Возможные значения: `pending`, `waiting_for_capture`, `succeeded`, `canceled`. */
        status: PaymentStatus;
        /** Комиссия за проданные товары и услуги, которая удерживается с магазина в вашу пользу. */
        platform_fee_amount: IAmount;
    };

    export type DealType = {
        /** Идентификатор сделки. */
        id: string;
        /**Данные о распределении денег. */
        settlements: {
            /** Тип операции. Фиксированное значение: `payout` — выплата продавцу. */
            type: 'payout';
            /** Сумма вознаграждения продавца. */
            amount: IAmount;
        }[];
    };

    /** ***Объект платежа***
     *
     * Объект платежа (`Payment`) содержит всю информацию о платеже, актуальную на текущий момент времени.
     * Он формируется при создании платежа и приходит в ответ на любой запрос, связанный с платежами.
     * Объект может содержать параметры и значения, не описанные в Справочнике API. Их следует игнорировать.
     */
    export interface IPayment {
        /**
         * Идентификатор платежа в ЮKassa.
         */
        id: string;
        /**
         * Статус платежа. Возможные значения: `pending`, `waiting_for_capture`, `succeeded` и `canceled`.
         */
        status: PaymentStatus;
        /** Сумма платежа. Иногда партнеры ЮKassa берут с пользователя дополнительную комиссию, которая не входит в эту сумму. */
        amount: IAmount;
        /** Сумма платежа, которую получит магазин, — значение amount за вычетом комиссии ЮKassa.
         * Если вы партнер и для аутентификации запросов используете OAuth-токен, запросите у магазина право на получение информации о комиссиях при платежах.
         */
        income_amount?: IAmount;
        /** Описание транзакции (не более 128 символов), которое вы увидите в личном кабинете ЮKassa, а пользователь — при оплате.
         * Например: `«Оплата заказа № 72 для user@yoomoney.ru»`.
         */
        description?: string;
        /** Получатель платежа. */
        recipient?: IRecepient;
        /** [Способ оплаты](https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all), который был использован для этого платежа. */
        payment_method?: IPaymentMethod;
        /**
         * Время подтверждения платежа.
         *
         * Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F)
         * и передается в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
         *
         * Пример: `2017-11-03T11:52:31.827Z`
         */
        captured_at?: string;
        /**Время создания заказа.
         * Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F)
         * и передается в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
         *
         * Пример: `2017-11-03T11:52:31.827Z`
         */
        created_at: string;
        /** Время, до которого вы можете бесплатно отменить или подтвердить платеж. В указанное время платеж в статусе `waiting_for_capture` будет автоматически отменен.
         *
         * Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F)
         * и передается в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
         *
         * Пример: `2017-11-03T11:52:31.827Z`
         */
        expires_at?: string;
        /**
         * Выбранный способ подтверждения платежа. Присутствует, когда платеж ожидает подтверждения от пользователя.
         * [Подробнее](https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#user-confirmation) о сценариях подтверждения.
         */
        confirmation?: IConfirmation;
        /** Признак тестовой операции. */
        test: boolean;
        /** Сумма, которая вернулась пользователю. Присутствует, если у этого платежа есть успешные возвраты. */
        refunded_amount?: IAmount;
        /** Признак оплаты заказа. */
        paid: boolean;
        /** Возможность провести возврат по API.  */
        refundable: boolean;
        /**
         * Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа).
         * Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa.
         *
         * ***Ограничения***: максимум 16 ключей, имя ключа не больше 32 символов,
         * значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.
         */
        metadata?: Record<string, any>;
        /** Комментарий к статусу `canceled`
         *  кто отменил платеж и по какой причине.
         *
         * [Подробнее про неуспешные платежи](https://yookassa.ru/developers/payment-acceptance/after-the-payment/declined-payments)
         */
        cancellation_details?: PaymentCancellationDetails;
        /**
         * Данные об авторизации платежа при оплате банковской картой.
         * Присутствуют только для этих способов оплаты:
         * - банковская карта
         * - Mir Pay
         * - SberPay
         * - T-Pay.
         */
        authorization_details?: AuthorizationDetails;
        /**
         * Данные о распределении денег — сколько и в какой магазин нужно перевести. Присутствует, если вы используете [Сплитование платежей](https://yookassa.ru/developers/solutions-for-platforms/split-payments/basics)
         */
        transfers?: TransferPayment[];
        /** Данные о сделке, в составе которой проходит платеж. Присутствует, если вы проводите [Безопасную сделку](https://yookassa.ru/developers/solutions-for-platforms/safe-deal/basics)  */
        deal?: DealType;
        /** Идентификатор покупателя в вашей системе, например электронная почта или номер телефона. Не более 200 символов. Присутствует, если вы хотите запомнить банковскую карту и отобразить ее при повторном платеже в [виджете ЮKassa](https://yookassa.ru/developers/payment-acceptance/integration-scenarios/widget/basics)  */
        merchant_customer_id?: string;
    }

    /**
     * Чтобы принять оплату, необходимо создать объект платежа — `Payment`. Он содержит всю необходимую информацию для проведения оплаты (сумму, валюту и статус). У платежа линейный жизненный цикл, он последовательно переходит из статуса в статус.
     */
    export type CreatePaymentRequest = Pick<
        IPayment,
        | 'amount'
        | 'description'
        | 'recipient'
        | 'confirmation'
        | 'metadata'
        | 'transfers'
        | 'deal'
        | 'merchant_customer_id'
    > & {
        /**
         * ***Данные для формирования чека.***
         *
         * Необходимо передавать в этих случаях:
         * - вы компания или ИП и для оплаты с соблюдением требований 54-ФЗ используете [Чеки от ЮKassa](1);
         * - вы компания или ИП, для оплаты с соблюдением требований 54-ФЗ используете [стороннюю онлайн-кассу](2) и отправляете данные для чеков по одному из сценариев: [Платеж и чек одновременно](3) или [Сначала чек, потом платеж](4) ;
         * - вы самозанятый и используете решение ЮKassa для [автоотправки чеков](5)
         *
         * [1]: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/yoomoney/basics
         * [2]: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/other-services/basics
         * [3]: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/other-services/basics#payment-and-receipt
         * [4]: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/other-services/basics#payment-after-receipt
         * [5]: https://yookassa.ru/developers/payment-acceptance/receipts/self-employed/basics
         */
        receipt?: Receipts.ReceiptinPaymentType;
        /** Одноразовый токен для проведения оплаты, сформированный с помощью [Checkout.js](1) или [мобильного SDK](2)
         *
         * Пример:`+u7PDjMTkf08NtD66P6+eYWa2yjU3gsSIhOOO+OWsOg=`
         *
         * [1]: https://yookassa.ru/developers/payment-acceptance/integration-scenarios/checkout-js/basics
         * [2]: https://yookassa.ru/developers/payment-acceptance/integration-scenarios/mobile-sdks/basics
         */
        payment_token?: string;
        /** Идентификатор [сохраненного способа оплаты](https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments)  */
        payment_method_id?: string;
        /** Данные для оплаты конкретным [способом](https://yookassa.ru/developers/payment-acceptance/integration-scenarios/manual-integration/basics#integration-options) (`payment_method`).
         *
         * Вы можете не передавать этот объект в запросе. В этом случае пользователь будет выбирать способ оплаты на стороне ЮKassa. */
        payment_method_data?: PaymentMethodData;
        /** Сохранение платежных данных (с их помощью можно проводить повторные [безакцептные списания](https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments) ). Значение `true` инициирует создание многоразового `payment_method`. */
        save_payment_method?: boolean;
        /** [Автоматический прием](https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#capture-true) поступившего платежа. */
        capture?: boolean;
        /** IPv4 или IPv6-адрес пользователя. Если не указан, используется IP-адрес TCP-подключения. */
        client_ip?: string;
        /** Объект с данными для продажи авиабилетов. Используется только для платежей банковской картой. */
        airline?: IAirline;
        /** Реквизиты получателя оплаты при [пополнении электронного кошелька, банковского счета или баланса телефона](https://yookassa.ru/developers/payment-acceptance/scenario-extensions/receiver-data)  */
        receiver?: Receiver;
    };
}