Proceed with payment via checkout session

post

https://api.superpayments.com/2026-04-01/checkout-sessions/{checkoutSessionId}/proceed

Processes a payment using an existing checkout session. Requires the payment initiator ID and session details.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

checkoutSessionId

string

required

Body Params

paymentInitiatorId

uuid

required

The ID of the payment initiator

amount

integer

required

The payment amount in the smallest currency unit (e.g., pence for GBP)

currency

const

enum

required

The currency code

Allowed:

successUrl

uri

required

URL to redirect the user after successful payment

failureUrl

uri

required

URL to redirect the user after failed payment

cancelUrl

uri

required

URL to redirect the user after cancelled payment

externalReference

string | null

External reference for the payment

metadata

object

Custom metadata for the payment (max 10 key-value pairs, keys 1-30 chars, values 1-200 chars)

shippingAddress

object

Address with all fields optional

billingAddress

object

Address with all fields optional

lineItems

array of objects | null

Array of line items, each being either airline, car rental, lodging, or product data

lineItems

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Payment processed successfully

400Bad Request

401Unauthorized

402Payment Required

403Forbidden

404NotFound

409Conflict

500Internal Server Error