Last updated: May 2026 · 9 min read
A practical guide to documenting issues, asking for remedies, and escalating problems when an order goes wrong.
Document first, escalate second. Most supplier disputes are resolved faster with evidence than with pressure.
When goods arrive with problems, the instinct is often to contact the supplier immediately with frustration or to demand a refund. This rarely produces the best outcome. Suppliers respond more constructively to a clear, documented issue report than to an angry message — and platforms can only help you if the evidence is in order.
The right sequence is: document → communicate → negotiate → escalate → stop if necessary.
This guide walks through each step.
What You’ll Learn
- What to do in the first 24 hours after finding a problem
- How to build an evidence file that supports your case
- What resolutions to ask for and how to ask
- What platform protection can and cannot do
- When and how to escalate
- When to stop chasing a dispute
- How to prevent the same problem next time
The First 24 Hours: What to Do When You Find a Problem
Before you contact anyone, document everything.
Take photos and video
Photograph the outer packaging before opening. Record video of the unboxing process if possible. Photograph every issue — damage, wrong color, incorrect specification, quantity shortage — from multiple angles with clear lighting.
Keep all packaging
Do not discard boxes, bags, labels, or any packaging materials. These may contain batch numbers, production dates, or other information relevant to a dispute.
Count the units
Verify the quantity against the invoice and packing list. Document any shortage.
Compare against your specifications
Check the goods against your written order confirmation, purchase order, or specification sheet. Note every discrepancy, no matter how small.
Do not use, alter, return, or discard the goods before documenting
Using or altering the goods before documentation weakens your position significantly. Even if the product is clearly defective, preserve the evidence first.
Do not confirm receipt, release payment, or leave a review until you understand your options
If the platform asks you to confirm receipt, release payment, or leave a review, do not do so until you have documented the issue and understand how the dispute process works. Confirming receipt or releasing payment before a dispute is resolved may affect your options.
Common Supplier Dispute Types
Quality mismatch — Material, finish, or workmanship does not match the approved sample or agreed specification.
Wrong specification — Wrong size, color, model, or variant delivered.
Quantity shortage — Fewer units delivered than invoiced.
Packaging or labeling problem — Wrong packaging, missing labels, or damaged outer packaging.
Late shipment or missed lead time — Goods arrived significantly later than agreed, causing downstream problems.
Supplier stops responding — No reply to messages after the order is placed or goods are shipped.
Build Your Evidence File
Before contacting the supplier, organize the following into one place:
- Photos and videos of the issue
- Screenshots of the original product listing or supplier page — suppliers sometimes change listings after a dispute, so save these early
- Order confirmation or purchase order
- Commercial invoice and packing list
- Payment records
- Chat history and message records from the platform
- Written product specifications or sample approval records
- Pre-shipment inspection report, if you arranged one
The strength of your position in any dispute — with the supplier, the platform, or a payment provider — depends entirely on what you can document. A clear evidence file makes the difference between a supplier taking your complaint seriously and dismissing it.
First Message to the Supplier
Once you have your evidence organized, contact the supplier with a factual, specific issue report. Do not lead with anger or demands. Lead with facts.
Hello [Supplier Name],
We received the order for [product name / order reference] on [date].
After checking the goods against our agreed specifications, we found the following issues:
1. [Issue 1] — see attached photo/video
2. [Issue 2] — see attached photo/video
3. [Issue 3] — see attached photo/video
The agreed specification was:
[quote the relevant specification, order confirmation line, or sample approval detail]
The goods received:
[describe what was actually received, factually]
Please confirm how you can help resolve this. We would like to discuss one of the following options:
- Replacement units
- Partial refund
- Credit toward the next order
- Remake or correction before the next shipment
Please reply by [date — allow 3–5 business days] so we can resolve this promptly.
Thank you.
Why this works: Factual, specific, and gives the supplier clear options to respond to. It does not make threats or accusations. It documents the issue in writing on the platform.
What Resolution Should You Ask For?
Knowing what outcome to request makes the conversation more productive. Different situations call for different remedies.
Replacement units — Appropriate when the entire batch is defective or wrong, and the supplier has capacity to remake. Best when time allows and the supplier is cooperative.
Partial refund — Appropriate when some units are acceptable and some are not, or when defects are minor and you can use or sell the goods at a discount. Usually faster to resolve than a full replacement.
Credit toward the next order — Appropriate when you have an ongoing relationship and the supplier is cooperative. Lower friction, easier for both parties.
Discount on this order — Similar to partial refund but applied before final payment if applicable.
Remake or correction before the next shipment — Appropriate for issues that can be fixed, such as incorrect labels, missing components, or adjustable specifications.
Choose your requested remedy based on the severity of the issue, your cash flow situation, and whether you want to continue with this supplier. Asking for one specific solution is more effective than asking the supplier to “fix it” with no direction.
What Platform Protection Can and Cannot Do
Alibaba Trade Assurance
Trade Assurance can support your case when the order, payment, specifications, and communication are documented inside Alibaba’s system. If product quality, quantity, or delivery terms were confirmed on-platform and paid through Trade Assurance, you have grounds to open a dispute through Alibaba.
Trade Assurance is not a guarantee. If key terms were agreed off-platform, the specifications were vague, or the issue is subjective, the process may be more difficult. Use the platform’s messaging system for all key confirmations.
1688
1688 was built for domestic Chinese buyers. Overseas buyers typically order through sourcing agents, and dispute handling may depend on who placed the order, how payment was made, and whether the agent can assist with platform communication. If you ordered through an agent, contact them first — they are usually better positioned to communicate with the supplier and navigate the platform’s process.
General principle: Platform protection works best when everything is documented in the platform’s system. A platform dispute is easier when the issue is objective, measurable, and tied to written terms. Off-platform agreements, verbal prices, and external payment methods reduce your options significantly.
When and How to Escalate
If the supplier does not respond within a reasonable time — typically 3–5 business days — or refuses to address a clearly documented issue, escalation is appropriate.
Step 1: Follow up in writing
Send a short, direct follow-up referencing your previous message and the deadline you set.
Step 2: Send a final written notice
Before opening a formal dispute, send one final written notice summarizing the issue, the evidence, the remedy requested, and the deadline for response. This creates a clear record that you gave the supplier a fair opportunity to resolve the matter.
Step 3: Open a platform dispute
If you paid through Alibaba Trade Assurance or a similar protected platform, open a formal dispute. Attach your evidence file. Follow the platform’s process and deadlines carefully.
Step 4: Payment-provider dispute
If you paid through PayPal, credit card, or another protected payment method, you may have a dispute or chargeback option. Treat this as an escalation step, not a first reaction. Review the payment provider’s rules, deadlines, and evidence requirements before opening a claim.
Keep your evidence organized and responses documented at every stage. Escalation processes rely on what you can show.
When to Stop Chasing a Dispute
Not every dispute is worth pursuing to the end. Sometimes the best business decision is to document the loss, learn from it, and improve your process for the next order.
Consider stopping when:
- The disputed amount is small compared with the time and energy required to pursue it
- You have no written specifications, order confirmation, or platform payment record
- Payment was made off-platform with no protection mechanism
- The supplier has stopped responding and no platform protection applies
- Your evidence is weak or incomplete
- Continuing the dispute is delaying your next sourcing decision or order
This is not failure. It is a business decision. Document what happened, identify what you would do differently, and apply those lessons to the next order.
How to Prevent the Same Problem Next Time
Most supplier disputes are preventable. The investment in prevention is almost always smaller than the cost of a dispute.
Approve a sample before bulk production — A physical sample checked against your specifications catches most quality issues before they reach bulk scale.
Confirm specifications in writing — Every key detail — material, size, color, packaging, labeling — should be confirmed in a written order confirmation before production begins. Do not rely only on casual chat assurances such as “quality is good” or “same as sample.” Write the measurable details into the order confirmation.
Use a purchase order that references the approved sample — Include language such as “bulk production must match the approved sample dated [date].”
Arrange a pre-shipment inspection for larger orders — A third-party inspection before goods leave China catches problems before they become a customs and freight problem.
Control payment timing — Where possible, structure payment so that a portion is held until goods are confirmed acceptable. Paying 100% upfront removes most of your leverage.
Vet the supplier before ordering — Many dispute situations could have been avoided by identifying risk signals before the first payment.
→ How to Order Product Samples from China
Common Mistakes
Sending an angry first message
Emotion reduces leverage. A calm, documented issue report is more effective than a frustrated demand.
Saying “quality is bad” without explaining the specific problem
Specify exactly what is wrong, compared against what was agreed. Vague complaints give the supplier nothing to work with.
Not comparing the problem against written specifications
Without a written baseline, the supplier can claim the goods match what was discussed. Written specifications are your evidence.
Discarding packaging or damaged units too early
These are part of your evidence. Keep them until the dispute is fully resolved.
Demanding a full refund when a partial remedy is more realistic
A reasonable remedy request is more likely to be accepted. Start with what is proportionate to the issue.
Escalating before giving the supplier a chance to respond
Give the supplier a reasonable window — 3–5 business days — before escalating.
Continuing to place orders with the same supplier after a serious unresolved issue
If a supplier did not resolve a documented problem, that pattern is unlikely to change.
Supplier Dispute Checklist
- ☐ I photographed and recorded the issue before using, returning, or discarding the goods
- ☐ I kept packaging, labels, and damaged units
- ☐ I saved screenshots of the original product listing or supplier page
- ☐ I counted units and documented any shortage
- ☐ I compared the problem against written specifications or sample approval records
- ☐ I saved order confirmation, invoice, payment record, and chat history
- ☐ I wrote a factual issue report with photos or videos attached
- ☐ I requested a specific remedy, not just “please solve this”
- ☐ I gave the supplier a reasonable deadline to respond
- ☐ I did not confirm receipt or release payment before documenting the issue
- ☐ If needed, I reviewed platform or payment-provider dispute options
- ☐ I identified what I will change before placing my next order
Your Next Step
Most supplier disputes are easier to prevent than to fix.
Before your next order, use the free Supplier Verification Checklist to screen suppliers before payment.
Want to reduce dispute risk before goods leave China?
→ How to Order Product Samples from China →
Educational content only. Platform protection features, payment dispute processes, and supplier practices vary and change. Always verify current platform rules and payment-provider dispute processes before opening any claim.