v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-011518127.5 KB

Hosted Checkout

Get a Session

Retrieves the details of a payment session by its ID. This is the recommended way to check the final status of a payment after the customer is redirected back to your site.

get/checkout/v1/sessions/{id}

Path parameters

idstring required

Example:sess_a1b2c3d4e5f6

The Session ID (e.g., sess_a1b2c3d4e5f6)

Response

Session retrieved successfully

idstring

Unique session identifier

urlstring uri

Redirect your customer to this URL to begin the payment

status'pending' | 'completed' | 'expired'

Session status

payment_idnumber

Associated payment ID

amount_totalnumber

Total amount to be charged

currencystring

Currency used

expires_atinteger

Expiration time (Unix timestamp in seconds)

external_idstring

Order reference from the merchant

session_typestring

Type of session

checkout_typestring

Checkout method

success_urlstring uri nullable

Success redirect URL

return_urlstring uri

Return/fallback redirect URL

pending_urlstring uri nullable

Pending redirect URL

metadataobject

Custom data sent by the merchant

payment_method_typesstring[]

Allowed payment methods

ui_configobject

UI configuration applied

ui_config_versionstring

Version of UI config

created_atinteger

Creation timestamp in milliseconds

modified_atinteger

Last modification timestamp in milliseconds

paid_atinteger nullable

Payment completion timestamp in milliseconds

transaction_status'Pending' | 'Success' | 'Declined' | 'Expired'

Result of transaction

providerstring

Gateway used

Example response

{
  "id": "cs_97_41521_d11ba771527b4056c7f85786cfbb980bc105efaf42af113d",
  "url": "https://stage-payflow.tonder.io/checkout/cs_97_41521_d11ba771527b4056c7f85786cfbb980bc105efaf42af113d",
  "status": "pending",
  "payment_id": 41521,
  "amount_total": 35000,
  "currency": "MXN",
  "expires_at": 1751564943,
  "external_id": "ORD-12345",
  "session_type": "payment",
  "checkout_type": "hosted",
  "payment_method_types": [
    "card"
  ],
  "ui_config_version": "V1",
  "created_at": 1751478543567,
  "modified_at": 1751478543567,
  "customer": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  },
  "transaction_status": "Pending",
  "provider": "tonder"
}