Skip to content
ParaSta Docs

Create a Checkout Session

POST
/v1/checkout/sessions
 
curl --request POST \
  --url https://api.parasta.io/v1/checkout/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "line_items": [ { "name": "T-shirt", "amount": 10000000, "currency": "USDT", "quantity": 1 } ], "success_url": "https://your-site.com/success?session_id={CHECKOUT_SESSION_ID}", "cancel_url": "https://your-site.com/cancel", "customer_email": "customer@example.com", "settlement": { "mode": "krw", "krw_account": "kacct_abc123" }, "metadata": { "order_id": "order_4567" } }'

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
object
line_items
required
Array<object>
>= 1 items
object
name
required
string
amount
required
integer format: int64
currency
required
string
Allowed values: USDT USDC ETH SOL
quantity
integer
default: 1
success_url
required
string format: uri
cancel_url
required
string format: uri
customer_email
string format: email
settlement
object
mode
required

Coin = keep crypto; krw = exchange to KRW at confirmation; splits = mixed

string
Allowed values: coin krw splits
krw_account

Required when mode=krw

string
splits
Array<object>
object
destination
required
string
Allowed values: coin krw
percent
required
number
<= 100
metadata
object
key
additional properties
string
Example 
{
  "line_items": [
    {
      "name": "T-shirt",
      "amount": 10000000,
      "currency": "USDT",
      "quantity": 1
    }
  ],
  "success_url": "https://your-site.com/success?session_id={CHECKOUT_SESSION_ID}",
  "cancel_url": "https://your-site.com/cancel",
  "customer_email": "customer@example.com",
  "settlement": {
    "mode": "krw",
    "krw_account": "kacct_abc123"
  },
  "metadata": {
    "order_id": "order_4567"
  }
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Created

Media type application/json
object
id
required
string
status
required
string
Allowed values: open complete expired
url
required
string format: uri
line_items
Array<object>
object
name
required
string
amount
required
integer format: int64
currency
required
string
Allowed values: USDT USDC ETH SOL
quantity
integer
default: 1
success_url
string format: uri
cancel_url
string format: uri
customer_email
string format: email
payment_id
string | null
expires_at
required
string format: date-time
created
string format: date-time
Example 
{
  "id": "cs_abc123",
  "status": "open",
  "line_items": [
    {
      "currency": "USDT",
      "quantity": 1
    }
  ]
}