Get started

    API Examples
                

The 1Epin.com API provides programmatic access to 1epin.com services.

To use this API, you need an STATIC IP. Please email to [email protected] your STATIC IP.

Test Api Endpoint: https://www.1epin.com/api/test/
emailAddress [email protected]
password test1234
Live Api Endpoint: https://www.1epin.com/api/live/
emailAddress Your 1epin.com user emailAddress
password Your 1epin.com user password

checkBalance


# Post Example
curl --location --request POST 'https://www.1epin.com/api/test/checkBalance/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234"}'
                

Post Api Url:
https://www.1epin.com/api/test/checkBalance/



Successful Request Result Example :
{"ResultCode":"00","ResultMessage":"Success","Balance":9999927.99}


Wrong Request Result Example :
{"ResultCode":"03","ResultMessage":"Wrong Request Username/Password","Balance":0.0}

#Look end of page for more error codes
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
Balance Decimal 1epin.com users balance.

categories


# Post Example
curl --location --request POST 'https://www.1epin.com/api/test/categories/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234"}'
                

Post Api Url:
https://www.1epin.com/api/test/categories/



Successful Request Result Example :
{"ResultCode":"00","ResultMessage":"Success","Categories":[{"CategoryId":130,"CategoryName":"PUBG
Lite","CategoryType":"epin"},{"CategoryId":131,"CategoryName":"PUBG
Mobile","CategoryType":"epin"},{"CategoryId":132,"CategoryName":"PUBG New
State","CategoryType":"epin"}]}


Wrong Request Result Example :
{"ResultCode":"01","ResultMessage":"Missing Parameter","Categories":null}

#Look end of page for more error codes
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
Categories List CategoryId (integer),CategoryName (string), CategoryType (string)

products


# Post Example
curl --location --request POST 'https://www.1epin.com/api/test/products/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234","category":131}'
                

Post Api Url:
https://www.1epin.com/api/test/products/



Successful Request Result Example :
{"ResultCode":"00","ResultMessage":"Success","Products":[{"ProductId":28,"ProductName":"PUBG Mobile 28
UC","ProductPrice":6.00},{"ProductId":29,"ProductName":"PUBG Mobile 55
UC","ProductPrice":10.00},{"ProductId":30,"ProductName":"PUBG Mobile 143
UC","ProductPrice":24.00}]}

Wrong Request Result Example :
{"ResultCode":"05","ResultMessage":"Category Not Found","Products":null}

#Look end of page for more error codes
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password
category Integer Category Id

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
Products List ProductId (integer),ProductName (string), ProductPrice (decimal)

products


# Post Example
curl --location --request POST 'https://www.1epin.com/api/test/allproducts/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234"}'
                

Post Api Url:
https://www.1epin.com/api/test/allproducts/



Successful Request Result Example :
{"ResultCode":"00","ResultMessage":"Success","Products":[{"CategoryId":131,"CategoryName":"PUBG Mobile","CategoryType":"epin","ProductId":28,"ProductName":"PUBG Mobile 28
UC","ProductPrice":6.00},{"CategoryId":131,"CategoryName":"PUBG Mobile","CategoryType":"epin","ProductId":29,"ProductName":"PUBG Mobile 55
UC","ProductPrice":10.00},{"CategoryId":131,"CategoryName":"PUBG Mobile","CategoryType":"epin","ProductId":30,"ProductName":"PUBG Mobile 143
UC","ProductPrice":24.00}]}

Wrong Request Result Example :
{"ResultCode":"03","ResultMessage":"Wrong Request Username/Password","Products":null}

#Look end of page for more error codes
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
Products List CategoryId (integer),CategoryName (string), CategoryType (string), ProductId (integer),ProductName (string), ProductPrice (decimal)

addOrder


# Post Example
curl --location --request POST 'https://www.1epin.com/api/test/addOrder/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234","product":28,"user":"test","quantity":1,"orderNumber":"test123456"}'
                

Post Api Url:
https://www.1epin.com/api/test/addOrder/



Successful Request Result Example :
{"ResultCode":"00","ResultMessage":"Success","Balance":9999867.99}

Wrong Request Result Example :
{"ResultCode":"06","ResultMessage":"Product Not Found","Balance":0.0}

#Look end of page for more error codes
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password
product Integer Product Id
user string For type "top-up" (example:pubg mobile player id)
quantity Integer For type "epin" (example:razer gold pin)
orderNumber string Your unique order number

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
Balance Decimal Your balance after order

checkOrder


# Post Example
curl --location --request POST 'https://www.1epin.com/api/test/checkOrder/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234","orderNumber":"test123456"}'
                

Post Api Url:
https://www.1epin.com/api/test/checkOrder/



Wrong Request Result Example :
{"ResultCode":"08","ResultMessage":"Order Not Found","OrderStatusCode":0,"OrderStatusMessage":"","PinCodes":null}

Successful completed transaction result example :
{"ResultCode":"00","ResultMessage":"Success",
"OrderStatusCode":1,"OrderStatusMessage":"Completed",
"PinCodes":["ASDASDASDSD464645","44894412312312312","KASDADALDKASD55","56C99765-1717-4990-A9FD-215F1293E855"]}
             
Unsuccessful completed transaction result example :
{"ResultCode":"00","ResultMessage":"Success","OrderStatusCode":2,"OrderStatusMessage":"wrong_player_id","PinCodes":[]}

Waiting transaction result example :
{"ResultCode":"00","ResultMessage":"Success","OrderStatusCode":0,"OrderStatusMessage":"Processing","PinCodes":[]}
                
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password
orderNumber string Your order number

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
OrderStatusCode Integer Order status code
OrderStatusMessage String Order status description
PinCodes List PinCode List of order

Callback Services


# Post Example
curl --location --request POST 'http://www.[yoursiteaddress].com/[yourcallbackurl]/' \
--header 'Content-Type: application/json' \
--data-raw '{"OrderNumber":"test123456","OrderStatusCode":1,"OrderStatusMessage":"Completed",
"PinCodes":["ASDASDASDSD464645","44894412312312312","KASDADALDKASD55","56C99765-1717-4990-A9FD-215F1293E855"]}'
                

Post Api Url:
http://www.[yoursiteaddress].com/[yourcallbackurl]/

Please email to [email protected] your callback url.



Result example : 
OK
                

Post Parameters

Field Type Description
OrderNumber string Your order number
OrderStatusCode Integer Order status code
OrderStatusMessage String Order status description
PinCodes List PinCode List of order

Return Message

OK

addOrderLocal

The function to be used to receive your orders placed on the website and selected as the delivery location API.


# Post Example
curl --location --request POST 'https://www.1epin.com/api/live/addOrderLocal/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234","product":28,"user":"test","quantity":1,"orderNumber":"test123456"}'
                

Post Api Url:
https://www.1epin.com/api/live/addOrderLocal/



Successful Request Result Example :
{"ResultCode":"00","ResultMessage":"Success","Balance":9999867.99}

Wrong Request Result Example :
{"ResultCode":"06","ResultMessage":"Product Not Found","Balance":0.0}

#Look end of page for more error codes
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password
product Integer Product Id
user string For type "top-up" (example:pubg mobile player id)
quantity Integer For type "epin" (example:razer gold pin)
orderNumber string Your unique order number

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
Balance Decimal Your balance after order

checkOrderLocal

The function that will be used to receive the codes of the orders you have placed with the addOrderLocal function.


# Post Example
curl --location --request POST 'https://www.1epin.com/api/live/checkOrderLocal/' \
--header 'Content-Type: application/json' \
--data-raw '{"emailAddress":"[email protected]","password":"test1234","orderNumber":"test123456"}'
                

Post Api Url:
https://www.1epin.com/api/live/checkOrderLocal/



Wrong Request Result Example :
{"ResultCode":"08","ResultMessage":"Order Not Found","OrderStatusCode":0,"OrderStatusMessage":"","PinCodes":null}

Successful completed transaction result example :
{"ResultCode":"00","ResultMessage":"Success",
"OrderStatusCode":1,"OrderStatusMessage":"Completed",
"PinCodes":["ASDASDASDSD464645","44894412312312312","KASDADALDKASD55","56C99765-1717-4990-A9FD-215F1293E855"]}
             
Unsuccessful completed transaction result example :
{"ResultCode":"00","ResultMessage":"Success","OrderStatusCode":2,"OrderStatusMessage":"wrong_player_id","PinCodes":[]}

Waiting transaction result example :
{"ResultCode":"00","ResultMessage":"Success","OrderStatusCode":0,"OrderStatusMessage":"Processing","PinCodes":[]}
                
                

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password
orderNumber string Your order number

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
OrderStatusCode Integer Order status code
OrderStatusMessage String Order status description
PinCodes List PinCode List of order

localStocks

The function you will use to see the current products and their quantities in your stock.


    # Post Example
    curl --location --request POST 'https://www.1epin.com/api/live/localStocks/' \
    --header 'Content-Type: application/json' \
    --data-raw '{"emailAddress":"[email protected]","password":"test1234"}'

Post Api Url:
https://www.1epin.com/api/live/localStocks/



    Wrong Request Result Example :
    {"ResultCode":"03","ResultMessage":"Wrong Username/Password","Products":null}

    Successful result example :
    {"ResultCode":"00","ResultMessage":"Success","Products":[{"ProductId":1234,"ProductName":"Test Product1","ProductPrice":0.0,"StockQuantity":14},{"ProductId":12345,"ProductName":"Test Product2","ProductPrice":0.0,"StockQuantity":32},{"ProductId":123456,"ProductName":"Test Product3","ProductPrice":0.0,"StockQuantity":65}]}

Post Parameters

Field Type Description
emailAddress String Your 1epin.com user emailAddress
password String Your 1epin.com user password

Return Fields

Field Type Description
ResultCode String Result status code
ResultMessage String Result status description
Products List ProductId (integer), ProductName (string), ProductPrice(decimal), StockQuantity(integer)

Error Codes

The 1Epin.com API uses the following error codes:

Error Code Meaning
00 Succes
01 Missing Parameter
02 Unauthorized Ip Address
03 Unknown or unvalid user
04 No Balance
05 Category Not Found
06 Product Not Found
07 Registered OrderNumber
08 Order Not Found
09 Product type is popup.You must send user parameter.
10 Agreement time is between 23:45 and 00:00