Create Customer Session

Create a customer session to enroll and save payment methods for future use.

POST /customers/sessions

Create Customer Session

cURL

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"
}
'

201

Customer session

{
  "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"
}

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

application/json

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"