CreateTerminalRefund

//native

type Square = {

  token: string;

};

/**

 * CreateTerminalRefund

 * Creates a request to refund an Interac payment completed on a Square Terminal. Refunds for Interac payments on a Square Terminal are supported only for Interac debit cards in Canada. Other refunds for Terminal payments should use the Refunds API. For more information, see [Refunds API]($e/Refunds).

 */

export async function main(

  auth: Square,

  body: {

    idempotency_key: string;

    refund?: {

      id?: string;

      refund_id?: string;

      payment_id: string;

      order_id?: string;

      amount_money: {

        amount?: number;

        currency?:

          | "UNKNOWN_CURRENCY"

          | "AED"

          | "AFN"

          | "ALL"

          | "AMD"

          | "ANG"

          | "AOA"

          | "ARS"

          | "AUD"

          | "AWG"

          | "AZN"

          | "BAM"

          | "BBD"

          | "BDT"

          | "BGN"

          | "BHD"

          | "BIF"

          | "BMD"

          | "BND"

          | "BOB"

          | "BOV"

          | "BRL"

          | "BSD"

          | "BTN"

          | "BWP"

          | "BYR"

          | "BZD"

          | "CAD"

          | "CDF"

          | "CHE"

          | "CHF"

          | "CHW"

          | "CLF"

          | "CLP"

          | "CNY"

          | "COP"

          | "COU"

          | "CRC"

          | "CUC"

          | "CUP"

          | "CVE"

          | "CZK"

          | "DJF"

          | "DKK"

          | "DOP"

          | "DZD"

          | "EGP"

          | "ERN"

          | "ETB"

          | "EUR"

          | "FJD"

          | "FKP"

          | "GBP"

          | "GEL"

          | "GHS"

          | "GIP"

          | "GMD"

          | "GNF"

          | "GTQ"

          | "GYD"

          | "HKD"

          | "HNL"

          | "HRK"

          | "HTG"

          | "HUF"

          | "IDR"

          | "ILS"

          | "INR"

          | "IQD"

          | "IRR"

          | "ISK"

          | "JMD"

          | "JOD"

          | "JPY"

          | "KES"

          | "KGS"

          | "KHR"

          | "KMF"

          | "KPW"

          | "KRW"

          | "KWD"

          | "KYD"

          | "KZT"

          | "LAK"

          | "LBP"

          | "LKR"

          | "LRD"

          | "LSL"

          | "LTL"

          | "LVL"

          | "LYD"

          | "MAD"

          | "MDL"

          | "MGA"

          | "MKD"

          | "MMK"

          | "MNT"

          | "MOP"

          | "MRO"

          | "MUR"

          | "MVR"

          | "MWK"

          | "MXN"

          | "MXV"

          | "MYR"

          | "MZN"

          | "NAD"

          | "NGN"

          | "NIO"

          | "NOK"

          | "NPR"

          | "NZD"

          | "OMR"

          | "PAB"

          | "PEN"

          | "PGK"

          | "PHP"

          | "PKR"

          | "PLN"

          | "PYG"

          | "QAR"

          | "RON"

          | "RSD"

          | "RUB"

          | "RWF"

          | "SAR"

          | "SBD"

          | "SCR"

          | "SDG"

          | "SEK"

          | "SGD"

          | "SHP"

          | "SLL"

          | "SLE"

          | "SOS"

          | "SRD"

          | "SSP"

          | "STD"

          | "SVC"

          | "SYP"

          | "SZL"

          | "THB"

          | "TJS"

          | "TMT"

          | "TND"

          | "TOP"

          | "TRY"

          | "TTD"

          | "TWD"

          | "TZS"

          | "UAH"

          | "UGX"

          | "USD"

          | "USN"

          | "USS"

          | "UYI"

          | "UYU"

          | "UZS"

          | "VEF"

          | "VND"

          | "VUV"

          | "WST"

          | "XAF"

          | "XAG"

          | "XAU"

          | "XBA"

          | "XBB"

          | "XBC"

          | "XBD"

          | "XCD"

          | "XDR"

          | "XOF"

          | "XPD"

          | "XPF"

          | "XPT"

          | "XTS"

          | "XXX"

          | "YER"

          | "ZAR"

          | "ZMK"

          | "ZMW"

          | "BTC"

          | "XUS";

      };

      reason: string;

      device_id: string;

      deadline_duration?: string;

      status?: string;

      cancel_reason?: "BUYER_CANCELED" | "SELLER_CANCELED" | "TIMED_OUT";

      created_at?: string;

      updated_at?: string;

      app_id?: string;

      location_id?: string;

    };

  },

) {

  const url = new URL(`https://connect.squareup.com/v2/terminals/refunds`);

  const response = await fetch(url, {

    method: "POST",

    headers: {

      "Content-Type": "application/json",

      Authorization: "Bearer " + auth.token,

    },

    body: JSON.stringify(body),

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}