Countries where No Tax Information is Returned

The service does not return any tax information for the following countries and regions. If liability is assigned to one of these, the service will return no information. This is indicated by fields such as "tax_amount": 0.

  • Afghanistan (AF)
  • Anguilla (AI)
  • Aland Islands (AX)
  • Saint Barthelemy (BL)
  • Bermuda (BM)
  • Brunei (BN)
  • Caribbean Netherlands (BQ)
  • Bouvet Island (BV)
  • Cocos (CC)
  • Christmas Islands (CX)
  • Western Sahara (EH)
  • Falkland Islands (FK)
  • French Guiana (GF)
  • Guernsey (GG)
  • Gibraltar (GI)
  • Greenland (GL)
  • South Georgia (GS)
  • Hong Kong (HK)
  • British Indian Ocean Territory (IO)
  • Iraq (IQ)
  • North Korea (KP)
  • Kuwait (KW)
  • Cayman Islands (KY)
  • Libya (LY)
  • Macau (MO)
  • Montserrat (MS)
  • Norfolk Islands (NF)
  • Nauru (NR)
  • Saint Pierre (PM)
  • Pitcairn (PN)
  • Palau (PW)
  • Qatar (QA)
  • Saint Helena (SH)
  • Svalbard (SJ)
  • San Marino (SM)
  • Somalia (SO)
  • Syria (SY)
  • Turks and Caicos Islands (TC)
  • French Southern and Antarctic Lands (TF)
  • Tokelau (TK)
  • Timor-Leste (TL)
  • Vatican City (VA)
  • British Virgin Islands (VG)
  • Wallis and Futuna (WF)
  • Samoa (WS)
  • Mayotte (YT)

Afghanistan Example

The following request is sent represents a seller who is in Afghanistan:

{"transaction":
    {"currency_code":     "USD",
     "buyer_name":        "Test buyer",
     "ship_to_address":
     {"country_code": "AF"},
      "sellers": [
          {
              "seller_code": "seller-1",
              "settings": {
                "countries": {
                    "AF": {
                        "taxation": {
                            "physical": {
                                "is_seller_registered": true,
                                "is_physical_tax_enabled": true
                            }
                            
                        }
                    }
                }
              }
          }
      ],
     "transaction_lines": [
         {
             "amount":            50003,
             "discounts":         [
                 {"discount_amount": 3,
                  "discount_code": "line-discount-1"}
             ],
             "quantity":          1,
             "custom_id":         "line_1",
             "seller_code":       "seller-1",
             "ship_from_address": {
                 "country_code": "AF"
             },
             "product_class":     "P"
         }
         ]}}

This returns the following response:

{
    "transaction": {
        "ship_to_address": {
            "country_code": "AF",
            "tax_region": "AF"
        },
        "amount": 50000.00,
        "required_fields": {
            "tax_required_fields": [],
            "audit_required_fields": [],
            "storage_required_fields": []
        },
        "tax_country_codes": "AF",
        "tax_amount": 0,
        "invoice_timestamp": "2022-11-10T10:43:41Z",
        "tax_liability_owner_codes": "",
        "countries": {},
        "transaction_lines": [
            {
                "reverse_charge": false,
                "amount": 50000.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 50000.000000000000,
                "taxes": [],
                "platform_liability_assumed_amount": 50000.00,
                "tax_region": "AF",
                "tax_exempt": true,
                "tax_country_code": "AF",
                "line_key": "YnUYHhJePGro-yx9",
                "discounts": [
                    {
                        "discount_code": "line-discount-1",
                        "discount_amount": 3.00,
                        "discount_total_amount": 3.00
                    }
                ],
                "custom_id": "line_1",
                "discounted_total_amount": 3.00,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "AF",
                    "tax_region": "AF"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "product_class": "P",
                "line_num": 1,
                "is_seller_permanent": false,
                "quantity": 1.000000000000,
                "invoice_capable": false,
                "total_amount": 50000.00,
                "seller_code": "seller-1",
                "tax_entity_name": "Afghanistan",
                "discounted_amount": 3.00,
                "tax_supported": true
            }
        ],
        "discounts": [],
        "location_evidence": {},
        "product_classes": "P",
        "billing_address": {
            "country_code": "AF",
            "tax_region": "AF"
        },
        "sellers": [
            {
                "settings": {
                    "countries": {
                        "AF": {
                            "taxation": {
                                "physical": {
                                    "is_seller_registered": true,
                                    "is_physical_tax_enabled": true
                                }
                            }
                        }
                    }
                },
                "seller_code": "seller-1"
            }
        ],
        "buyer_name": "Test buyer",
        "tax_timestamp": "2022-11-10T10:43:41Z",
        "total_amount": 50000.00,
        "currency_code": "USD"
    }
}

Hong Kong Example

The following request represents a transaction from a seller who is based in Hong Kong:

{"transaction":
    {"currency_code":     "PLN",
     "buyer_name":        "Test buyer",
     "ship_to_address":
     {"country_code": "HK"},
      "sellers": [
          {
              "seller_code": "seller-1",
              "settings": {
                "countries": {
                    "HK": {
                        "taxation": {
                            "physical": {
                                "is_seller_registered": true,
                                "is_physical_tax_enabled": true
                            }
                            
                        }
                    }
                }
              }
          }
      ],
     "transaction_lines": [
         {
             "amount":            50003,
             "discounts":         [
                 {"discount_amount": 3,
                  "discount_code": "line-discount-1"}
             ],
             "quantity":          1,
             "custom_id":         "line_1",
             "seller_code":       "seller-1",
             "ship_from_address": {
                 "country_code": "PL"
             },
             "product_class":     "P"
         }
         ]}}

