Create Customer Session

Creates a new customer session for SDK initialization, enabling one-click payments and saved payment methods.

POST /v1/customer-sessions

Create customer session

cURL

curl --request POST \
  --url https://api-sandbox.y.uno/v1/customer-sessions \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "customer_id": "c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f"
}
'

201

{
  "id": "cs_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "customer_id": "c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
  "status": "ACTIVE",
  "sdk_token": "sdk_tok_abc123def456",
  "expires_at": "2026-03-01T15:30:00.000Z",
  "created_at": "2026-03-01T14:30:00.000Z"
}

Creates a session for enrolling payment methods without initiating a payment.

Authorizations

public-api-key · string · header · required

Your public API key from the Yuno Dashboard

private-secret-key · string · header · required

Your private secret key (server-side only)

Body

application/json

customer_id · string<uuid> · required

The customer to create a session for

Example:

"c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f"

merchant_customer_id · string

Alternative: your internal customer identifier

Example:

"cust-internal-001"

Response

201

application/json

Customer session created successfully

id · string<uuid>

Example:

"cs_a1b2c3d4-e5f6-7890-abcd-ef1234567890"

customer_id · string<uuid>

Example:

"c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f"

status · enum<string>

Available options: ACTIVE, EXPIRED

Example:

"ACTIVE"

sdk_token · string

Token for SDK initialization

Example:

"sdk_tok_abc123def456"

expires_at · string<date-time>

Example:

"2026-03-01T15:30:00.000Z"

created_at · string<date-time>

Example:

"2026-03-01T14:30:00.000Z"