India - Physical Goods

Overview

For merchants dealing in physical goods in India, a 6 or 8 digit HSN Code (i.e. Harmonized System of Nomenclature, a global standard used to classify goods) must be passed against the parameter hsn_code under the array items in the API request.

Note

• Please review the Indian Government's Foreign Trade Policy and do not trade in any restricted goods.
• For the latest information on HSN codes, please refer to the Indian GST Department's website.

---

Parameter

Parameter	Requirement	Description
payment.items[].hsn_code (Direct API)	Mandatory	HSN code of each distinct item. Must be 6 or 8 digit code only. 2 or 4 digit codes are not accepted.
items[].hsn_code (Payment Page)	Mandatory	HSN code of each distinct item. Must be 6 or 8 digit code only. 2 or 4 digit codes are not accepted.

---

Points to Consider

DOs	DON'Ts
Only send 6 or 8 digit HSN code	Don't send 2 or 4 digit HSN code
Send distinct HSN code for each category of good under the transaction	Don't send HSN code as "Blank"
Send one HSN code if the category of good is same and only quantity varies	Don't send HSN codes restricted for trade by the Indian Government
	Don't send a single HSN code for different categories of goods

---

Sample Requests

Direct API (/ws/direct)

The following example shows how to include HSN codes in a Direct API credit card payment request for India.

curl -X POST \
    --location 'https://sandbox.ebanx.com/ws/direct' \
    --header 'Content-Type: application/json' \
    --data '{
"integration_key": "your_ebanx_integration_key",
"payment": {
  "name": "John Doe",
  "email": "john.doe@example.com",
  "document": "456789123456",
  "phone_number": "+919812345678",
  "address": "MG Road",
  "street_number": "1040",
  "street_complement": "Sector 17",
  "city": "Gurgaon",
  "state": "HR",
  "zipcode": "122003",
  "country": "in",
  "payment_type_code": "creditcard",
  "merchant_payment_code": "0x0W26D04",
  "currency_code": "INR",
  "amount_total": 100,
  "card": {
    "card_number": "4111111111111111",
    "card_name": "John Doe",
    "card_due_date": "12/2030",
    "card_cvv": "123"
  },
  "items": [
    {
      "hsn_code": "995413"
    },
    {
      "hsn_code": "995415"
    }
  ]
}
}'

Payment Page (/ws/request)

The following example shows how to include HSN codes in a Payment Page request for India.

curl -X POST \
--location 'https://sandbox.ebanx.com/ws/request' \
--header 'Content-Type: application/json' \
--data '{
  "integration_key": "****************",
  "name": "John Doe",
  "email": "john.doe@example.com",
  "country": "in",
  "payment_type_code": "_all",
  "merchant_payment_code": "0x0W26D05-T10",
  "currency_code": "INR",
  "amount": 1000,
  "items": [
    {
      "hsn_code": "995413"
    },
    {
      "hsn_code": "995415"
    }
  ]
}'

Response

No change to the response. It will remain as per the standard response format for the respective API endpoint.

---

Other Verticals

For other supported categories of merchants, no additional information is required.

Still need help?

We hope this article was helpful. If you still have questions, you can explore the following options:

• Merchant support: Contact our support team at sales.engineering@ebanx.com for assistance.
• Not a partner yet? Please complete the Merchant Signup Form, and our commercial team will reach out to you.