> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Object

Checkout session entity field reference.

| Field                    | Type               | Desc                                                                                                                                                                                                              |
| ------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                       | int                | Checkout session ID                                                                                                                                                                                               |
| access\_no               | string             | Third-party access number                                                                                                                                                                                         |
| merchant\_id             | string             | Merchant unique identifier                                                                                                                                                                                        |
| order\_id                | string             | Third-party order number                                                                                                                                                                                          |
| trade\_id                | string             | Trade ID                                                                                                                                                                                                          |
| customer                 | Customer           | Customer information                                                                                                                                                                                              |
| status                   | string             | Checkout session status:<br />open: Created successfully<br />expire: Expired<br />complete: Transaction completed                                                                                                |
| expire\_time             | int                | Validity period (seconds), expiration time can be calculated by adding validity period to creation time                                                                                                           |
| return\_url              | string             | Payment success redirect URL                                                                                                                                                                                      |
| cancel\_url              | string             | Cancel payment redirect URL                                                                                                                                                                                       |
| callback\_url            | string             | Webhook notification URL                                                                                                                                                                                          |
| session\_url             | string             | Checkout page URL                                                                                                                                                                                                 |
| mode                     | string             | Payment mode, used to determine whether to validate product information:<br />checkout: Validate product data, default value<br />payment: Do not validate product data                                           |
| total\_amount            | string             | Total amount                                                                                                                                                                                                      |
| integration\_method      | string             | Integration mode:<br />hosted: Hosted, default mode<br />embedded: Embedded integration                                                                                                                           |
| redirect\_on\_completion | string             | Redirect behavior for embedded UI mode<br />always: Automatically redirect to `return_url` after successful payment<br />if\_required: Only redirect to `return_url` for payment methods that require redirection |
| created\_at              | string             | Creation time                                                                                                                                                                                                     |
| payment\_token           | string             | Payment token returned for subscription payment, used for subsequent subscription renewals                                                                                                                        |
| metadata                 | map\[string]string | A set of key-value pairs that can be attached to an object, allowing you to store additional information in a structured format.                                                                                  |

## Customer

| Field     | Type   | Desc                    |
| :-------- | :----- | :---------------------- |
| id        | string | Customer ID             |
| payer\_id | string | Third-party customer ID |
| email     | string | Customer email          |