FAQs & Troubleshooting
Common issues and answers for Trapyfy merchants. If you cannot find an answer here, contact support.
Getting Started
How do I sign in to Trapyfy?
Go to trapyfy.com and sign in with your merchant account. Confirm you are in the correct organization from the left-hand Organizations panel.
How do I connect my Telegram bot?
Create a bot via BotFather using /newbot, copy the token, then go to Organizations → Manage Platform Keys and paste the token. See the Connect Your Telegram Bot guide for full steps.
What do I need before going live?
A confirmed organization, Telegram bot connected, at least one Published product with country pricing and warehouse stock, at least one active shipping method, at least one payment method enabled, and a successful test order. See the Go-Live Checklist.
Products & Catalog
Why is my product not appearing in the storefront?
A product appears only when all four conditions are met:
- The product status is set to Published
- Pricing exists for the country the customer is shopping from
- Stock is assigned in the relevant warehouse (where stock management is enabled)
- The warehouse is assigned to the correct country
My product is Published but not showing — what should I check?
Confirm country-specific pricing has been added under the product's pricing tab. Then check that the warehouse serving that country has stock assigned for the product.
How do I add product variants?
Go to the product detail page and use the Attributes tab to define variants such as size, color, or other options. Each variant can have its own price and inventory.
Shipping
No shipping method is appearing at checkout
Check that at least one shipping method is active and configured for the customer's country. Go to Shipping → Shipping Methods and confirm the method is enabled and has the correct country assigned.
Checkout fails with no delivery option
This is almost always caused by a missing shipping method for the country, an inactive shipping method, or a warehouse country mismatch. Verify the shipping method country assignment and warehouse country match the customer's location.
Payments
What payment methods does Trapyfy support?
Niftipay is the integrated payment layer for card and crypto payments. Cash on Delivery is a manual/offline method. PayPal and Bank Transfer are manual/external methods that require merchant-side reconciliation — they are not native automated integrations.
Card payment is not showing at checkout
Card payments require Niftipay to be enabled and a payout wallet configured. If the payout wallet is not set up in Niftipay, card payments will not be available at checkout. Card payments are not required for every merchant.
A customer paid via Bank Transfer or PayPal but the order is not confirmed
These are manual payment methods. The merchant must verify the payment externally (bank statement, PayPal dashboard) and then manually update the order payment status in Trapyfy before beginning fulfillment.
When do I receive payouts?
Payout schedules are configured in Niftipay. Settlement visibility and payout timing depend on your payment configuration and region.
Orders & Fulfillment
What do the order statuses mean?
Pending = awaiting payment confirmation. Confirmed = payment received. Processing = being prepared. Shipped = in transit. Delivered = completed. Cancelled = order cancelled. See the Order Lifecycle guide for full details.
Should I fulfill an order before payment is confirmed?
No. For card and crypto payments, wait for payment confirmation before starting fulfillment. For Cash on Delivery, fulfillment can begin since payment is collected on delivery. For PayPal or Bank Transfer, verify payment externally before fulfilling.
A shared supplier product was ordered — who fulfills it?
Fulfillment of shared/dropshipped products depends on the supplier's setup. A supplier order may be created automatically when the shared product is sold. Check with the supplier to confirm their fulfillment workflow.
How do I cancel an order?
Open the order details and select the Cancel option. Orders with confirmed payments may require a refund to be processed separately through your payment provider.
POS & Kiosk
Products are not appearing on the kiosk
Kiosk product visibility follows the same rules as the Telegram storefront: the product must be Published, have pricing for the kiosk country, have stock assigned in the warehouse assigned to that country. Verify all four conditions are met.
Bot Troubleshooting
Bot not responding to /start
Check that the bot token in Organizations → Manage Platform Keys is correct and has no extra spaces. Confirm the bot is not already connected to another service. Try sending /start directly in Telegram to confirm the bot itself is active.
Bot token incorrect or copied with spaces
Re-copy the token directly from BotFather. Do not include any text before or after the token. Paste it into Manage Platform Keys and save.
Payment not confirming
Check that payment methods are enabled and properly configured. For manual methods (PayPal, Bank Transfer), verify payment externally and update the order status manually. Contact Niftipay support if the issue is with card or crypto processing.
Inventory not updating
Inventory deducts after order confirmation. If inventory appears stuck, refresh the product page or check for pending orders that may be holding stock.
Still need help?
If you cannot find an answer, review the video tutorials or contact Trapyfy support.
