Skip to main content
POST
/
sellers
curl --request POST \
  --url https://api-sandbox.y.uno/v1/sellers \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <private-secret-key>' \
  --header 'public-api-key: <public-api-key>' \
  --data '
{
  "account_id": "8a1c0e7f-4f2d-4bc7-9e1a-2c4d6f8a1b22",
  "merchant_seller_id": "FRANCHISE_STORE_001",
  "name": "Franchise Store New York",
  "email": "store001@franchise.com",
  "phone": {
    "code": "+1",
    "number": "2125550100"
  },
  "document": {
    "type": "EIN",
    "number": "12-3456789"
  },
  "address": {
    "line_1": "350 Fifth Avenue",
    "line_2": "Suite 101",
    "city": "New York",
    "state": "NY",
    "country": "US",
    "zip_code": "10118"
  },
  "country": "US",
  "merchant_category_code": "5812",
  "payment_methods": [
    {
      "provider_id": "STRIPE",
      "payment_method_type": "CARD",
      "merchant_id": "acct_1A2B3C4D5E"
    }
  ]
}
'
{
  "seller_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "merchant_seller_id": "FRANCHISE_STORE_001",
  "name": "Franchise Store New York",
  "email": "store001@franchise.com",
  "phone": {
    "code": "+1",
    "number": "2125550100"
  },
  "document": {
    "type": "EIN",
    "number": "12-3456789"
  },
  "address": {
    "line_1": "350 Fifth Avenue",
    "line_2": "Suite 101",
    "city": "New York",
    "state": "NY",
    "country": "US",
    "zip_code": "10118"
  },
  "country": "US",
  "website": null,
  "industry": null,
  "merchant_category_code": "5812",
  "payment_methods": [
    {
      "provider_id": "STRIPE",
      "payment_method_type": "CARD",
      "merchant_id": "acct_1A2B3C4D5E",
      "wallet_details": null
    }
  ],
  "created_at": "2026-05-07T10:00:00Z",
  "updated_at": "2026-05-07T10:00:00Z"
}

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 new franchise seller mapping. A seller is created under a specific account_code, but is available organization-wide.
Each (provider.id, payment_method_type) combination must be unique within the payment_method array.

Headers

​
public-api-key
string
required
​
private-secret-key
string
required

Body

application/json
​
account_id
string<uuid>
required
​
merchant_seller_id
string
required
Required string length: 1 - 255
​
name
string
Required string length: 1 - 255
​
email
string<email>
​
phone
object
​
document
object
​
address
object
​
country
string

ISO 3166-1 alpha-2 country code.

Required string length: 2
​
website
string
​
industry
string
​
merchant_category_code
string
Required string length: 4
​
payment_methods
object[]

Response

Created

​
seller_id
string<uuid>
​
merchant_seller_id
string
​
name
string
​
email
string
​
phone
object
​
document
object
​
address
object
​
country
string
Required string length: 2
​
website
string
​
industry
string
​
merchant_category_code
string
Required string length: 4
​
payment_methods
object[]
​
created_at
string<date-time>
​
updated_at
string<date-time>