Purchase API - Get Tax Info #

1. API Overview #

Purpose #

This API calculates the estimated tax based on product and shipping information.
It retrieves tax details using the provided delivery and billing addresses, item amounts, discounts, and shipping charges.
The response includes the total tax amount and detailed tax breakdown per item.
The API is used to confirm tax information before payment to ensure accurate billing.

Note: The TAX calculation feature is dependent on the PG. Please contact the Billing Team (ebp-server@lge.com) to check if TAX calculation is supported for your PG.

Details #

Item	Value
API Name	Get Tax Info
API Path	/api/v2/payment/taxes
API ID	EBP_API_227
HTTP Method	POST
Region	Global

2. Request Specification #

2.1 Request Header #

For detailed header information, please refer to the Common Headers documentation.

2.2 Request Data Schema #

depth	Field	Details & Description
0	userNo	`string` 🔴 Required Unique identifier for user
0	isTaxIncluded	`string` 🔴 Required Indicates whether tax is included in product price
0	deliveryAddress	`object` 🔴 Required Delivery address information
1	recipientLocalName	`string` 🔴 Required Recipient's local name
1	recipientLocalFirstName	`string` ⚪ Optional Recipient's local first name
1	countryCode	`string` 🟡 Conditional Delivery country code (ISO standard)
1	streetAddress	`string` ⚪ Optional Street name for delivery address
1	addressLine1	`string` ⚪ Optional Primary delivery address line
1	addressLine2	`string` ⚪ Optional Secondary delivery address line
1	city	`string` ⚪ Optional City or province for delivery
1	postalCode	`string` ⚪ Optional Postal code for delivery address
0	billingAddress	`object` - Billing address information (required for tax invoice)
1	billingEmail	`string≤ 128` ⚪ Optional Billing contact email address
1	billingLastName	`string≤ 100` 🟡 Conditional Billing contact last name (local language)
1	billingFirstName	`string≤ 100` 🟡 Conditional Billing contact first name (local language)
1	billingCountry	`string≤ 3` 🟡 Conditional ISO 3166-1 alpha-3 country code
1	billingStreet	`string≤ 100` 🟡 Conditional Street name for billing address
1	billingAddressLine1	`string≤ 100` 🟡 Conditional Primary billing address line
1	billingAddressLine2	`string≤ 100` ⚪ Optional Secondary billing address line
1	billingCity	`string≤ 100` 🟡 Conditional City for billing address
1	billingPostalCode	`string≤ 100` 🟡 Conditional Postal code for billing address
1	billingState	`string≤ 100` 🟡 Conditional State or province for billing address
0	items	`array` 🔴 Required -
1	seq	`number` 🔴 Required Sequence
1	itemId	`string` 🔴 Required Product ID
1	productCode	`string` 🔴 Required Product Code
1	amount	`number` ⚪ Optional Product amount
1	discountAmount	`number` ⚪ Optional Discount Amount
1	deliveryAmount	`number` ⚪ Optional Delivery Amount
1	deliveryProductCode	`number` ⚪ Optional Delivery Product Code

2.3 Request Examples #

JSON Example #

{
  "userNo": "U123456789",
  "isTaxIncluded": "Y",
  "deliveryAddress": {
    "recipientLocalName": "홍길동",
    "recipientLocalFirstName": "길동",
    "countryCode": "KR",
    "streetAddress": "123 강남대로",
    "addressLine1": "강남구 역삼동",
    "addressLine2": "삼성타워 101호",
    "city": "서울",
    "postalCode": "06236"
  },
  "billingAddress": {
    "billingEmail": "billing@example.com",
    "billingLastName": "Kim",
    "billingFirstName": "Minsoo",
    "billingCountry": "KOR",
    "billingStreet": "456 테헤란로",
    "billingAddressLine1": "강남구 삼성동",
    "billingAddressLine2": "빌딩 202호",
    "billingCity": "서울",
    "billingPostalCode": "06164",
    "billingState": "서울특별시"
  },
  "items": [
    {
      "seq": 1,
      "productCode": "",
      "amount": "",
      "discountAmount": 0,
      "deliveryAmount": 0,
      "deliveryProductCode": "24643"
    }
  ]
}

3. Response Specification #

3.1 Response Data Schema #

depth	Field	Details & Description
-1	resultCode	`string` 🔴 Required Result code e.g., "0" for success, "EBP-A-0001" for error
-1	message	`string` 🔴 Required Result message
-1	requestId	`string` 🔴 Required Unique request identifier for tracking
-1	timestamp	`string` 🔴 Required Response timestamp in ISO 8601 format e.g., 2025-12-19T14:24:00+09:00
-1	data	`object` 🔴 Required Response data
0	totalTaxAmount	`number` 🔴 Required Total tax amount for the user
0	taxItems	`array` 🔴 Required List of tax item objects
1	itemSeq	`number` 🔴 Required Sequence number of the tax item
1	itemId	`string` 🔴 Required Unique product identifier
1	taxAmount	`number` 🔴 Required Tax amount for the corresponding product
1	taxDetails	`array` 🔴 Required List of tax details
2	detailSeq	`number` 🔴 Required Detail sequence number
2	taxType	`string` 🔴 Required Tax type e.g., VAT, Service
2	taxName	`string` 🔴 Required Tax name
2	taxAmount	`number` 🔴 Required Tax amount for the corresponding detail

3.2 Response Samples #

Success Response #

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "1767142829863",
  "timestamp": "2025-12-31T01:00:29.865421800Z",
  "data": {
    "totalTaxAmount": 0.41,
    "taxItems": [
      {
        "itemSeq": 1,
        "itemId": "PD_20250000000003",
        "taxAmount": 0.41,
        "taxDetails": [
          {
            "detailSeq": 1,
            "taxType": "Sales And Use Taxes",
            "taxName": "NY Local Transit Tax",
            "taxAmount": 0.0225
          },
          {
            "detailSeq": 2,
            "taxType": "Sales And Use Taxes",
            "taxName": "NY Sales Tax",
            "taxAmount": 0.1875
          },
          {
            "detailSeq": 3,
            "taxType": "Sales And Use Taxes",
            "taxName": "NY Sales Tax",
            "taxAmount": 0.2
          }
        ]
      }
    ]
  }
}