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
|