Virtual Sellers
If you send your seller data in the same requests as your transactions, these type of sellers are known as virtual sellers. Their details are stored with the transactions.
You can also use the Seller API to create sellers first that you later reference in your transaction requests (using the seller_code). You can use this API to create your own UIs for seller creation. For more information, see Non-Virtual Sellers.
Restrictions
The following restrictions apply:
- Virtual sellers cannot access the dashboard.
- Their details are not stored in the dedicated sellers' database.
- You cannot use the Sellers API with virtual sellers.
Example Request
The following example contains both transaction and seller details:
{
"transaction": {
"currency_code": "USD",
"buyer_name": "Test buyer",
"ship_to_address": {
"country_code": "US",
"country_subdivision_code": "FL"
},
"transaction_lines": [
{
"amount": 502,
"custom_id": "line_1",
"ship_from_address": {
"country_code": "PL"
},
"product_class": "P",
"seller_code": "seller-1"
},
{
"total_amount": 500,
"custom_id": "line_1",
"ship_from_address": {
"country_code": "US",
"country_subdivision_code": "FL"
},
"product_class": "P",
"seller_code": "seller-1"
}
],
"sellers": [
{
"seller_code": "seller-1",
"country": "US",
"settings": {
"countries": {
"PL": {
"taxation": {
"physical": {
"is_physical_tax-enabled": true,
"is_seller_registered": true,
"seller_tax_number": "PL"
}
}
},
"US": {
"taxation": {
"physical": {
"is_physical_tax-enabled": true,
"is_seller_registered": true,
"seller_tax_number": "US"
}
},
"country_subdivisions": {
"FL": {
"taxation": {
"physical": {
"has_physical_presence": true,
"is_seller_registered": true,
"seller_tax_number": "ABCD1234"
}
}
}
}
}
},
"regions": {
"EU": {
"taxation": {
"physical": {
"is_seller_located_within_region": true
}
}
},
"US": {
"taxation": {
"physical": {
"is_seller_located_within_region": true
}
}
}
}
}
}
]
}
}
Example Response
This results in the following response:
{
"transaction": {
"ship_to_address": {
"country_subdivision_code": "FL",
"country_code": "US",
"tax_region": "US"
},
"amount": 969.29,
"required_fields": {
"tax_required_fields": [],
"audit_required_fields": [],
"storage_required_fields": []
},
"tax_country_codes": "US",
"tax_amount": 67.85,
"invoice_timestamp": "2022-10-17T13:33:30Z",
"tax_liability_owner_codes": "",
"countries": {},
"transaction_lines": [
{
"reverse_charge": false,
"amount": 502.00,
"tax_rule_applied": "physical-tax",
"unit_price": 502.00,
"taxes": [
{
"tax_jurisdiction_code": "5286",
"tax_base_amount": 502,
"tax_jurisdiction_type": "STATE",
"tax_country_subdivision_code": "FL",
"rate": 6,
"tax_authority_name": "FLORIDA",
"tax_authority_id": "5286",
"tax_name": "Sales and Use Tax",
"amount_fraction_taxable": 1
},
{
"tax_jurisdiction_code": "5287",
"tax_base_amount": 502,
"tax_jurisdiction_type": "COUNTY",
"tax_country_subdivision_code": "FL",
"rate": 1,
"tax_authority_name": "ALACHUA",
"tax_authority_id": "5287",
"tax_name": "Local Sales and Use Tax (Discretionary Sales Surtax)",
"amount_fraction_taxable": 1
}
],
"tax_amount": 35.14,
"platform_liability_assumed_amount": 502.00,
"seller_tax_number": "US",
"tax_region": "US",
"tax_exempt": false,
"tax_country_code": "US",
"tax_country_subdivision_code": "FL",
"line_key": "uDnIbobXpuE3H873",
"discounts": [],
"custom_id": "line_1",
"tax_address_kind": "ship_to_address",
"ship_from_address": {
"country_code": "PL",
"tax_region": "EU"
},
"tax_engine": "oseries",
"invoice_status": "F",
"kind": "b2c",
"product_class": "P",
"line_num": 1,
"is_seller_permanent": false,
"quantity": 1.000000000000,
"invoice_capable": false,
"total_amount": 537.14,
"seller_code": "seller-1",
"tax_entity_name": "US",
"tax_supported": true
},
{
"reverse_charge": false,
"amount": 467.29,
"tax_rule_applied": "physical-tax",
"unit_price": 467.29,
"taxes": [
{
"tax_jurisdiction_code": "5286",
"tax_base_amount": 467.289719626168,
"tax_jurisdiction_type": "STATE",
"tax_country_subdivision_code": "FL",
"rate": 6,
"tax_authority_name": "FLORIDA",
"tax_authority_id": "5286",
"tax_name": "Sales and Use Tax",
"amount_fraction_taxable": 1
},
{
"tax_jurisdiction_code": "5287",
"tax_base_amount": 467.289719626168,
"tax_jurisdiction_type": "COUNTY",
"tax_country_subdivision_code": "FL",
"rate": 1,
"tax_authority_name": "ALACHUA",
"tax_authority_id": "5287",
"tax_name": "Local Sales and Use Tax (Discretionary Sales Surtax)",
"amount_fraction_taxable": 1
}
],
"tax_amount": 32.71,
"platform_liability_assumed_amount": 500.00,
"seller_tax_number": "US",
"tax_region": "US",
"tax_exempt": false,
"tax_country_code": "US",
"tax_country_subdivision_code": "FL",
"line_key": "186E2-g6YZaVp_Rr",
"discounts": [],
"custom_id": "line_1",
"tax_address_kind": "ship_to_address",
"ship_from_address": {
"country_subdivision_code": "FL",
"country_code": "US",
"tax_region": "US"
},
"tax_engine": "oseries",
"invoice_status": "F",
"kind": "b2c",
"product_class": "P",
"line_num": 2,
"is_seller_permanent": false,
"quantity": 1.000000000000,
"invoice_capable": false,
"total_amount": 500.00,
"seller_code": "seller-1",
"tax_entity_name": "US",
"tax_supported": true
}
],
"discounts": [],
"location_evidence": {},
"product_classes": "P",
"billing_address": {
"country_subdivision_code": "FL",
"country_code": "US",
"tax_region": "US"
},
"sellers": [
{
"settings": {
"countries": {
"PL": {
"taxation": {
"physical": {
"is_seller_registered": true,
"is_physical_tax_enabled": true,
"seller_tax_number": "PL"
}
}
},
"US": {
"taxation": {
"physical": {
"is_seller_registered": true,
"is_physical_tax_enabled": true,
"seller_tax_number": "US"
}
},
"country_subdivisions": {
"FL": {
"taxation": {
"physical": {
"is_seller_registered": true,
"seller_tax_number": "ABCD1234",
"has_physical_presence": true
}
}
}
}
}
},
"regions": {
"EU": {
"taxation": {
"physical": {
"is_seller_located_within_region": true
}
}
},
"US": {
"taxation": {
"physical": {
"is_seller_located_within_region": true
}
}
}
}
},
"seller_code": "seller-1",
"country": "US"
}
],
"buyer_name": "Test buyer",
"tax_timestamp": "2022-10-17T13:33:30Z",
"total_amount": 1037.14,
"currency_code": "USD"
}
}
Updated about 1 year ago