// The customer portal, discounts and embedded Connect components. import { request, segment } from "./stripe" import type { Client, RequestOptions, StripeError } from "./stripe" /// A session of the customer portal: send the customer to its `url`. export type PortalSession = { id: string, url: string, customer?: string, return_url?: string, created?: float, } /// A new portal session. export type PortalParams = { customer: string, return_url?: string, configuration?: string, locale?: string, extra?: json, } /// A coupon. export type Coupon = { id: string, name?: string, valid?: boolean, percent_off?: float, amount_off?: float, currency?: string, duration?: string, duration_in_months?: float, max_redemptions?: float, times_redeemed?: float, redeem_by?: float, metadata?: json, } /// A promotion code customers can type in. `coupon` and `customer` are expandable: `idOf` gives their ids. export type PromotionCode = { id: string, code: string, active?: boolean, coupon?: json, promotion?: json, customer?: json, expires_at?: float, max_redemptions?: float, times_redeemed?: float, metadata?: json, } /// A session for Stripe's embedded Connect components: give its `client_secret` to the browser. export type AccountSession = { account: string, client_secret: string, expires_at?: float, livemode?: boolean, } /// A new account session. `components` says which embedded components it may show. export type AccountSessionParams = { account: string, components: json } /// Opens the customer portal for a customer. export async fn createPortalSession( c: Client, params: PortalParams, options: RequestOptions = {}, ): PortalSession ! StripeError { return try await request( c, "POST", "/v1/billing_portal/sessions", params, options, j => try j as PortalSession, ) } /// Gets a coupon by id. export async fn retrieveCoupon( c: Client, id: string, options: RequestOptions = {}, ): Coupon ! StripeError { return try await request( c, "GET", `/v1/coupons/${segment(id)}`, null, options, j => try j as Coupon, ) } /// Gets a promotion code by id. export async fn retrievePromotionCode( c: Client, id: string, options: RequestOptions = {}, ): PromotionCode ! StripeError { return try await request( c, "GET", `/v1/promotion_codes/${segment(id)}`, null, options, j => try j as PromotionCode, ) } /// Creates a session for a connected account's embedded components. export async fn createAccountSession( c: Client, params: AccountSessionParams, options: RequestOptions = {}, ): AccountSession ! StripeError { return try await request( c, "POST", "/v1/account_sessions", params, options, j => try j as AccountSession, ) }