Skip to main content
GET
/
v1
/
terminal
/
sessions
/
{id}
Fetch Terminal Payment Session
curl --request GET \
  --url https://terminal-dev.xendit.co/v1/terminal/sessions/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "payment_session_id": "<string>",
  "latest_payment_id": "<string>",
  "business_id": "<string>",
  "reference_id": "ref_123456789",
  "session_type": "PAY",
  "currency": "IDR",
  "amount": 2,
  "country": "ID",
  "mode": "TERMINAL",
  "status": "ACTIVE",
  "channel_properties": {
    "terminal_id": "abcd-3254fsd-3242",
    "order_id": "order-12345",
    "payment_methods": [
      "ID_INSERT_CARD"
    ]
  },
  "created": "2024-11-06T15:32:42Z",
  "updated": "2024-11-06T15:32:42Z",
  "customer_id": "cus_123456789",
  "description": "Payment for order #123",
  "metadata": {},
  "canceled_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
id
string
required

Terminal Payment Session ID

Response

Terminal Payment Session fetched successfully

​
payment_session_id
string
required
​
latest_payment_id
string
required
​
business_id
string
required
​
reference_id
string
required
Example:

"ref_123456789"

​
session_type
enum<string>
required
Available options:
PAY
​
currency
enum<string>
required
Available options:
IDR,
VND,
THB
​
amount
number<decimal>
required
Required range: x >= 1
​
country
enum<string>
required
Available options:
ID,
VN,
TH
​
mode
enum<string>
required
Available options:
TERMINAL
​
status
enum<string>
required
Available options:
ACTIVE,
COMPLETED,
FAILED,
CANCELED
​
channel_properties
object
required
​
created
string<date-time>
required
Example:

"2024-11-06T15:32:42Z"

​
updated
string<date-time>
required
Example:

"2024-11-06T15:32:42Z"

​
customer_id
string
Example:

"cus_123456789"

​
description
string | null
Example:

"Payment for order #123"

​
metadata
object
​
canceled_at
string<date-time> | null