Example Requests

Read some example request and responses to help you when you create your own.

Calculate Tax

The following request and response are examples of a Calculate Tax request:

Request

{
    "transaction": {
        "tax_timestamp": "2025-03-01T12:00:00Z",
        "description": "Transaction description",
        "currency_code": "EUR",
        "buyer_name": "Test buyer",
        "ship_to_address": {
            "country_code": "GB",
            "city": "Big city",
            "street_name": "Street name",
            "building_number": "100a",
            "address_detail": "2nd fl",
            "postal_code": "00000"
        },
        "billing_address": {
            "country_code": "GB",
            "city": "The big city",
            "street_name": "The street name",
            "building_number": "100a",
            "postal_code": "00000"
        },
        "transaction_lines": [
            {
                "amount": 100,
                "custom_id": "",
                "ship_from_address": {
                    "country_code": "GB"
                },
                "description": "Product 1",
                "product_class": "P",
                "product_tax_code": {
                    "class": "TPP/Goods"
                }
            },
            {
                "amount": 100,
                "custom_id": "",
                "ship_from_address": {
                    "country_code": "GB"
                },
                "description": "Shipping",
                "product_class": "S"
            }  
        ]
    }
}

Response

{
    "transaction": {
        "ship_to_address": {
            "city": "Big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "Street name",
            "address_detail": "2nd fl",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "description": "Transaction description",
        "amount": 200.00,
        "required_fields": {
            "tax_required_fields": []
        },
        "tax_country_codes": "GB",
        "tax_amount": 40.00,
        "invoice_timestamp": "2025-03-01T12:00:00Z",
        "tax_liability_owner_codes": "",
        "transaction_lines": [
            {
                "description": "Product 1",
                "reverse_charge": false,
                "amount": 100.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.0,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "tax_exempt": false,
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "-QftTRYuuiCm8zWI",
                "custom_id": "",
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "product_tax_code": {
                    "class": "TPP/Goods"
                },
                "tax_number_service": "tax.service.gov.uk",
                "product_class": "P",
                "custom_rules_applied": [],
                "line_num": 1,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": false,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            },
            {
                "description": "Shipping",
                "reverse_charge": false,
                "amount": 100.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.00,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100.00,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "s6q2PuiFyJGSfbID",
                "custom_id": "",
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "tax_number_service": "tax.service.gov.uk",
                "product_class": "S",
                "custom_rules_applied": [],
                "line_num": 2,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": false,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            }
        ],
        "discounts": [],
        "product_classes": "SP",
        "billing_address": {
            "city": "The big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "The street name",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "buyer_name": "Test buyer",
        "tax_timestamp": "2025-03-01T12:00:00Z",
        "total_amount": 240.00,
        "currency_code": "EUR"
    }
}

Store Transaction

The following request and response are examples of a Store Transaction request:

Request

{
    "transaction": {
        "tax_timestamp": "2025-03-01T12:00:00Z",
        "description": "Transaction description",
        "currency_code": "EUR",
        "buyer_name": "Test buyer",
        "ship_to_address": {
            "country_code": "GB",
            "city": "Big city",
            "street_name": "Street name",
            "building_number": "100a",
            "address_detail": "2nd fl",
            "postal_code": "00000"
        },
        "billing_address": {
            "country_code": "GB",
            "city": "The big city",
            "street_name": "The street name",
            "building_number": "100a",
            "postal_code": "00000"
        },
        "transaction_lines": [
            {
                "amount": 100,
                "custom_id": "",
                "ship_from_address": {
                    "country_code": "GB"
                },
                "description": "Product 1",
                "product_class": "P",
                "product_tax_code": {
                    "class": "TPP/Goods"
                }
            },
            {
                "amount": 100,
                "custom_id": "",
                "ship_from_address": {
                    "country_code": "GB"
                },
                "description": "Shipping",
                "product_class": "S"
            }  
        ]
    }
}

Response

{
    "transaction": {
        "ship_to_address": {
            "city": "Big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "Street name",
            "address_detail": "2nd fl",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "description": "Transaction description",
        "amount": 200.00,
        "required_fields": {
            "tax_required_fields": [],
            "storage_required_fields": []
        },
        "marketplace_code": "V4EDemo",
        "tax_country_codes": "GB",
        "key": "PSqiwAQAAPJFqz_jLCgzo6VMqW1xn5klQ9goY6w",
        "tax_amount": 40.00,
        "update_date": "2025-03-28",
        "invoice_timestamp": "2025-03-01T12:00:00Z",
        "tax_liability_owner_codes": "",
        "create_timestamp": "2025-03-28T07:01:36Z",
        "transaction_lines": [
            {
                "description": "Product 1",
                "reverse_charge": false,
                "amount": 100.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.0,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "invoice_place": "Postal address line 1, Postal address line 2, Postal address line 3",
                "tax_exempt": false,
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "UwJ85ua2PYVf48bX",
                "custom_id": "",
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "product_tax_code": {
                    "class": "TPP/Goods"
                },
                "tax_number_service": "tax.service.gov.uk",
                "product_class": "P",
                "custom_rules_applied": [],
                "line_num": 1,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": false,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            },
            {
                "description": "Shipping",
                "reverse_charge": false,
                "amount": 100.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.00,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100.00,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "invoice_place": "Postal address line 1, Postal address line 2, Postal address line 3",
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "bjjMpRAXWINsH9uZ",
                "custom_id": "",
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "tax_number_service": "tax.service.gov.uk",
                "product_class": "S",
                "custom_rules_applied": [],
                "line_num": 2,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": false,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            }
        ],
        "discounts": [],
        "refunded_tax_amount": 0,
        "product_classes": "SP",
        "billing_address": {
            "city": "The big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "The street name",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "status": "N",
        "refunded_total_amount": 0,
        "update_timestamp": "2025-03-28T07:01:36Z",
        "buyer_name": "Test buyer",
        "tax_timestamp": "2025-03-01T12:00:00Z",
        "total_amount": 240.00,
        "currency_code": "EUR"
    }
}

Confirm Transaction

The following request and response are examples of the Confirm Transaction request:

Request

The Confirm Transaction request does not included any information in the body. Instead the Transaction Key is passed in the URL. For example:

POST {service_url}}/api/v3/seller/transactions/{{transaction_key}}/confirm

where:

  • {service_url} is the URL for the API.
  • {transaction_key} is the key that is generated and returned by the Store Transaction request.

Response

{
    "transaction": {
        "ship_to_address": {
            "city": "Big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "Street name",
            "address_detail": "2nd fl",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "description": "Transaction description",
        "amount": 200,
        "required_fields": {
            "tax_required_fields": [],
            "storage_required_fields": []
        },
        "marketplace_code": "V4EDemo",
        "tax_country_codes": "GB",
        "key": "PSqiwAQAAPJFqz_jLCgzo6VMqW1xn5klQ9goY6w",
        "tax_amount": 40,
        "update_date": "2025-03-28",
        "external_unique_id": null,
        "invoice_timestamp": "2025-03-01T12:00:00Z",
        "confirm_timestamp": "2025-03-28T07:06:07Z",
        "tax_liability_owner_codes": "",
        "create_timestamp": "2025-03-28T07:01:36Z",
        "transaction_lines": [
            {
                "description": "Product 1",
                "reverse_charge": false,
                "amount": 100.00,
                "tax_engine_additional_parameters": [
                    {
                        "param": "FLEX.output.FlexCode25",
                        "value": "OSC-AK-TEST"
                    }
                ],
                "tax_rule_applied": "physical-tax",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.0,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "invoice_place": "Postal address line 1, Postal address line 2, Postal address line 3",
                "invoice_number": "GB2025-1",
                "tax_exempt": false,
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "UwJ85ua2PYVf48bX",
                "custom_id": "",
                "first_line_with_same_designator_index": 0,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "product_tax_code": {
                    "class": "TPP/Goods"
                },
                "invoice_image_url": "(URL)",
                "tax_number_service": "tax.service.gov.uk",
                "product_class": "P",
                "custom_rules_applied": [],
                "line_num": 1,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": true,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "invoice_image_url_secret": "id4-IlvR2vU4GMn7",
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            },
            {
                "description": "Shipping",
                "reverse_charge": false,
                "amount": 100.00,
                "tax_rule_applied": "physical-tax",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.00,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100.00,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "invoice_place": "Postal address line 1, Postal address line 2, Postal address line 3",
                "invoice_number": "GB2025-1",
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "bjjMpRAXWINsH9uZ",
                "custom_id": "",
                "first_line_with_same_designator_index": 0,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "invoice_image_url": "(URL)",
                "tax_number_service": "tax.service.gov.uk",
                "product_class": "S",
                "custom_rules_applied": [],
                "line_num": 2,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": true,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "invoice_image_url_secret": "id4-IlvR2vU4GMn7",
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            }
        ],
        "rev": 2,
        "discounts": [],
        "product_classes": "SP",
        "billing_address": {
            "city": "The big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "The street name",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "status": "C",
        "update_timestamp": "2025-03-28T07:01:36Z",
        "buyer_name": "Test buyer",
        "tax_timestamp": "2025-03-01T12:00:00Z",
        "total_amount": 240,
        "invoice_image_url_secret": "id4-IlvR2vU4GMn7",
        "currency_code": "EUR"
    }
}

Refund Transaction

The following request and response are examples of a Refund Transaction request:

Request

{
    "refunds": [
        {
            "line_key": "UwJ85ua2PYVf48bX",
            "refund_amount": "100",
            "refund_reason": "Refund line X"
        },
        {
            "line_key": "bjjMpRAXWINsH9uZ",
            "refund_amount": "20",
            "refund_reason": "Refund line Y"
        }
    ]
}

Response

{
    "transaction": {
        "ship_to_address": {
            "city": "Big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "Street name",
            "address_detail": "2nd fl",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "description": "Transaction description",
        "amount": 200,
        "required_fields": {
            "tax_required_fields": [],
            "storage_required_fields": []
        },
        "refunded_amount": 120.00,
        "marketplace_code": "V4EDemo",
        "tax_country_codes": "GB",
        "key": "PSqiwAQAAPJFqz_jLCgzo6VMqW1xn5klQ9goY6w",
        "tax_amount": 40,
        "update_date": "2025-03-28",
        "invoice_timestamp": "2025-03-01T12:00:00Z",
        "confirm_timestamp": "2025-03-28T07:06:07Z",
        "tax_liability_owner_codes": "",
        "create_timestamp": "2025-03-28T07:01:36Z",
        "transaction_lines": [
            {
                "description": "Product 1",
                "reverse_charge": false,
                "amount": 100.00,
                "refunded_amount": 100.00,
                "tax_engine_additional_parameters": [
                    {
                        "param": "FLEX.output.FlexCode25",
                        "value": "OSC-AK-TEST"
                    }
                ],
                "tax_rule_applied": "physical-tax",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.0,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "invoice_place": "Postal address line 1, Postal address line 2, Postal address line 3",
                "invoice_number": "GB2025-1",
                "tax_exempt": false,
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "UwJ85ua2PYVf48bX",
                "custom_id": "",
                "refunded_tax_amount": 20.00,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "product_tax_code": {
                    "class": "TPP/Goods"
                },
                "invoice_image_url": "(URL)",
                "tax_number_service": "tax.service.gov.uk",
                "refunded_total_amount": 120.00,
                "product_class": "P",
                "custom_rules_applied": [],
                "line_num": 1,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": true,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "invoice_image_url_secret": "id4-IlvR2vU4GMn7",
                "refunds": [
                    {
                        "refund_reason": "Refund line X",
                        "refund_amount": 100.00,
                        "refund_timestamp": "2025-03-28T07:16:37Z",
                        "refund_note_url": "(URL)",
                        "refund_tax_amount": 20.00,
                        "refund_note_number": 1,
                        "refund_note_subnumber": 1,
                        "refund_key": "OrTyp5dwX4pL0AtM1qmCJg",
                        "refund_total_amount": 120.00
                    }
                ],
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            },
            {
                "description": "Shipping",
                "reverse_charge": false,
                "amount": 100.00,
                "refunded_amount": 20.00,
                "tax_engine_additional_parameters": [
                    {
                        "param": "FLEX.output.FlexCode25",
                        "value": "OSC-AK-TEST"
                    }
                ],
                "tax_rule_applied": "postage-insurance-vat",
                "unit_price": 100.00,
                "taxes": [
                    {
                        "tax_type": "VAT",
                        "imposition_type": "VAT",
                        "tax_jurisdiction_code": "78295",
                        "tax_amount": 20.00,
                        "tax_calculation_rule_id": "v301086121",
                        "exempt_amount": 0.0,
                        "tax_base_amount": 100.00,
                        "tax_jurisdiction_type": "COUNTRY",
                        "rate": 20,
                        "taxable_amount": 100.0,
                        "tax_authority_name": "UNITED KINGDOM",
                        "rate_type": "Standard",
                        "tax_authority_id": "78295",
                        "tax_name": "VAT physical",
                        "non_taxable_amount": 0.0,
                        "imposition": "VAT",
                        "amount_fraction_taxable": 1
                    }
                ],
                "tax_amount": 20.00,
                "seller_tax_number": "GB123456789",
                "tax_region": "GB",
                "invoice_place": "Postal address line 1, Postal address line 2, Postal address line 3",
                "invoice_number": "GB2025-1",
                "additional_currencies": {
                    "invoice": {
                        "amount": 82.59,
                        "currency_code": "GBP",
                        "fx_date": "2025-02-28T12:00:00Z",
                        "fx_rate": 0.825900231252,
                        "fx_source": "source_bankofengland",
                        "total_amount": 99.11,
                        "tax_amount": 16.52
                    }
                },
                "tax_country_code": "GB",
                "line_key": "bjjMpRAXWINsH9uZ",
                "custom_id": "",
                "refunded_tax_amount": 4.00,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "country_code": "GB",
                    "tax_region": "GB"
                },
                "tax_engine": "oseries",
                "invoice_status": "R",
                "kind": "b2c",
                "invoice_image_url": "(URL)",
                "tax_number_service": "tax.service.gov.uk",
                "refunded_total_amount": 24.00,
                "product_class": "S",
                "custom_rules_applied": [
                    "postage-insurance-vat"
                ],
                "line_num": 2,
                "is_seller_permanent": true,
                "quantity": 1.000000000000,
                "invoice_capable": true,
                "total_amount": 120.00,
                "seller_code": "V4EDemo_Seller3",
                "invoice_image_url_secret": "id4-IlvR2vU4GMn7",
                "refunds": [
                    {
                        "refund_reason": "Refund line Y",
                        "refund_amount": 20.00,
                        "refund_timestamp": "2025-03-28T07:16:37Z",
                        "refund_note_url": "(URL)",
                        "refund_tax_amount": 4.00,
                        "refund_note_number": 1,
                        "refund_note_subnumber": 2,
                        "refund_key": "EJa36uLAd7SmXiOuL8OPPg",
                        "refund_total_amount": 24.00
                    }
                ],
                "tax_entity_name": "United Kingdom",
                "tax_supported": true
            }
        ],
        "discounts": [],
        "refunded_tax_amount": 24.00,
        "product_classes": "SP",
        "billing_address": {
            "city": "The big city",
            "country_code": "GB",
            "postal_code": "00000",
            "street_name": "The street name",
            "building_number": "100a",
            "tax_region": "GB"
        },
        "status": "C",
        "refunded_total_amount": 144.00,
        "update_timestamp": "2025-03-28T07:01:36Z",
        "buyer_name": "Test buyer",
        "tax_timestamp": "2025-03-01T12:00:00Z",
        "total_amount": 240,
        "invoice_image_url_secret": "id4-IlvR2vU4GMn7",
        "currency_code": "EUR"
    }
}