Create payment intent

Validates the cart and creates a payment intent with the payment processor. Returns an atlas_pay_url — redirect the diner there to complete payment.

If a pending intent already exists for the same amount, it is returned instead of creating a duplicate.

After payment: Once the diner completes payment on the hosted page, they are redirected back to your application. At that point, call POST /cart/order to validate the payment and convert the cart to an order. Do NOT wait for webhooks — POST /cart/order checks payment status in real-time.

POST /payment_intents

Create payment intent

cURL

curl --request POST \
  --url https://api.atlas.kitchen/storefronts/v1/payment_intents \
  --header 'X-Channel-Id: <api-key>' \
  --header 'X-Session-Id: <api-key>'

200

{
  "amount": 2490,
  "tip": 0,
  "status": "pending",
  "atlas_pay_url": "https://pay.atlas.kitchen/intent/ab2c8505-c7bc-40ea-9f54-97774ce347b5",
  "currency": "SGD"
}

Authorizations

X-Channel-Id · string · header · required

Merchant storefront identifier. Provided during onboarding.

X-Session-Id · string · header · required

Diner session identifier. Created by GET /channel and returned in the X-Session-Id response header.

Response

200

application/json

Payment intent with checkout URL

amount · integer

Amount in cents

tip · integer

status · enum<string>

Available options: pending, processing, capturing, succeeded, failed, cancelled

atlas_pay_url · string | null

URL where the diner completes payment

currency · string

Example:

"SGD"