Skip to main content
POST
/
customers
/
sessions
Create Customer Session
curl --request POST \
  --url https://api-sandbox.y.uno/v1/customers/sessions \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "account_id": "8beac4de-5f6f-11ed-9b6a-0242ac120002",
  "customer_id": "ae106483-65ee-463b-8782-9794022b3112",
  "country": "US",
  "callback_url": "https://www.google.com/?customerSession=7dd71f21-9e4c-439a-9c6d-58f240bd28df",
  "created_at": "2025-05-07T20:00:18.721786Z"
}
'
{
  "customer_session": "7dd71f21-9e4c-439a-9c6d-58f240bd28df",
  "customer_id": "ae106483-65ee-463b-8782-9794022b3112",
  "country": "US",
  "callback_url": "https://www.google.com/?customerSession=7dd71f21-9e4c-439a-9c6d-58f240bd28df",
  "created_at": "2025-05-07T20:00:18.721786Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

Creates a customer session for enrolling and managing payment methods. Use this to save cards, wallets, and other payment methods for future use. Requires a customer_id from Create Customer .

Authorizations

​
public-api-key
string
header
default:<Your public-api-key>
required
​
private-secret-key
string
header
default:<Your private-secret-key>
required

Body

application/json
​
account_id
string
required

The unique identifier of the account. You find this information on the Yuno dashboard (UUID, 36 chars).

​
country
enum<string>
required

The customer's country (MAX 2; MIN 2; ISO 3166-1).

Available options:
AR,
BO,
BR,
CL,
CO,
CR,
EC,
SV,
GT,
HN,
MX,
NI,
PA,
PY,
PE,
US,
UY
​
customer_id
string
required

The unique identifier of the customer, created using the Create Customer endpoint (UUID, 36 chars).

​
callback_url
string

The url to redirect your customer after the enrollment is made in the provider's environment (MAX 526; MIN 3).

Response

201

​
customer_session
string
Example:

"7dd71f21-9e4c-439a-9c6d-58f240bd28df"

​
customer_id
string
Example:

"ae106483-65ee-463b-8782-9794022b3112"

​
country
string
Example:

"US"

​
callback_url
string
Example:

"https://www.google.com/?customerSession=7dd71f21-9e4c-439a-9c6d-58f240bd28df"

​
created_at
string
Example:

"2025-05-07T20:00:18.721786Z"