Version: 1.0.0

Order


# Here is a curl example
curl \
-X POST https://order.api.guhada.com/order \
-H 'X-GUHADA-API-KEY=your_api_key' \
-D '
{
    "accountId": "100001",
    "accountName": "GUHADA_MALL",
    "orders": [
        {
            "transactionId": "XYZ1234567-13456",
            "currency":  "USD",
            "sellPrice": "100.00",
            "quantity": "1",
            "orderDate":  "2025-02-01",
            "orderNote": "",
            "guhadaDeal":  {
                "dealId": 59283113,
                "dealName": "Prada T-shirt",
                "optionId": 1236432,
                "optionName": "XS"
            },
            "recipient":  {
                "name": "John Doe",
                "phone": "2121231213",
                "requestNote": "Please leave package at the front door",
                "shippingTo": {
                    "addressStreet": "1234 Elm St",
                    "addressSuits": "Apt 101",
                    "addressCity": "Los Angeles",
                    "addressProvince": "CA",
                    "addressCountry": "USA",
                    "addressZipcode": "90001"
                }
            }
        },
        {
            "transactionId": "XYZ232231-2456",
            "currency":  "USD",
            "sellPrice": "200.00",
            "quantity": "3",
            "orderDate":  "2025-02-01",
            "orderNote": "some note",
            "guhadaDeal":  {
                "dealId": 60331243,
                "dealName": "Gucci Black Bag",
                "optionId": 343234,
                "optionName": "One Size"
            },
            "recipient":  {
                "name": "Jane Smith",
                "phone": "2121231214",
                "requestNote": "",
                "shippingTo": {
                    "addressStreet": "5678 Oak St",
                    "addressSuits": "",
                    "addressCity": "New York",
                    "addressProvince": "NY",
                    "addressCountry": "USA",
                    "addressZipcode": "10001"
                }
            }
        }

    ]
}'

To place order a POST call to the following url :
POST https://order.api.guhada.com/order 



Result example :
# case 1.
# order placed successfully:


{
    "result": {
        "code": 200,
        "message": "Order request processed successfully"
    },
    "data": []
}


# case 2.
# order placed with error:


{
    "result": {
        "code": <error_code>,
        "message": "<error description>"
    },
    "data": []
}


# case 3.
# order placed with partial success:


{
    "result": {
        "code": 1000,
        "message": "Order request processed partially"
    },
    "data": [
        {
            "code": <error_code>,
            "message": "<error description>"
        },
        {
            "code": 200,
            "message": "Order request processed successfully"
        },
        ...
    ]
}

HEADER

Header Type Description
X-GUHADA-API-KEY String Your API key

Order Request properties

Field Required Type Description
accountId * String Guhada provided account id
accountName String Guhada provided account name
orders * List of Order List of order details
Order properties for the details

Order properties
Field Required Type Description
transactionId * String Order Id
currency * String currency
KRW, USD, EUR, AUD, JPY, SGD, CNY, DKK, GBP, PLN
sellPrice * String Product Price
quantity * String Total quantity purchased
guhadaDeal * GuhadaDeal Guhada Deal information
GuhadaDeal properties for the details
orderDate String Ordered Date
yyyy-MM-dd
ex) 2025-10-01
recipient Recipient Shipping information
Recipient properties for the details
orderNote String Additional note for this order
GuhadaDeal properties
Field Required Type Description
dealId * Long Guhada Deal ID
dealName String Guhada Deal Name
optionId * Long Guhada deal option id
either optionId or optionName should be provided
optionName * String Guhada deal option name
either optionId or optionName should be provided

Recipient properties
Field Required Type Description
name * String Recipient name
phone * String Recipient phone number (Only Numbers)
requestNote String Note from recipient
shippingTo * RecipientShippingTo Shipping address
RecipientShippingTo properties for the details

RecipientShippingTo properties
Field Required Type Description
addressStreet * String Shipping address street
addressSuits * String Shipping APT/Suit/Unit
addressCity * String Shipping City
addressProvince * String Shipping province or state
addressCountry * String Shipping Country
addressZipcode * String Shipping Postal Zipcode

Response Codes

Guhada Order API responses following http codes:

Code Meaning
200 Order request is processed
403 Invalid API key

Guhada Order API uses the following results:

code message Meaning
200 success Orders are placed successfully
1000 Order request processed partially Only some of the orders are placed successfully.
If available, the error code and message will be provided for each order.
2000 Invalid guhada deal id Provided guhada deal id is not valid
or
Guhada does not have the deal associated with the id.
2001 Invalid guhada deal option Provided guhada deal option id (or option name) is not valid
or
Guhada does not have the deal option associated with the option id (or option name).
3000 Invalid recipient information Shipping recipient name or phone number is not provided
3001 Invalid shipping address Shipping address is not valid (or has error)
3002 Invalid recipient phone number Phone number is not number
Phone number must only contain numbers (ex, 2121231213)
3003 Invalid date format Invalid date format - valid format is yyyy-MM-dd
3004 Currency not supported Supported Currency:
USD, EUR, AUD, JPY, SGD, CNY, DKK, GBP, PLN
3005 Invalid sell price Sell price is not valid price format
3006 Invalid quantity Quantity is not provided or less than or equals to 0
4000 Transaction id not provided Order (or Transaction Id) is not provided
4001 Guhada deal id not provided Guhada deal id is not provided
4002 Guhada deal option not provided Guhada deal option id or option name is not provided
4003 Recipient not provided Shipping information is missing
4004 Shipping address not provided Shipping address is not provided
4005 Order item not provided Request is made without orders
4006 Currency not provided Currency is missing in Order item
4007 Sell price not provided Sell price is missing in Order item
5000 Transaction id already processed Provided Transaction Id has been already processed