Easy Labs
ReferenceAPI ReferencePaymentsCheckout

Create a checkout session

Create a new checkout session for payment collection

POST
/v1/api/checkout/

Authorization

apiKey
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://loading/v1/api/checkout/" \  -H "Content-Type: application/json" \  -d '{    "customer_creation": false,    "identity_id": "IDxxxxxxxxxxxxxxxxxx",    "source": {      "type": "PAYMENT_CARD",      "tokenId": "tok_abc123",      "name": "John Doe",      "address": {        "postal_code": "94105"      }    },    "line_items": [      {        "price_id": "price_abc123",        "quantity": 1      }    ],    "metadata": {      "order_ref": "ORD-001"    }  }'
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "message": "Checkout session created",
  "data": {
    "transfer": {
      "id": "TRxxxxxxxxxxxxxxxx",
      "amount": 1000,
      "currency": "USD",
      "state": "PENDING"
    },
    "orderId": "ORD-001",
    "subscriptions": []
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}

List authorizations

Retrieve a list of authorizations for the merchant. `expand=full` joins merchants + payment_instruments + identities for the dashboard list view.

Get checkout slug

Returns the company's checkout slug and the branded URLs ({slug}.easy-checkout.link, {slug}.easy-payment.link, {slug}.easy-portal.link).