POST
/
checkout
/
sessions

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Subaccount-Id
string

If present, scopes the operation to the subaccount with given id. See Subaccounts for more info.

Body

application/json
amount_kg
number
required

Amount of carbon credits to be purchased upon checkout completion, in kilograms

success_url
string
required

The URL the customer will be redirected to after the payment is completed. The {CHECKOUT_SESSION_ID} template can be used to include the session id in a query parameter. Make sure to include the template exactly as {CHECKOUT_SESSION_ID} (i.e. do not replace it with the actual session id).

cancel_url
string
required

The URL the customer will be directed to if they decide to cancel payment and return to your website

portfolio_id
string | null

Optional id of the portfolio to use for fulfilling the order resulting from the Checkout Session. If not specified, the user or subaccount's default portfolio will be used (depending on if a subaccount is provided).

description
string | null

Optional public description for the order that will be shown on the certificate, as provided when order was placed

Maximum length: 512
notification_config
object | null

Optional configuration for a callback url to invoke with updates when the status of an order changes.

Response

201 - application/json
id
string

Identifier that can be used to retrieve the Checkout Session

amount_kg
number

Amount of carbon credits to be purchased upon checkout completion, in kilograms

price_usd_cents
number

Total price to be charged upon checkout completion, in USD cents

success_url
string

URL the customer will be redirected to after they complete Checkout.

cancel_url
string

URL the customer will be redirected to if they click the "back" button in Checkout.

checkout_url
string

URL to the Checkout Session. Redirect the customer to this URL to take them to Checkout.

state
string

The status of the Checkout Session, one of open, complete, or expired.

  • open - The checkout session is still in progress. Payment processing has not started.
  • complete - The checkout session is complete. Payment processing may still be in progress.
  • expired - The checkout session has expired. No further processing will occur.
expires_on
string

Timestamp of when the session will expire.

completed_on
string | null

Timestamp of when the session was completed. Null if session has not been completed.

portfolio_id
string

Id of the portfolio the customer will purchase from when completing Checkout.

subaccount_id
string | null

Id of the subaccount associated with the customer

order_description
string | null

Description to be associated with the order created from this session.

order_webhook_url
string | null

Webhook URL for updates to the order created from this session.