API for Pochtoy.com partners: automation of shipping from the USA
Pochtoy.com API allows you to launch a store or Telegram bot with delivery from the USA without manual order processing. White-label, real-time rate calculation, and automatic tracking - integration takes from 4 to 12 hours of development.
02.05.2026
1181 views
Store or Telegram bot without a warehouse in the USA
Retail trade in goods from America — Nike sneakers, iHerb vitamins, Levi's clothing, perfumes, Apple gadgets — is carried out without own warehouse premises in the USA. The role of the warehouse is taken by an intermediary: accepts purchases, packs and sends them to customers. The sales channel can be any — from a classic online store to a Telegram bot.
Manual processing of one order comes down to the same set of actions: logging into the intermediary's account, entering customer data, waiting for the tracking number, forwarding the tracking number to the client. At 20 orders per day, this routine takes three to four hours. A bot with hundreds of orders per month without automation becomes inoperable.
The Pochtoy.com API removes this load. The partner focuses on marketing and service for customers, while Pochtoy.com handles all logistics. The white-label option makes the warehouse work invisible to end customers.
Manual processing vs API: what's the difference
| Work stage | Manual mode | Automation via API |
|---|---|---|
| Order creation | The operator copies customer data into the intermediary's account | The partner's platform sends the order programmatically right away |
| Customs declaration | The contents of the parcel are assembled by hand for each shipment | The order contents go into the declaration automatically |
| Processing control | The manager periodically opens the account and checks statuses | The partner's system receives updates in the background without human involvement |
| Tracking transfer | The tracking number is copied into correspondence with the buyer | The bot or website shows the tracking to the client as soon as it appears |
| Delivery cost | The buyer sees the price only after placing the order | The rate is calculated via API and displayed in the cart |
| Volume growth | The number of orders is limited by staff capabilities | The warehouse handles tens of thousands of orders per month |
Order route: from click to parcel
With the connected API, each order goes through six steps without operator involvement.
The buyer forms the cart
The customer selects items in the partner's store or bot, enters the delivery address. Sees the final price including delivery before placing the order.
The platform transfers the order via API
One request sends parcel parameters, recipient contacts and customs data. No manual entry.
Reception and processing at the US warehouse
If necessary, Pochtoy.com buyers purchase items in US stores. The parcel is assembled for shipment.
Statuses arrive in the partner's system
Processing stages — received, packed, handed over to the carrier — arrive on the platform automatically via API.
Shipment from Delaware with tracking number
Tracking is returned via API, after which the bot or site automatically notifies the buyer.
The customer receives the parcel in 5-10 days
Delivery to Russia, Belarus and Kazakhstan. White-label: the parcel contains no mention of Pochtoy.com.
What is transferred between the partner and Pochtoy.com
Data transfer is bidirectional. REST API is compatible with any stack — Python, Node.js, PHP, Ruby.
Documentation opens in the personal account after the application is approved. Access is granted within one business day after submitting the application at lp.pochtoy.com/api.
Benefits of connecting to the API
Fully under the partner's brand
The parcel contains nothing mentioning Pochtoy.com. From the first touch to receipt, the buyer sees only the store's brand.
Buyers will purchase without American Express
If the US store requires an American card or PayPal — Pochtoy.com staff will purchase the item for the partner, commission from 4%.
Warehouse in Delaware: sales tax 0%
State with no sales tax. Free storage for up to 14 days. Consolidation of multiple parcels into one shipment at no extra charge.
Volume bonus
From 30 parcels per month the partner receives $2 for each parcel up to 3 kg and $3 for heavier ones. The program has no end date.
Compliance with Federal Law 152
Servers with customers' personal data are located in Russia, which complies with the requirements of Russian personal data legislation.
Flexible payment options
Russian and foreign bank cards are supported, cryptocurrency on request. Automatic payment of orders via API is possible.
Partner tariff grid
Three tariff options differing in speed and price. All are available via API — the partner's platform shows the current cost to the buyer even before placing the order.
| Delivery type | Time | Price | Usually sent |
|---|---|---|---|
| Standard | 8-14 days | from $5.99 | Textiles, footwear, accessories |
| Express | 5-8 days | from $9.99 | Gadgets, sneakers, denim clothing |
| iHerb | 7-10 days | $12.99 per kg | Dietary supplements and vitamins from iHerb |
Promising niches for resale through Pochtoy.com
Product categories where delivery from the USA is especially in demand. Partners choose these directions more often than others: small package weight, noticeable price difference with Russian retail, and steady demand.
Vitamins and supplements from iHerb
Since 2022, direct iHerb delivery to Russia has been unavailable, and demand has shifted to intermediaries. The $12.99 per kg rate improves resale economics. The highest growth rate among partners.
Sneakers and shoes from the USA
On Nike, Adidas, New Balance, ASICS and Vans sites, prices are 50-100% lower than Russian retail. Joint purchase organizers process hundreds of orders monthly.
Clothing from American brands
Ralph Lauren, Tommy Hilfiger, Calvin Klein, Levi's have closed their offices in Russia. Ordering originals through an intermediary delivers the highest margin among categories.
Electronics and gadgets
Apple accessories, audio systems, gamer peripherals — American prices are lower than Russian ones even after delivery and customs. High average order value.
Sports nutrition
American proteins, BCAA, pre-workout complexes are 2-3 times cheaper than Russian analogs. High percentage of repeat purchases.
Cosmetics and personal care
Sephora, Ulta, Paula's Choice — brands that are unavailable in Russia or significantly more expensive. Light packages, minimal delivery cost.
Four steps to your first order
Account creation and application submission
A partner account is created on pochtoy.com. On the page lp.pochtoy.com/api an application is submitted with a description of the platform — website, Telegram bot or other channel — and the expected number of orders per month.
Opening the API documentation
After approval, a section with integration materials appears in the dashboard: technical documentation, access keys and a test environment. Methods for submitting orders, polling statuses, obtaining tracking and calculating rates are described.
Embedding the API into the platform
REST API is compatible with Python, Node.js, PHP, Ruby. A bot on Python with aiogram or telebot connects in a few hours. Standard scope of work — from 4 to 12 hours of development. Rate request, order submission, status polling — three code blocks on the partner side.
Testing and launch
Before launch, 2-3 test orders are run in the sandbox. The following are checked: correctness of statuses, tracking display, white-label operation, delivery of notifications to the client on behalf of the partner brand. After passing the tests — switch to the live key.
What the process looks like from the inside: the buyer’s journey
When the buyer completes payment, the platform transfers the data to Pochtoy.com without operator involvement. The client sees the order progress without needing to contact the store.
| Stage | What the buyer sees | What happens in the system |
|---|---|---|
| In cart | Delivery price is visible before placing the order | The platform requested the rate via API and received a response |
| Confirmation | Order acceptance message | The platform sent the order to the Pochtoy.com API |
| Warehouse | Processing notification | API returns the stages of order movement in the warehouse |
| Shipped from USA | Message with tracking number and tracking link | API transferred the tracking number, the bot notified the buyer automatically |
| Received | Final receipt notification | API transmitted the final status, the notification was sent without partner involvement |
Frequently asked questions about Pochtoy.com API
What tasks does the API handle, and what remains on the warehouse side?
Can it be done without a developer?
Will buyers know about Pochtoy.com?
Can the delivery cost be shown before placing the order?
What is the duty-free limit when importing into Russia?
When will the buyer receive the tracking number?
To which countries does delivery via API work?
Hand over USA delivery to Pochtoy.com
Submit an application — access to the API documentation will open within one business day. Integration in 4-12 hours of development.
Get API access
