Retreive a Session - WooshPay OpenAPI

Retrieves a Session object.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string {{Username}}:{{Password}}

Example:

Authorization: Basic YWRtaW46MTIzNDU2

Path Params

string

required

Example:

cs_1795782989284638720

Header Params

string

required

Default:

application/json

Content-Type

string

required

Default:

application/json

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

string

optional

Unique identifier for the object, like "cs_xxx" in live environment and "cs_test_xxx" in test environment.

object

string

optional

value is "checkout.session"

amount_subtotal

integer

optional

Total of all items before discounts or taxes are applied.

amount_total

integer

optional

Total of all items after discounts and taxes are applied.

billing_address_collection

enum<string>

optional

Describes whether Checkout should collect the customer’s billing address.

Allowed values:

requiredauto

cancel_url

string

optional

The URL the customer will be directed to if they decide to cancel payment and return to your website.

client_reference_id

string

optional

A unique string to reference the Checkout Session. This can be a customer ID, a cart ID, or similar, and can be used to reconcile the Session with your internal systems.

created

integer

optional

Time at which the object was created. Measured in seconds since the Unix epoch.

currency

string

optional

Three-letter ISO currency code

customer

string

optional

The ID of the customer for this Session.

customer_email

string

optional

If provided, this value will be used when the Customer object is created. If not provided, customers will be asked to enter their email address. Use this parameter to prefill customer data if you already have an email on file. To access information about the customer once the payment flow is complete, use the customer attribute.

expires_at

integer

optional

The timestamp at which the Checkout Session will expire. The Epoch time in seconds at which the Checkout Session will expire. It can be anywhere from 1 to 24 hours after Checkout Session creation. By default, this value is 24 hours from creation.

livemode

boolean

optional

Has the value true if the object exists in live mode or the value false if the object exists in test mode.

metadata

object

optional

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

mode

string

optional

The mode of the Checkout Session. Only payment is supported now.

payment_intent

string

optional

The ID of the PaymentIntent for Checkout Sessions in payment mode.

payment_link

string

optional

The ID of the Payment Link that created this Session.

payment_method_options

object (Payment Method Options)

optional

Payment-method-specific configuration for the PaymentIntent or SetupIntent of this CheckoutSession.

card

object

optional

alipayplus

object

optional

alipay_hk

object

optional

alipay

object

optional

wechat_pay

object

optional

sepa_debit

object

optional

akulaku

object

optional

truemoney

object

optional

kakaopay

object

optional

shopeepay

object

optional

dana

object

optional

pix

object

optional

payment_method_types

array[string]

optional

A list of the types of payment methods (e.g. card) this Checkout Session is allowed to accept.

payment_status

string

optional

The payment status of the Checkout Session, one of paid, unpaid, or no_payment_required. You can use this value to decide when to fulfill your customer’s order.

phone_number_collection

object

optional

Details on the state of phone number collection for the session. phone_number_collection.enabled boolean Indicates whether phone number collection is enabled for the session

enabled

boolean

optional

Indicates whether phone number collection is enabled for the session.

shipping_address_collection

object

optional

When set, provides configuration for Checkout to collect a shipping address from a customer.

allowed_countries

array[string]

optional

An array of two-letter ISO country codes representing which countries Checkout should provide as options for shipping locations.

shipping

object

optional

Shipping information for this Checkout Session.

address

object (Address)

optional

carrier

string

optional

The delivery service that shipped a physical product, such as FedEx, UPS, USPS, etc.

name

string

optional

Recipient name.

phone

string

optional

Recipient phone (including extension).

tracking_number

string

optional

The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.

status

enum<string>

optional

The status of the Checkout Session, one of open, complete, or expired.

Allowed values:

opencompleteexpired

success_url

string

optional

The URL the customer will be directed to after the payment or subscription creation is successful.

url

string

optional

The URL to the Checkout Session. Redirect customers to this URL to take them to Checkout.

line_items

object

optional

The line items purchased by the customer. This field is not included by default. To include it in the response, expand the line_items field.

object

string

optional

Default:

"list"

url

string

optional

has_more

boolean

optional

data

array [object {10}]

optional

customer_creation

enum<string>

optional

Configure whether a Checkout Session creates a Customer when the Checkout Session completes. Can only be set in payment and setup mode.

Allowed values:

alwaysif_required

customer_details

object

optional