The service returns the following response:

{
    "transaction": {
        "ship_to_address": {
            "country_code": "HK",
            "tax_region": "HK"
        },
        "amount": 50000.00,
        "required_fields": {
            "tax_required_fields": [],
            "audit_required_fields": [],
            "storage_required_fields": []
        },
        "tax_country_codes": "HK",
        "tax_amount": 0,
        "invoice_timestamp": "2022-11-10T10:46:54Z",
        "tax_liability_owner_codes": "",
        "countries": {},
        "transaction_lines": [
            {
                "reverse_charge": false,
                "amount": 50000.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 50000.000000000000,
                "taxes": [],
                "platform_liability_assumed_amount": 50000.00,
                "tax_region": "HK",
                "tax_exempt": true,
                "tax_country_code": "HK",
                "line_key": "iLB6_ft_JMSnspEj",
                "discounts": [
                    {
                        "discount_code": "line-discount-1",
                        "discount_amount": 3.00,
                        "discount_total_amount": 3.00
                    }
                ],
                "custom_id": "line_1",
                "discounted_total_amount": 3.00,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "PL",
                    "tax_region": "EU"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "product_class": "P",
                "line_num": 1,
                "is_seller_permanent": false,
                "quantity": 1.000000000000,
                "invoice_capable": false,
                "total_amount": 50000.00,
                "seller_code": "seller-1",
                "tax_entity_name": "Hong Kong",
                "discounted_amount": 3.00,
                "tax_supported": true
            }
        ],
        "discounts": [],
        "location_evidence": {},
        "product_classes": "P",
        "billing_address": {
            "country_code": "HK",
            "tax_region": "HK"
        },
        "sellers": [
            {
                "settings": {
                    "countries": {
                        "HK": {
                            "taxation": {
                                "physical": {
                                    "is_seller_registered": true,
                                    "is_physical_tax_enabled": true
                                }
                            }
                        }
                    }
                },
                "seller_code": "seller-1"
            }
        ],
        "buyer_name": "Test buyer",
        "tax_timestamp": "2022-11-10T10:46:54Z",
        "total_amount": 50000.00,
        "currency_code": "PLN"
    }
}

French Southern and Antarctic Lands

The following request represents a transaction from a seller who is based in French Southern and Antarctic Lands:

{"transaction":
    {"currency_code":     "EUR",
     "buyer_name":        "Test buyer",
     "ship_to_address":
     {"country_code": "TF"},
      "sellers": [
          {
              "seller_code": "seller-1",
              "settings": {
                "countries": {
                    "TF": {
                        "taxation": {
                            "physical": {
                                "is_seller_registered": true,
                                "is_physical_tax_enabled": true
                            }
                            
                        }
                    }
                }
              }
          }
      ],
     "transaction_lines": [
         {
             "amount":            50003,
             "discounts":         [
                 {"discount_amount": 3,
                  "discount_code": "line-discount-1"}
             ],
             "quantity":          1,
             "custom_id":         "line_1",
             "seller_code":       "seller-1",
             "ship_from_address": {
                 "country_code": "TC"
             },
             "product_class":     "P"
         }
         ]}}

The service returns the following response:

{
    "transaction": {
        "ship_to_address": {
            "country_code": "TF",
            "tax_region": "TF"
        },
        "amount": 50000.00,
        "required_fields": {
            "tax_required_fields": [],
            "audit_required_fields": [],
            "storage_required_fields": []
        },
        "tax_country_codes": "TF",
        "tax_amount": 0,
        "invoice_timestamp": "2022-11-10T10:50:58Z",
        "tax_liability_owner_codes": "",
        "countries": {},
        "transaction_lines": [
            {
                "reverse_charge": false,
                "amount": 50000.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 50000.000000000000,
                "taxes": [],
                "platform_liability_assumed_amount": 50000.00,
                "tax_region": "TF",
                "tax_exempt": true,
                "tax_country_code": "TF",
                "line_key": "LsyEk-G4PqjkaQTi",
                "discounts": [
                    {
                        "discount_code": "line-discount-1",
                        "discount_amount": 3.00,
                        "discount_total_amount": 3.00
                    }
                ],
                "custom_id": "line_1",
                "discounted_total_amount": 3.00,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "TC",
                    "tax_region": "TC"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "product_class": "P",
                "line_num": 1,
                "is_seller_permanent": false,
                "quantity": 1.000000000000,
                "invoice_capable": false,
                "total_amount": 50000.00,
                "seller_code": "seller-1",
                "tax_entity_name": "French Southern and Antarctic Lands",
                "discounted_amount": 3.00,
                "tax_supported": true
            }
        ],
        "discounts": [],
        "location_evidence": {},
        "product_classes": "P",
        "billing_address": {
            "country_code": "TF",
            "tax_region": "TF"
        },
        "sellers": [
            {
                "settings": {
                    "countries": {
                        "TF": {
                            "taxation": {
                                "physical": {
                                    "is_seller_registered": true,
                                    "is_physical_tax_enabled": true
                                }
                            }
                        }
                    }
                },
                "seller_code": "seller-1"
            }
        ],
        "buyer_name": "Test buyer",
        "tax_timestamp": "2022-11-10T10:50:58Z",
        "total_amount": 50000.00,
        "currency_code": "EUR"
    }
}