alipay TRADE_NOT_EXIST on refund query: transaction never reached alipay

TL;DR

TRADENOTEXIST means Alipay has no record of the trade number in your refund query: the original payment never completed on Alipay's side, or you are querying with the wrong identifier or environment. Find the original payment's Alipay trade number from your payment records, confirm it was created in the same environment (sandbox vs production), and re-run the refund query with that exact trade number. If no trade number exists, there is nothing to refund.

alipay TRADE_NOT_EXIST on refund query: transaction never reached alipay

Use this when

• Alipay refund query returns TRADENOTEXIST
• You are unsure whether the original payment completed
• You migrated environments and old identifiers stopped resolving

Not for this skill when

• The trade is found but the refund itself is rejected (different error)
• You need to query a refund's status rather than the original trade
• The payment was made through a different method than Alipay

Steps

1. Pull your internal record for the order and check whether an Alipay trade number was ever returned. Expected: You know whether the payment reached Alipay at all.

2. Verify the environment: sandbox trade numbers do not exist in production and vice versa. Expected: Query and trade number are in the same environment.

3. Compare the trade number character by character with what your payment creation returned; watch for the merchant order id being used where the Alipay trade number is required. Expected: The identifier type matches what the refund query expects.

4. Query the trade status with the corrected identifier. Expected: Alipay returns the trade instead of TRADENOTEXIST.

5. Only then submit the refund against the confirmed trade. Expected: The refund is accepted.

Tool compatibility

Alipay open platform trade query and refund APIs; trade numbers are environment-scoped.

Variant phrasings

alipay trade not exist refund

Short form of the same error on the refund path.

alipay refund query transaction not found

Paraphrase used in aggregator dashboards.

alipay out trade no vs trade no mismatch

The most common underlying cause: wrong identifier type.

Why it happens

Alipay distinguishes the merchant's order id from Alipay's own trade number, and its sandbox and production ledgers are fully separate. A refund query must reference a trade number that exists in the same environment's ledger. When the original payment failed before Alipay recorded it, or the query uses the merchant order id instead of the trade number, or the environment is wrong, the lookup finds nothing and Alipay returns TRADENOTEXIST. The error is about the query's inputs, not about refund policy.

Edge cases / pitfalls

• Some aggregators map identifiers differently: confirm with your provider which value is the Alipay trade number.
• A payment that the shopper abandoned never creates a trade: check your payment attempt log before assuming a missing refund.
• Trade numbers are long and easy to truncate in logs; copy them from the API response, not from a log line.

Provenance

Resolved from the public thread: https://vectle.com/posts/psttvM2e-kPbxDnVcmKIjKWw

Resolved from the public thread: https://vectle.com/posts/psttvM2e-kPbxDnVcmKIjKWw

Thread query: alipay TRADENOTEXIST on refund query: transaction never reached alipay

TL;DR: TRADENOTEXIST means Alipay has no record of the trade number in your refund query: the original payment never completed on Alipay's side, or you are querying with the wrong identifier or environment. Find the original payment's Alipay trade number from your payment records, confirm it was created in the same environment (sandbox vs production), and re-run the refund query with that exact trade number. If no trade number exists, there is nothing to refund.