address

object

optional

The customer’s address after a completed Checkout Session.

string | null

optional

The email associated with the Customer, if one exists, on the Checkout Session after a completed Checkout Session or at time of session expiry.

name

string | null

optional

The customer’s name after a completed Checkout Session.

phone

string | null

optional

The customer’s phone number after a completed Checkout Session.

Example

{
  "id": "string",
  "object": "string",
  "amount_subtotal": 0,
  "amount_total": 0,
  "billing_address_collection": "required",
  "cancel_url": "string",
  "client_reference_id": "string",
  "created": 0,
  "currency": "string",
  "customer": "string",
  "customer_email": "string",
  "expires_at": 0,
  "livemode": true,
  "metadata": {},
  "mode": "string",
  "payment_intent": "string",
  "payment_link": "string",
  "payment_method_options": {
    "card": {
      "request_three_d_secure": "any",
      "setup_future_usage": "on_session",
      "capture_method": "string",
      "tax_id": "string"
    },
    "alipayplus": {
      "terminal_type": "APP",
      "os_type": "IOS"
    },
    "alipay_hk": {
      "terminal_type": "APP",
      "os_type": "IOS"
    },
    "alipay": {
      "terminal_type": "APP",
      "os_type": "IOS"
    },
    "wechat_pay": {
      "terminal_type": "WEB",
      "client_ip": "string",
      "os_type": "IOS",
      "openid": "string"
    },
    "sepa_debit": {},
    "akulaku": {
      "terminal_type": "WEB",
      "os_type": "IOS"
    },
    "truemoney": {
      "terminal_type": "WEB",
      "os_type": "IOS"
    },
    "kakaopay": {
      "terminal_type": "WEB",
      "os_type": "IOS"
    },
    "shopeepay": {
      "terminal_type": "string",
      "os_type": "string"
    },
    "dana": {
      "terminal_type": "string",
      "os_type": "string"
    },
    "pix": {
      "tax_id": "string"
    }
  },
  "payment_method_types": [
    "string"
  ],
  "payment_status": "string",
  "phone_number_collection": {
    "enabled": true
  },
  "shipping_address_collection": {
    "allowed_countries": [
      "string"
    ]
  },
  "shipping": {
    "address": {
      "city": "string",
      "country": "string",
      "line1": "string",
      "line2": "string",
      "postal_code": "string",
      "state": "string"
    },
    "carrier": "string",
    "name": "string",
    "phone": "string",
    "tracking_number": "string"
  },
  "status": "open",
  "success_url": "string",
  "url": "string",
  "line_items": {
    "object": "\"list\"",
    "url": "string",
    "has_more": true,
    "data": [
      {
        "id": "string",
        "object": "string",
        "amount_subtotal": "string",
        "amount_total": "string",
        "currency": "string",
        "description": "string",
        "price": {
          "id": "string",
          "object": "string",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 0,
          "currency": "string",
          "livemode": true,
          "lookup_key": "string",
          "metadata": {},
          "nickname": "string",
          "product": "string",
          "type": "one_time",
          "unit_amount": 0,
          "recurring": {
            "interval": "day",
            "interval_count": 0,
            "usage_type": "licensed"
          },
          "tiers": [
            {
              "up_to": "string",
              "flat_amount": "string",
              "unit_amount": "string"
            }
          ]
        },
        "quantity": "string",
        "discounts": [
          {
            "id": "string",
            "object": "string",
            "checkout_session": "string",
            "coupon": {
              "id": "string",
              "amount_off": 0,
              "currency": "string",
              "duration_in_days": "string",
              "object": "string",
              "created": 0,
              "livemode": true,
              "metadata": {},
              "name": "string",
              "percent_off": 0,
              "max_redemptions": 0,
              "redeem_by": 0,
              "times_redeemed": 0,
              "valid": true,
              "currency_options": {
                "<currency>.amount_off": 0
              }
            },
            "customer": "string",
            "start": 0,
            "end": null,
            "promotion_code": null,
            "subscription": null
          }
        ],
        "amount_discount": 0
      }
    ]
  },
  "customer_creation": "always",
  "customer_details": {
    "address": {
      "city": "string",
      "country": "string",
      "line1": "string",
      "line2": "string",
      "postal_code": "string",
      "state": "string"
    },
    "email": "string",
    "name": "string",
    "phone": "string"
  }
}