Skip to main content
POST
/
storefront
/
payments
/
confirm
Confirm Payment (TossPayments)
curl --request POST \
  --url https://api.headlesscommerce.io/v1/storefront/payments/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment_key": "<string>",
  "order_id": "<string>",
  "amount": 123,
  "provider": "tosspayments"
}
'
{
  "success": true,
  "order_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

API Key. Example: sk_live_xxxxx or pk_live_xxxxx

Body

application/json
​
payment_key
string
required

Payment key returned by TossPayments SDK after user approval

​
order_id
string
required

Order ID from checkout response (toss_payment.order_id)

​
amount
integer
required

Payment amount — must match the order total

​
provider
string
default:tosspayments

Payment provider name

Response

Success

​
success
boolean
​
order_id
string