Elements

Create a new Checkout Element

Create a new Checkout Element with specified offers. Checkout Elements are embeddable or hosted checkout experiences that can be integrated into your website or application. They handle the entire checkout flow including payment collection, tax calculation, and order creation. Supported configurations: - Single one-time purchase: One offer for a standard product - Multiple one-time purchases: Multiple offers in a cart - Subscription: One subscription offer (cannot be combined with other offers)

Authorization

Public key Secret key
x-fngs-public-key<token>

In: header

x-fngs-secret-key<token>

In: header

Request Body

application/json

POST /v0/elements/checkout/create Request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

POST
/v0/elements/checkout/create
curl -X POST "https://example.com/v0/elements/checkout/create" \  -H "Content-Type: application/json" \  -d '{    "offersIds": [      "f090d17a-069e-41fa-b41a-173653e37ce2"    ]  }'
{  "status": "success",  "data": {    "checkoutElement": {      "object": "checkoutElement",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": null,      "status": "ACTIVE",      "subscriptionOffer": false,      "offers": [        {          "object": "offer",          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "internalId": null        }      ]    }  }}

Archive a discount PATCH

Archive (soft delete) a discount by its ID. Archived discounts can no longer be used at checkout but remain in the system for reporting purposes. This action is reversible.

List checkout elements GET

Retrieve a paginated list of checkout elements. Returns all checkout elements created for your workspace, including their associated offers and configuration settings. Results are sorted by creation date (newest first).