Create Seller - Yuno API Documentation

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

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

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

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

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

string<email>

phone

object

Show child attributes

document

object

Show child attributes

address

object

Show child attributes

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[]

Show child attributes

Response

Created

seller_id

string<uuid>

merchant_seller_id

string

name

string

phone

object

Show child attributes

document

object

Show child attributes

address

object

Show child attributes

country

string

Required string length: 2

website

string

industry

string

merchant_category_code

string

Required string length: 4

payment_methods

object[]

Show child attributes

created_at

string<date-time>

updated_at

string<date-time>